Merchant API'ye genel bakış

Merchant API'yi kullanarak şunları yapabilirsiniz:

  • İşletmenizin ve ürünlerinizin Google'da nasıl görüneceğini yönetin.
  • Verilere, analizlere ve benzersiz özelliklere programatik olarak erişin.
  • İşletmenizi büyütün ve Google'da daha fazla müşteriye ulaşın.

Merchant API, büyük veya karmaşık Merchant Center hesaplarını yönetebilir. Tipik kullanım alanları şunlardır:

  • Otomatik hesap yönetimi
  • Otomatik ürün yönetimi
  • Otomatik envanter yönetimi
  • Performans ve pazar analizleriyle ilgili otomatik rapor yönetimi

Merchant API, birden fazla veri kaynağı oluşturup yönetmenize olanak tanır. Bu sayede ürünler, promosyonlar ve yorumlarla ilgili bilgileri daha iyi düzenleyebilirsiniz. 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 bağımsız isteği paralel olarak çalıştırmanıza da olanak tanır.

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

Merchant API'deki yenilikler

Merchant API'ye yükseltme yapmanın bazı nedenleri:

Başlamadan önce

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

  • Merchant Center hesabı: Bu hesap, veri sorgulama, güncelleme ve yükleme işlemlerini yapacağınız hesaptır. Bu hesapta ürünleri ve envanterleri yönetmek için gerekli izinlere sahip olduğunuzdan emin olun.

  • Google Cloud projesi: Hesabınıza API erişimi kazanmak için projeyi kullanın.

  • Merchant Center hesabınızdan Google Cloud projesine giden bir bağlantı. Geliştirici kaydı yöntemini çağırarak bağlantıyı oluşturun. Bu hesabı ve kullanıcıları API entegrasyonu, anketler ve fırsatlarla ilgili iletişim için kullanacaksınız.

  • Geliştirici olarak kaydolarak Merchant Center hesabınızı Google Cloud projesine bağlayın. API geliştirici rolüne sahip kullanıcılar, zorunlu hizmet duyuruları, geliştirici anketleri ve fırsatlar dahil olmak üzere API iletişimlerini alır.

Merchant API ile kimlik doğrulama

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

  • Uygulamanız için OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturabilirsiniz. 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 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 kaynak adı örneği accounts/123456/products/en~US~sku123 olabilir. Burada 123456, hesabın benzersiz tanımlayıcısı, 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}

:{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/v1/accounts/123456/products/online~en~US~sku123/regionalInventories/456

Bir kaynak oluşturmak için üst kaynağın kaynak adını ve şu URL'yi kullanın:

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/v1/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 Merchant API referans belgelerine 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 kullanma

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

gRPC (önerilir) 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ı protokol arabelleğine seri durumdan çıkarma.
  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 seri durumdan çıkarma.
  4. Sonuçları yorumlama.

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

Her bir alt API'nin istemci kitaplıkları vardır. Bu kitaplıklar, kullanmaya başlamanıza yardımcı olur. 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 bildirim gönder

Geri bildirimde bulunmak için aşağıdakilerden birini gönderin:

  • API özellikleri: Geri bildirim formunun Sorun/Soru Nedir? bölümünde Geri Bildirim Gönder seçeneğini belirleyin.
  • Dokümanlar: Sayfa içi beğenme/beğenmeme puanlarını ve Geri bildirim gönder düğmesini kullanın.
  • Örnekler ve kitaplıklar: Kod örnekleriyle ilgili GitHub deposunda sorun oluşturun.

Sırada ne var?

  • Geriye dönük uyumluluk hakkında bilgi edinmek için Content API for Shopping uyumluluğu konusuna bakın.

  • 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 için Referans belgeleri'ne bakın.

Önceki
Latest updates
Sonraki
Design