Merchant API'yi mevcut Content API for Shopping uygulamanızla entegre etmek için bu kılavuzu kullanabilirsiniz.
Başlayın
Merchant API ve alt API'leri ile ilgili ayrıntılar için Merchant API tasarımı bölümüne bakın.
Merchant API'yi kullanmaya başlamak için istek URL'lerinizi aşağıdaki biçimde değiştirin:
https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…
Daha fazla bilgi için hızlı başlangıç kılavuzuna ve Merchant API referansına bakın.
gRPC desteği
Merchant API, gRPC ve REST'i destekler. Merchant API için gRPC'yi ve Content API for Shopping için REST'i aynı anda kullanabilirsiniz.
Merchant API istemci kitaplıkları için gRPC gerekir.
Daha fazla bilgi için gRPC'yi kullanma bölümüne bakın.
Uyumluluk
Bu kılavuzda, Merchant API'nin tamamı için geçerli olan genel değişiklikler açıklanmaktadır. Belirli özelliklerde yapılan değişiklikler için aşağıdaki kılavuzlara bakın:
- Hesap yönetimini taşıma
- Kargo ayarlarını taşıma
- Ürün yönetimini taşıma
- Veri kaynağı yönetimini taşıma
- Envanter yönetimini taşıma
- Promosyon yönetimini taşıma
- Raporlama yönetimini taşıma
- Dönüşüm kaynağı yönetimini taşıma
- Yerel feed'ler iş ortaklığı yönetimini taşıma
Merchant API, mevcut Content API for Shopping 2.1 sürümü özellikleriyle birlikte çalışacak şekilde tasarlanmıştır.
Örneğin, Merchant Inventories API'yi mevcut Content API for Shopping v2.1 envanterleriniz ve products
uygulamanızla birlikte kullanabilirsiniz. Content API for Shopping'i yeni bir yerel ürünü yüklemek (yerel mağazada sattığınız bir ürün) ve ardından ilgili ürünün mağaza içi bilgilerini yönetmek için Merchant Inventories API LocalInventory
kaynağını kullanabilirsiniz.
Toplu istekler
Merchant API, Content API for Shopping'de sunulan customBatch
yöntemini desteklemez. Bunun yerine Toplu istekler gönderme bölümüne bakın. customBatch
kullanıyorsanız ve Merchant API için bu özelliğe ihtiyacınız varsa geri bildiriminizde nedenini bize bildirin.
Tanımlayıcılar
Google'ın API iyileştirme ilkelerine uymak için Merchant API kaynaklarının tanımlayıcılarında bazı değişiklikler yaptık.
ad yerine kimlik geçer
Tüm Merchant API kaynakları benzersiz tanımlayıcı olarak name
alanını kullanır.
Aşağıda, çağrılarınızda name
alanının nasıl kullanılacağına dair bir örnek verilmiştir:
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert
Bu yeni name
alanı, Merchant API'deki tüm okuma ve yazma çağrıları için kaynak tanımlayıcısı olarak döndürülür.
name
alanlarında döndürülen değer yeni kimlik biçimini kullanır.
Örneğin, name
öğesini bir kaynaktan almak için getName()
yöntemi uygulayın ve name
değerini satıcı ve kaynak kimliklerinden kendiniz oluşturmak yerine çıkışı değişken olarak depolayın.
Yeni kimlik biçimi
Merchant API'de kaynak kimlikleri aşağıdaki biçimi kullanır:
channel~language~feedLabel~offerId
Content API kaynakları, kimlikteki her bir değer arasında ~
yerine :
kullanıldı:
channel:language:feedLabel:offerId
Tüm Merchant API çağrıları, kimlik değerleri arasında ~
ile yeni biçimi döndürür. Yanıttaki yeni biçimi depolamanızı ve gelecekteki görüşmelerinizde kullanmanızı öneririz.
alt kaynaklar için üst alanlar
Merchant API'de tüm alt kaynaklarda parent
alanı bulunur. Üst kaynağın tamamını aktarmak yerine, alt öğenin ekleneceği kaynağın name
değerini belirtmek için parent
alanını kullanabilirsiniz. Söz konusu parent
öğesinin alt kaynaklarını listelemek için parent
alanını list
yöntemleriyle birlikte de kullanabilirsiniz.
Örneğin, belirli bir ürünün yerel envanterlerini listelemek için list
yönteminin parent
alanında ürünün name
değerini belirtin. Bu durumda, belirtilen product
, döndürülen LocalInventory
kaynaklarının parent
'ıdır.
Türler
Merchant API alt API'lerinde paylaşılan bazı yaygın türleri burada bulabilirsiniz.
Fiyat
Satıcı Genel paketindeki Price
için yapılan değişiklikler:
Content API | Satıcı API'si | |
---|---|---|
Tutar alanı | value:string |
amountMicros:int64 |
Para birimi alanı | currency:string
|
currencyCode:string |
Price
tutarı artık mikro cinsinden kaydedilmektedir. Burada 1 milyon mikro, para biriminizin standart birimine eşittir.
Content API for Shopping'de Price
, dize biçimindeki ondalık bir sayıydı.
value
olan tutar alanı adı amountMicros
olarak değiştirildi
currency
olan para birimi alanı currencyCode
olarak değiştirildi. Biçim ISO 4217 olarak kalır.