Önemli: Content API for Shopping, 18 Ağustos 2026'da kullanımdan kaldırıldı.

1 Eylül 2026'dan itibaren Content API for Shopping isteklerinde kademeli olarak hatalar yaşanacak. Content API desteğinin sonlandırılmasıyla ilgili kılavuzu inceleyin.

Merchant API'ye geçiş yapmak için ek süreye ihtiyacınız varsa Content API for Shopping'e erişiminizi uzatmak için başvurun.

Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Doğrudan API çağrıları

Merchant API ile etkileşim kurmaya yönelik bu yaklaşımda, genellikle HTTP(S) üzerinden doğrudan API uç noktalarına ham istekler gönderilir. İstek gövdesini oluşturma, üstbilgileri ayarlama (kimlik doğrulama dahil) ve yanıtı ayrıştırma gibi işlemleri manuel olarak yaparsınız.

1. Adım: Geliştirici olarak kayıt ol

Merchant API'yi kullanmak için geliştirici iletişim bilgilerinizi kaydetmeniz gerekir.

Kayıt işlemi şunları sağlar:

Bir kullanıcıya API developer rolünü atayarak Merchant Center hesabınız için teknik iletişim kişisi oluşturur. Bu sayede Google, özellikle API ve geliştiricinin kullandığı özelliklerle ilgili önemli güncellemeleri (ör. hizmet duyuruları ve yeni özelliklerle ilgili bilgiler) gönderebilir. Bu güncellemeler, geliştirici olmayanların ilgisini daha az çekebilir.
Birden fazla kez kaydolmanıza gerek kalmadan birden fazla satıcı hesabıyla çalışmanıza olanak tanır. Kayıt yaptırdığınızda, Merchant API'de kimlik doğrulaması için kullanılan Google Cloud proje kimliği, teknik iletişim kişilerinin (API developer) bulunduğu Merchant Center hesabınızla ilişkilendirilir. Bu sayede, kimlik doğrulama işlemi kayıtlı Google Cloud projesiyle yapıldığı sürece yönettiğiniz tüm satıcı hesapları için önemli güncellemeleri alabilirsiniz.

Kayıt sırasında, Kayıt bölümünde ayrıntılı olarak açıklanan ön koşullara ve kısıtlamalara uyun.

developerRegistration.registerGcp yöntemini kullanarak kaydolmak için bu örnekle başlayabilir ve istek gövdesindeki {DEVELOPER_EMAIL} değerini uygun e-posta adresiyle değiştirebilirsiniz.

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"
  ]
}

2. adım: Geliştirici iletişim bilgilerini ve izinlerini yönetme

Kaydolduğunuzda:

E-posta adresi 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üne sahip yeni bir kullanıcı olarak eklenmek için daveti kabul etmesi gerekir.

İlk kayıttan sonra birden fazla geliştirici eklemenizi ve onlara ek erişim hakları vermenizi öneririz.

2a. adım Ek izinler verme

Önemli bildirimleri almak için API_DEVELOPER rolü gereklidir ancak bu rolün Merchant Center'da minimum düzeyde izni vardır. Bu kullanıcının diğer API çağrılarını 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.

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

Aşağıdaki örnekte, bir kullanıcıya hem ADMIN hem de API_DEVELOPER rollerini vermek için kullanıcının nasıl güncelleneceği gösterilmektedir. Bu sayede hesabı tam olarak yönetebilir ve API ile ilgili iletişimleri de alabilirler.

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

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

2b adımı. Yedek geliştirici ekleme

Birincil geliştirici sorumlunuz kuruluşunuzdan ayrılırsa API erişiminizin kesintiye uğramaması için en az bir yedek geliştirici eklemeniz gerekir.

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

3. adım: 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 istekte, hesabınıza ürün eklemek için kullanabileceğiniz bir veri kaynağının nasıl oluşturulacağı gösterilmektedir:

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

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

{ACCOUNT_ID} yerine, oluşturduğunuz Merchant Center hesabının kimliğini girin.

Bu isteği başarıyla çalıştırdıktan sonra aşağıdaki yanıtı görürsünüz:

{
  "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.

4. adım: Ürün ekle

Veri kaynağını oluşturduktan sonra kaynağa bir ürün eklemeyi deneyin. Doğru ACCOUNT_ID değerini girerek aşağıdaki komutu çalıştırın. {DATASOURCE_NAME} değerini daha önce kopyaladığınız değerle değiştirin.

POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME}
{
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "productAttributes": {
    "gender": "MALE",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}