Hesap durumlarını toplu ürün durumlarına taşıma

Toplu ürün istatistiklerini ve sorunları alma yönteminiz değişti. Content API for Shopping'deki accountstatuses kaynağında daha önce kullanılabilen işlevler, Merchant API'deki özel kaynaklara ayrıldı. Bu kılavuzda, entegrasyonunuzu yeni aggregateProductStatuses kaynağını kullanacak şekilde nasıl taşıyacağınız açıklanmaktadır.

Temel farklar

Content API for Shopping ve Merchant API'deki ürün durumu özellikleri arasındaki temel farklar şunlardır:

  • Özel kaynaklar: Content API for Shopping'deki accountstatuses kaynağı artık bölünmüştür. Merchant API'de hesap düzeyindeki sorunlar accountissues kaynağı üzerinden, toplu ürün istatistikleri ve öğe düzeyindeki sorunlar ise yeni aggregateProductStatuses kaynağı üzerinden kullanılabilir.
  • Yeni kaynak yapısı: AggregateProductStatus, belirli bir raporlama bağlamı ve ülke kombinasyonuna ait istatistikleri ve sorunları temsil eden yeni bir kaynaktır.
  • Filtreleme mekanizması: Merchant API, veri seçmek için destinations gibi sorgu parametreleri kullanmak yerine belirli raporlama bağlamlarını ve ülkeleri sorgulamak için filter dizesi içeren bir list yöntemi kullanır.
  • Kanal alanı kaldırma: channel alanı artık kullanılmıyor. Bu bilgiler artık dolaylı olarak reportingContext kapsamındadır.

İstekler

Merchant API, toplu ürün durumlarını almak için filter parametresiyle birlikte bir GET isteği kullanır. Filtre söz dizimi hakkında daha ayrıntılı bilgi için Filtre söz dizimi başlıklı makaleyi inceleyin.

GET https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses

İstek URL'si biçimi

İstek açıklaması Content API for Shopping Merchant API
Ürün istatistiklerini ve sorunlarını alma GET /content/v2.1/{merchantId}/accountstatuses/{accountId} GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses

Tanımlayıcılar

Kaynakların tanımlanma şekli, yeni yapıyı destekleyecek şekilde değiştirildi.

Tanımlayıcı biçimi

Tanımlayıcı açıklaması Content API for Shopping Merchant API
Kaynak Tanımlayıcısı Kaynak, accountId tarafından tanımlandı. Sorgu parametreleriyle belirli veri dilimleri seçildi. Kaynak adı, belirli bir raporlama bağlamı ve ülke için verileri benzersiz şekilde tanımlar: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}.

Yöntemler

Ürün durumlarını alma yöntemi, filtrelemeyi destekleyen bir list yöntemiyle güncellendi.

Content API for Shopping yöntemi Merchant API yöntemi Kullanılabilirlik ve notlar
accountstatuses.get aggregateProductStatuses.list accountstatuses.get yöntemi, tüm ürün istatistiklerini içeren tek bir kaynak döndürdü. Yeni aggregateProductStatuses.list yöntemi, her raporlama bağlamı ve ülke kombinasyonu için bir tane olmak üzere kaynakların listesini döndürür. Belirli verileri almak için filter parametresini kullanın. Hesap düzeyindeki sorunlar için accountissues.list kullanın.

Ayrıntılı alan değişiklikleri

Ürün istatistikleri ve sorunlarıyla ilgili alanlar, yeni AggregateProductStatus kaynağında güncellenip yeniden yapılandırıldı.

Content API for Shopping Merchant API Açıklama
products aggregate_product_statuses Liste yanıtında products dizisinin yerini aggregate_product_statuses yinelenen alanı alır.
destination reporting_context destination alanı, istatistiklerin program bağlamını belirten reporting_context ile değiştirildi.
channel (eşdeğer alan yok) channel alanı kaldırıldı. Bu bilgiler artık reporting_context kapsamındadır.
statistics stats statistics nesnesi stats olarak yeniden adlandırıldı. İçindeki alan adları snake_case'e dönüştürülür. Örneğin, activeCount artık active_count olur.
itemLevelIssues.servability item_level_issues.severity Bir sorunun etkisini açıklamak için servability enum'u, severity enum'u ile değiştirildi.
itemLevelIssues.attributeName item_level_issues.attribute attributeName alanı attribute olarak yeniden adlandırıldı.
itemLevelIssues.documentation item_level_issues.documentation_uri documentation alanı documentation_uri olarak yeniden adlandırıldı.
itemLevelIssues.numItems item_level_issues.product_count numItems alanı product_count olarak yeniden adlandırıldı.
Önceki
Migrate accountstatuses to Account Issues
Sonraki
Migrate user and access management