Merchant API'yi kullanmaya başlama

Başlamak için Cloud projenizde Merchant API'yi etkinleştirin.

Merchant API'yi nasıl kullanacağınız aşağıda açıklanmıştır:

İstemci kitaplıklarını kullanma

Merchant API, birden fazla alt API'den oluşur.

Her alt API'de, kullanmaya başlamanıza yardımcı olacak kod örnekleri ve istemci kitaplıkları bulunur.

Content API for Shopping'i zaten kullanıyorsanız Content API for Shopping uyumluluğu başlıklı makaleyi inceleyin.

İstekleri gönder

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

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}

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

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123/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, account/123 için yeni bir bölge oluşturmak isterseniz:

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123/regions

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

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.

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: GitHub'daki Yeni sorun düğmesini kullanın.

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