accountstatuses'tan Hesap Sorunları'na geçiş

Ürünlerinizi ve hesap durumunuzu etkileyebilecek hesap düzeyindeki sorunları alma yönteminiz değişti. Content API for Shopping'deki accountstatuses kaynağıyla karşılaştırıldığında Merchant API, daha yapılandırılmış ve ayrıntılı bilgiler sağlayan özel bir AccountIssue kaynağı sunar.

Yeni özelliğin nasıl kullanılacağı hakkında daha fazla bilgi için Hesap sorunlarını görüntüleme kılavuzunu inceleyin.

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

Temel farklar

Merchant API AccountIssue kaynağındaki önemli iyileştirmeler ve farklılıklar şunlardır:

• Özel kaynak: Hesap sorunları kendi kaynağıdır. Content API for Shopping'de hesap düzeyindeki sorunlar, genel AccountStatus kaynağında iç içe yerleştirilmiş bir alandı. Merchant API ile accounts.issues.list yöntemini kullanarak ürünleri doğrudan listeleyebilirsiniz.
• Yapılandırılmış etki verileri: AccountIssue kaynağı, ayrıntılı bir impactedDestinations alanı sağlar. Bu alan, bir sorunun etkisinin net bir dökümünü sunar. Bu dökümde hedef (ör. Alışveriş reklamları), belirli bölge ve sorunun o bölgedeki önem derecesi yer alır.
• Sıralı değer olarak önem derecesi: severity alanı artık sıralı değer (CRITICAL, ERROR, SUGGESTION gibi değerlerle) olduğundan Content API for Shopping'deki dize tabanlı değerlere kıyasla programatik olarak işlenmesi daha kolaydır.
• Standartlaştırılmış tanımlayıcılar: Her hesap sorununun accounts/{ACCOUNT_ID}/issues/{ISSUE_ID} biçiminde benzersiz ve tam bir kaynağı name vardır. Bu standartlaştırılmış yaklaşım, Content API for Shopping'deki id dizesinin yerini alır.
• Yerelleştirme desteği: accounts.issues.list yöntemi, başlık ve açıklama gibi sorun ayrıntılarını tercih ettiğiniz dilde almak için bir language_code belirtmenize olanak tanır. Content API for Shopping'de bu mümkün değildi.
• Gelişmiş hesap davranışı: Gelişmiş bir hesapta accounts.issues.list yöntemini çağırdığınızda yalnızca doğrudan bu gelişmiş hesap için geçerli olan sorunlar döndürülür. Alt hesaplarından herhangi biriyle ilgili sorunları döndürmez. Content API for Shopping'de accountstatuses.list yöntemi, tüm alt hesapların durumlarını döndürür. Merchant API'deki tüm alt hesaplarla ilgili sorunları almak için accounts.listSubaccounts yöntemini çağırmanız ve ardından her alt hesap için ayrı ayrı accounts.issues.list yöntemini çağırmanız gerekir.

İstekler

Merchant API'de, belirli bir Merchant Center hesabıyla ilgili sorunları listeleyebilirsiniz.

GET https://merchantapi.googleapis.com/accounts/v1/accounts/ACCOUNT_ID/issues

İstek URL'si karşılaştırması

İstek açıklaması	Content API for Shopping	Merchant API
Tek bir hesap için hesap düzeyindeki sorunları listeleme	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID}	GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/issues
Gelişmiş bir hesabın tüm alt hesapları için hesap düzeyindeki sorunları listeleme	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses	Yok. Alt hesaplar arasında gezinmeniz gerekir.

Tanımlayıcılar

Merchant API'de hesap ve sorun tanımlayıcıları değişti.

Tanımlayıcı karşılaştırması

Tanımlayıcı açıklaması	Content API for Shopping	Merchant API
Hesap tanımlayıcı	Yol parametreleri olarak {MERCHANT_ID} ve {ACCOUNT_ID}.	{ACCOUNT_ID}, accounts/{ACCOUNT_ID} biçiminde bir yol parametresi olarak.
Sorun tanımlayıcı	Yanıt gövdesindeki id alanı (ör. "products-that-enable-dishonest-behavior-hacking-policy").	name alanı, tam kaynak adıdır (ör. accounts/12345/issues/example-issue-id).

Yöntemler

Merchant API'de hesap sorunlarını alma yöntemleri birleştirildi ve basitleştirildi.

Yöntem karşılaştırması

Content API for Shopping	Merchant API	Kullanılabilirlik ve notlar
accountstatuses.get	accounts.issues.list	Kullanılabilir. Tek bir hesabın sorunlarını almak için accounts.issues.list kullanın ve hesap kimliğini belirtin. Merchant API'de tek bir sorun için get yöntemi yoktur.
accountstatuses.list	Doğrudan bir karşılığı yoktur.	Kullanılamıyor. Merchant API'deki accounts.issues.list yöntemi, yalnızca belirtilen hesabın sorunlarını döndürür, alt hesaplarının sorunlarını döndürmez. Tüm alt hesaplarla ilgili sorunları almak için önce accounts.listSubaccounts yöntemini, ardından her alt hesap için accounts.issues.list yöntemini çağırmanız gerekir.
accountstatuses.custombatch	Doğrudan bir karşılığı yoktur.	Kullanılamıyor. Merchant API'de hesap sorunları için toplu işleme desteklenmez. Her hesap için ayrı list çağrıları yapmanız gerekir.

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

Hesap sorunu kaynağındaki alanlar, daha fazla yapı ve netlik sağlayacak şekilde güncellendi.

Alan karşılaştırması

Content API for Shopping	Merchant API	Açıklama
accountLevelIssues (AccountStatus içinde dizi)	accountIssues (ListAccountIssuesResponse içinde dizi)	Sorunlar artık iç içe yerleştirilmiş bir alan değil, özel ve üst düzey bir kaynaktır.
id (dize)	name (dize)	Sorun tanımlayıcısı artık tam bir kaynak adıdır (ör. accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}).
title (dize)	title (dize)	Değişiklik yok.
detail (dize)	detail (dize)	Değişiklik yok.
documentation (dize)	documentationUri (dize)	Alan, URL olduğunu belirtmek için daha anlaşılır olacak şekilde yeniden adlandırıldı.
severity (dize)	severity (enum)	Önem düzeyi artık dize yerine yapılandırılmış bir enum (CRITICAL, ERROR, SUGGESTION) olarak gösteriliyor.
country (dize), destination (dize)	impactedDestinations (tekrarlanan mesaj)	Etki artık bir liste halinde yapılandırılmıştır. Etkilenen her alan için hedef, bölge ve önem derecesi gruplandırılmıştır. country alanı, Impact mesajında regionCode ile değiştirilir.
(Kullanılamıyor)	language_code, time_zone (istek parametreleri)	list isteğindeki yeni parametreler, title ve detail gibi kullanıcı tarafından okunabilen alanların yerelleştirilmesine olanak tanır.