Merchant API'ye genel bakış

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

Merchant API'yi kullanarak daha fazla müşteriye ulaşabilir ve ürünlerinizi Google genelinde sergileyebilirsiniz. Merchant API'yi büyük veya karmaşık Merchant Center hesaplarını yönetmek için 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şturup yönetmenize olanak tanıyarak ürünler, promosyonlar ve yorumlarla ilgili bilgilerin daha iyi organize edilmesini sağlar. Merchant API ile ürünleri, dosyalar ve otomatik feed gibi diğer ürün verisi yükleme yöntemlerini tamamlayacak şekilde yönetebilirsiniz. Merchant API, birden fazla isteği paralel olarak çalıştırmanıza da olanak tanır.

Merchant API, Content API for Shopping'in yeniden tasarımı olup birden fazla alt API'den oluşur.

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

Merchant API'deki yenilikler

Satıcı API'sine geçmek için bazı nedenleri aşağıda bulabilirsiniz:

Daha fazla bilgi için Merchant API Beta'da kullanıma sunulan yeni özellikler bölümüne bakın.

Başlamadan önce

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

  • Merchant Center hesabı: Bu, sorgulayacağınız, güncelleyeceğiniz ve veri 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. Ardından, kimlik ve gizli anahtar, Merchant Center hesabına yapılan API çağrılarında gereken 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ün örnek 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 çalışmak için istekleri aşağıdaki biçimde URL'lere gönderin:

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

:{METHOD} bölümü, listeleme ve alma gibi standart yöntemler için 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

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 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 hizmetlerle ilgili daha fazla bilgi için Merchant API referans belgelerini inceleyin.

Merchant API'yi kullanmaya başlayın

Merchant API'nin işleyiş şeklini hızlı bir şekilde görmek ve örnek bir ürün yüklemeyi denemek için Merchant API'yi kullanmaya başlama bölümüne bakın.

gRPC veya REST kullanma

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

gRPC (önerilen) REST
  1. İsteğin gövdesini protokol arabelleği olarak oluşturun.
  2. İsteğin gövdesini HTTP/2 ile sunucuya gönderin.
  3. Protokol arabelleğine verilen yanıtı seri durumdan çıkarın.
  4. Sonuçları yorumlama.
  1. İsteğin gövdesini bir JSON nesnesi olarak oluşturun.
  2. HTTP 1.1 kullanarak sunucuya gönderin.
  3. Yanıtın serisini JSON nesnesi olarak devre dışı bırakın.
  4. Sonuçları yorumlama.

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

Her alt API'nin başlamanıza 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 Satıcı API'si için örnekler bölümüne bakın.

Yardım alın

Destek kaynakları için Merchant API ile ilgili yardım alma bölümüne bakın.

Geri bildirim gönder

Beta döneminde, genel kullanıma sunulmadan önce geri bildirimlerinizi toplayıp ele alabiliriz. Geri bildirimde bulunmak için aşağıdakilerden birini gönderin:

  • API özellikleri: Geri bildirim formunu gönderin
  • Dokümanlar: Sayfa içi başparmak derecelendirmelerini ve Geri bildirim gönder düğmesini kullanın.
  • Örnekler ve kitaplıklar: Kod örnekleri için GitHub deposunda bir sorun oluşturun.

Her bir görevi uyguladıktan sonra genel geri bildirim sağlamak 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'na bakın.

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

  • Mevcut kaynak ve hizmetler hakkında bilgi edinmek için Referans belgelerine göz atın.

Önceki
Latest updates
Sonraki
Design