Merchant API'ye genel bakış

Bu sayfada Merchant API'ye giriş yapılmakta ve Merchant Center'da hesapları, ürünleri ve envanterleri yönetmeyle ilgili çeşitli iş akışlarını otomatikleştirmek için bu API'yi nasıl kullanabileceğiniz açıklanmaktadır.

Daha fazla müşteriye ulaşmak ve ürünlerinizi Google'da sergilemek için Merchant API'yi kullanabilirsiniz. Büyük veya karmaşık Merchant Center hesaplarını yönetmek için Merchant API'yi kullanabilirsiniz. Tipik kullanım alanlarından bazıları şunlardır:

  • Otomatik hesap yönetimi
  • Otomatik ürün yönetimi
  • Otomatik envanter yönetimi
  • Özel raporlama

Merchant API, birden fazla veri kaynağı oluşturmanıza ve yönetmenize olanak tanıyarak ürünler, promosyonlar ve yorumlarla ilgili bilgilerin daha iyi düzenlenmesini sağlar. Merchant API ile ürünleri, dosya ve otomatik feed gibi diğer ürün verisi yükleme yöntemlerini tamamlayacak şekilde yönetebilirsiniz.

Merchant API, Content API for Shopping'in yeniden tasarlanmış halidir ve birden fazla alt API'den oluşur.

Perakendeciler, Alışveriş reklamları ve ücretsiz listelemeler politikalarına uymaktan sorumludur. Google Alışveriş, bu politikaları uygulama ve bu politikaları ihlal eden içerik veya davranış tespit edersek uygun şekilde yanıt verme hakkını saklı tutar.

Merchant API'deki yenilikler

Merchant API'ye geçmenin bazı avantajları şunlardır:

Daha fazla bilgi için Merchant API Beta sürümünde kullanıma sunulan yeni özellikler başlıklı makaleyi inceleyin.

Başlamadan önce

Merchant API isteği çalıştırmak için aşağıdakilere sahip olmanız gerekir:

  • Merchant Center hesabı: Verileri sorgulayacağınız, güncelleyeceğiniz ve yükleyeceğiniz hesaptır. Bu hesaptaki ürünleri ve envanterleri yönetmek için gerekli izinlere sahip olduğunuzdan emin olun.

  • Google Cloud projesi: Proje, hesabınıza API erişimi elde etmek için kullanılır.

Merchant API ile kimlik doğrulama

Kimlik doğrulama için aşağıdaki seçenekleri kullanabilirsiniz:

  • Uygulamanız için bir OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturabilirsiniz. Bu kimlik ve gizli anahtar, Merchant Center hesabına yapılan API çağrılarında ihtiyaç duyulan OAuth 2.0 kimlik bilgilerini oluşturmak için kullanılabilir.
  • API çağrıları yapmak için bir hizmet hesabı oluşturabilir ve özel anahtarını indirebilirsiniz.

Hesap ve ürün tanımlayıcıları

Merchant API, tanımlama için kimlikler yerine kaynak adlarını kullanır. Bir ürün için örnek bir kaynak adı accounts/123456/products/online~en~US~sku123 olabilir. Burada 123456, hesabın benzersiz tanımlayıcısı, online~en~US~sku123 ise ürünün benzersiz tanımlayıcısıdır.

İstek URL'si biçimi

Bir kaynak üzerinde işlem yapmak için aşağıdaki biçimde URL'lere istek gönderin:

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

list ve get gibi standart yöntemler için :{METHOD} kısmı atlanır.

Örneğin, aşağıdaki istek bölgesel envanteri siler:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123456/products/online~en~US~sku123/regionalInventories/456

Yeni bir kaynak oluşturmak için üst kaynağın kaynak adını ve aşağıdaki URL'yi kullanabilirsiniz:

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

Örneğin, aşağıdaki istekte accounts/123456 için nasıl yeni bir bölge oluşturabileceğiniz gösterilmektedir:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

Belirli hizmetler hakkında daha fazla bilgi için Satıcı API'si referans dokümanlarına bakın.

Merchant API'yi kullanmaya başlama

Merchant API'nin nasıl çalıştığını hızlıca görmek ve örnek bir ürün yüklemeyi denemek için Merchant API'yi kullanmaya başlama başlıklı makaleyi inceleyin.

gRPC veya REST'i kullanma

Merchant API, gRPC ve REST'i destekler. Merchant API çağrısı yapmanın iki yolu vardır:

gRPC (önerilen) REST
  1. İsteğin gövdesini protokol arabelleği olarak oluşturun.
  2. İstek gövdesini HTTP/2 ile sunucuya gönderin.
  3. Yanıtı bir protokol arabelleğine seri hale getirin.
  4. Sonuçları yorumlama.
  1. İsteğin gövdesini JSON nesnesi olarak oluşturun.
  2. HTTP 1.1 kullanarak sunucuya gönderin.
  3. Yanıtı JSON nesnesi olarak dize dışına çıkarın.
  4. Sonuçları yorumlama.

İstemci kitaplıklarını ve kod örneklerini kullanma

Her alt API'nin, başlangıçta size yardımcı olacak istemci kitaplıkları vardır. Kod örnekleri, Java, PHP ve Python'da kod yazmaya başlamanıza yardımcı olabilir. Daha fazla bilgi için Merchant API örnekleri başlıklı makaleyi inceleyin.

Yardım alın

Destek alma hakkında bilgi edinmek için Merchant API ile ilgili yardım alma başlıklı makaleyi inceleyin.

Geri bildirimde bulunma

Beta dönemi, genel kullanıma sunulmadan önce geri bildirimlerinizi toplayıp ele almamıza olanak tanır. Geri bildirim göndermek için aşağıdakilerden birini gönderin:

  • API özellikleri: Geri bildirim formunu gönderin.
  • Dokümanlar: Sayfadaki küçük resim puanlarını ve Geri bildirim gönder düğmesini kullanın.
  • Örnekler ve kitaplıklar: Kod örneklerinin GitHub deposunda sorun oluşturun.

Her görevi uyguladıktan sonra genel geri bildirimde bulunmak için geri bildirim formunu kullanın.

Sırada ne var?

  • Geriye dönük uyumluluk hakkında bilgi edinmek için Content API for Shopping uyumluluğu başlıklı makaleyi inceleyin.

  • Merchant API'nin temel özellikleri hakkında daha fazla bilgi edinmek için sol gezinme menüsündeki kılavuzlara bakın.

  • Kullanılabilir kaynaklar ve hizmetler hakkında bilgi edinmek için Referans dokümanlarına göz atın.

Sonraki
Tasarım