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

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

Not: Merchant API'de hesap düzeyindeki sorunlar ve toplu ürün durumları ayrılır. Ayrıca, accountstatuses'dan hesap sorunlarına geçişle ilgili kılavuzumuzu da inceleyin.

Temel farklılıklar

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üş durumda. 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, bir raporlama bağlamı ve ülkenin belirli bir kombinasyonuna ait istatistikleri ve sorunları temsil eden yeni bir kaynaktır.
• Filtreleme mekanizması: Merchant API, veri seçmek için destinations gibi sorgu parametrelerini 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ırıldı: channel alanı artık kullanılmıyor. Bu bilgiler artık reportingContext'nın bir parçasıdır.

İstekler

Merchant API, toplu ürün durumlarını almak için GET isteğiyle birlikte filter parametresini kullanır.

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 kaynak olmak üzere kaynak listesi döndürür. Belirli verileri almak için filter parametresini kullanın. Hesap düzeyindeki sorunlar için accountissues.list simgesini kullanın.

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

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

Content API for Shopping	Merchant API	Açıklama
products	aggregate_product_statuses	products dizisinin yerini liste yanıtındaki aggregate_product_statuses tekrarlanan alanı alır.
destination	reporting_context	destination alanı, istatistiklerin program bağlamını belirten reporting_context ile değiştirilir.
channel	(eşdeğer alan yok)	channel alanı kaldırılır. Bu bilgiler artık reporting_context'nın bir parçasıdır.
statistics	stats	statistics nesnesi stats olarak yeniden adlandırılır. İç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'ı yerine severity enum'ı kullanılır.
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ı.