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.