Content API for Shopping uyumluluğu

Merchant API'yi Google Ads ile entegre etmek için Mevcut Content API for Shopping uygulamanız.

Başlayın

Ayrıntılı bilgi için Merchant API tasarımı Merchant API ve alt API'leri.

Merchant API'yi kullanmaya başlamak için istek URL'lerinizi aşağıdaki şekilde değiştirin biçim:

https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…

Hızlı başlangıç kılavuzuna göz atın ve Daha fazla bilgi için Merchant API referansına göz atın.

gRPC desteği

Merchant API, gRPC ve REST'i destekler. Tekliflerinizi otomatikleştirmek ve optimize etmek için Merchant API için gRPC ve Content API for Shopping için REST aynı anda gerekir.

Merchant API istemci kitaplıkları, gRPC.

Daha fazla bilgi için gRPC'yi kullanma konusuna bakın ekleyebilirsiniz.

Uyumluluk

Bu kılavuzda, Merchant API'nin tamamı için geçerli olan genel değişiklikler açıklanmaktadır. Görüntüleyin aşağıdaki kılavuzlara başvurabilirsiniz:

• 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 ile birlikte çalışacak şekilde tasarlanmıştır 2.1 sürümü özellikleri hakkında daha fazla bilgi edinin.

Örneğin, Merchant Inventories API'yi mevcut Content API for Shopping 2.1 sürümü envanterleri ve products uygulanması. Siz yeni bir yerel feed yüklemek için Content API for Shopping'i ürün (sattığınız ürün) yerel mağaza) ve ardından Merchant Inventories API'yi kullanın. LocalInventory o ürünle ilgili mağaza içi bilgileri yönetmek için bir kaynaktır.

Not: Benzer özellikler için tam geriye dönük uyumluluğu garanti edemeyiz: Content API for Shopping ve Merchant API arasındaki etkileşimin yükseltilmesi nedeniyle seçin. Örneğin, alan adları veya yöntem kullanılabilirliği Content API for Shopping'de aynı kaynak ve Satıcı API'si.

Toplu istekler

Merchant API,customBatch Content API for Shopping. Bunun yerine, bkz. Grup gönderme istekleri hakkında daha fazla bilgi edinin. customBatch ve kullanıyorsanız için bu özelliğe ihtiyacınız varsa geri bildirimlerinizi paylaşın.

Tanımlayıcılar

Google'ın API iyileştirme ilkeleri'ne uygun hareket etmek için Merchant API kaynaklarının tanımlayıcılarında bazı değişiklikler yaptı.

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ı, tüm okunan ve çağrılarını Merchant API'de yazma.

name alanlarında döndürülen değer yeni kimlik biçimini kullanır.

Önemli: name alanındaki değeri doğrudan çağrılarına karşılık verebilmek için bir kaynağın adını ayrıştırmak veya sorun.

Örneğin, bir sunucudan name değerini almak için bir getName() yöntemi uygulayın. name oluşturmak yerine, çıktıyı değişken olarak depolayın ve kimlik doğrulamanızı kaldırın.

Yeni kimlik biçimi

Not: Merchant API, Kasım ayına kadar channel değeri olmayan kimlikleri döndürür. 13, 2023. 13 Kasım'dan sonra tüm aramalar, tam kaynak kimliğini döndürür. Siz 1 Şubat'a kadar aramalarınızda channel dahil olmak üzere tam kaynak kimliğini kullanmalıdır. 2024.

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. Yanıttaki yeni biçimi depolamanızı ve telefon edebilir.

alt kaynaklar için üst alanlar

Merchant API'de tüm alt kaynaklarda parent alanı bulunur. Tekliflerinizi otomatikleştirmek ve optimize etmek için alt öğenin ekleneceği kaynağın name değerini belirtmek için parent alanını, üst kaynağın tamamını aktarmak yerine Şunu da kullanabilirsiniz: parent alanına, söz konusu parent öğesinin alt kaynaklarını listelemek için list yöntem ile birlikte sunulur.

Örneğin, belirli bir ürünün yerel envanterlerini listelemek için name parent alanı list yöntemidir. Bu örnekte, verilen product, parent LocalInventory kaynak olduğunu düşünelim.

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 miktarı artık mikro olarak kaydediliyor. 1 milyon mikro para biriminizin standart birimine eşittir.

Content API for Shopping'de Price ondalık bir sayıydı ve dize.

value olan tutar alanı adı amountMicros olarak değiştirildi

currency olan para birimi alanı currencyCode olarak değiştirildi. İlgili içeriği oluşturmak için kullanılan biçimi ISO 4217 olarak kalmaya devam eder.