Bu sayfa, Cloud Translation API ile çevrilmiştir.

Merchant API'yi kullanmaya başlama

Bu sayfada, Merchant API'yi kullanarak nasıl Merchant Center hesabı oluşturabileceğiniz ve örnek ürün yükleyebileceğiniz açıklanmaktadır.

Başlamadan önce

Google Cloud projenizde Merchant API'yi etkinleştirin.

AppScript'te Shopping Content Service'i kullanarak API entegrasyonunu kullanırsanız varsayılan bir Google Cloud projesi oluşturulur ve Merchant API hizmeti otomatik olarak etkinleştirilir. Ancak Merchant API'yi kullanmadan önce tek seferlik geliştirici kaydını tamamlamanız gerekir. Daha fazla bilgi için Apps Komut Dosyası'nda Merchant API Hizmeti'ni Kullanma başlıklı makaleyi inceleyin.

Google Cloud'a gidin.

Hesap oluştur

Merchant API'yi kullanmak için Merchant Center hesabınız olmalıdır. Hesap oluşturmak için Merchant Center'ı kullanmaya başlama başlıklı makaleyi inceleyin.

Merchant Center'a gitme

Geliştirici olarak kayıt ol

Merchant API'yi kullanmak için Google Cloud projeniz ile birincil Merchant Center hesabınız arasında bağlantı oluşturmanız gerekir. Bu tek seferlik kayıt, Merchant API ile kullandığınız her Google Cloud projesi için gereklidir.

Geliştirici olarak kaydolmak iki şeyi sağlar:

Google Cloud projenizi birincil Merchant Center hesabınıza bağlayarak resmi bir bağlantı oluşturur.
Merchant Center hesabınızdaki bir kullanıcıya API_DEVELOPER rolünü atayarak teknik bir kişi oluşturur. Bu sayede Google, hizmet duyuruları ve yeni özelliklerle ilgili bilgiler gibi API hakkında önemli güncellemeler gönderebilir.

Google Cloud projenizi kaydetme

Kaydolmak için developerRegistration.registerGcp yöntemini çağırın. Bu çağrı, çağrıyı yapmak için kullandığınız Google Cloud projesini, istekte belirttiğiniz Merchant Center hesabına bağlar.

İstek gövdesinde, teknik iletişim kişisi olarak kullanılacak bir geliştirici e-posta adresi sağlamanız gerekir. Bu adres, bir Google Hesabı (Google Workspace hesabı veya Gmail hesabı) ile ilişkilendirilmiş olmalıdır. Örneğin: sampleuser@gmail.com.

E-posta adresi zaten Merchant Center hesabındaki bir kullanıcıya aitse bu kullanıcıya API_DEVELOPER rolü verilir.
E-posta adresi mevcut bir kullanıcıya ait değilse bu adrese davetiye gönderilir. Alıcının, API_DEVELOPER rolüyle yeni kullanıcı olarak eklenmek için daveti kabul etmesi gerekir.

İstek örneği:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

Başarılı bir çağrı, projeniz ile hesabınız arasındaki bağlantıyı onaylayan bir DeveloperRegistration kaynağı döndürür.

{
  "name": "accounts/{ACCOUNT_ID}/developerRegistration",
  "gcpIds": [
    "123456789012345"
  ]
}

Geliştirici kişilerini ve izinlerini yönetme

Kaydolduktan sonra birden fazla geliştirici eklemenizi ve onlara ek erişim hakları vermenizi öneririz.

Ek izinler verme

Önemli bildirimleri almak için API_DEVELOPER rolü gereklidir ancak bu rol, Merchant Center'da minimum izinlere sahiptir. Bu kullanıcının başka API çağrıları yapmasına veya Merchant Center kullanıcı arayüzünde ayarları yönetmesine izin vermek için kullanıcıya STANDARD veya ADMIN gibi ek roller vermeniz gerekir. Daha fazla bilgi için Erişim türleri başlıklı makaleyi inceleyin.

Kullanıcının erişim haklarını accounts.users.patch yöntemiyle güncelleyebilirsiniz.

Aşağıdaki örnekte, bir kullanıcıyı hem ADMIN hem de API_DEVELOPER rollerini verecek şekilde nasıl güncelleyeceğiniz gösterilmektedir. Bu sayede, hesabı tam olarak yönetebilirler ve API ile ilgili iletişimleri de alırlar.

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{DEVELOPER_EMAIL}?update_mask=access_rights

{
  "access_rights": [
    "ADMIN",
    "API_DEVELOPER"
  ]
}

Yedek geliştiriciler ekleme

Birincil geliştirici iletişim kişiniz kuruluşunuzdan ayrılırsa API erişiminizin kesintiye uğramasını önlemek için en az bir yedek geliştirici eklemeniz gerekir.

accounts.users.create yöntemiyle kullanıcı ekleyebilir veya accounts.users.patch yöntemiyle mevcut bir kullanıcıyı güncelleyebilirsiniz. Bu kullanıcıya hem ADMIN hem de API_DEVELOPER rollerini vermenizi öneririz.

Birincil ürün veri kaynağı oluşturma

Ürün eklemek için birincil ürün veri kaynağına ihtiyacınız vardır. Aşağıdaki istek, hesabınıza ürün eklemek için kullanabileceğiniz bir veri kaynağının nasıl oluşturulacağını gösterir:

POST https://merchantapi.googleapis.com/datasources/v1/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1

{
  "primaryProductDataSource": {
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "feedLabel": "US"
  },
  "name": "primary-data-source",
  "displayName": "Primary Products Data Source"
}

{ACCOUNT_ID} kısmını, oluşturduğunuz Merchant Center hesabının kimliğiyle değiştirin.

Bu isteği başarıyla çalıştırdıktan sonra aşağıdaki yanıtı görmeniz gerekir:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "Primary Products Data Source",
  "primaryProductDataSource": {
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

name alanının değerini kopyalayın. Ürün eklemek için bu kimliğe ihtiyacınız vardır.

Bu veri kaynağını Merchant Center kullanıcı arayüzünde görüntüleyebilirsiniz. Daha fazla bilgi için Veri kaynakları sekmesini bulma başlıklı makaleyi inceleyin.

Ürün ekle

Hesabınıza örnek bir ürün eklemek için aşağıdaki isteği çalıştırın:

POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1

{
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "attributes": {
    "gender": "Male",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

{DATASOURCE_NAME} yerine daha önce kopyaladığınız değeri girin.