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

Ürünlerinizi ve hesap sağlığınızı etkileyebilecek hesap düzeyindeki sorunları alma şekliniz değişti. Merchant API, Shopping için Content API'deki accountstatuses kaynağına kıyasla daha yapılandırılmış ve ayrıntılı bilgiler sağlayan özel bir AccountIssue kaynağı sunar.

Yeni özelliği kullanma hakkında daha fazla bilgi için Hesap sorunlarını görüntüleme kılavuzuna bakın.

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

Temel farklar

Merchant API AccountIssue kaynağındaki temel iyileştirmeler ve farklar şunlardır:

  • Özel kaynak: Hesap sorunları kendi kaynağıdır. Alışveriş için Content API'de hesap düzeyindeki sorunlar, genel AccountStatus kaynağında yerleştirilmiş bir alandı. Merchant API ile bunları doğrudan accounts.issues.list yöntemini kullanarak listeleyebilirsiniz.
  • Yapılandırılmış etki verileri: AccountIssue kaynağı, ayrıntılı bir impactedDestinations alanı sağlar. Bu alan, hedef (ör. Alışveriş reklamları), belirli bölge ve bu bölgedeki sorunun ciddiyeti dahil olmak üzere bir sorunun etkisinin net bir dökümünü sunar.
  • Enum olarak önem derecesi: severity alanı artık bir enum (CRITICAL, ERROR, SUGGESTION gibi değerlerle) olduğundan, programatik olarak işlenmesi, Alışveriş için Content API'deki dize tabanlı değerlere kıyasla 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, sorunun ayrıntılarını (ör. başlık ve açıklama) tercih ettiğiniz dilde almak için language_code belirtmenize olanak tanır. Bu, Alışveriş İçin İçerik API'sinde 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ş hesapla ilgili sorunlar döndürülür. Alt hesaplarla ilgili sorunlar döndürülmez. Alışveriş için Content API'de accountstatuses.list yöntemi, tüm alt hesapların durumlarını döndürür. Merchant API'de tüm alt hesaplarla ilgili sorunları almak için önce accounts.listSubaccounts yöntemini, ardından her bir 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 hesap sorunlarını 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 yineleme yapmanız 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ısı {MERCHANT_ID} ve {ACCOUNT_ID} yol parametreleri olarak. {ACCOUNT_ID}, accounts/{ACCOUNT_ID} biçiminde bir yol parametresi olarak.
Sorun tanımlayıcısı Yanıt gövdesindeki id alanı (örneğin, "products-that-enable-dishonest-behavior-hacking-policy"). Yanıt metnindeki name alanı. Bu alan, tam kaynak adıdır (örneğin, accounts/12345/issues/example-issue-id).

Yöntemler

Hesap sorunlarını alma yöntemleri, Merchant API'de 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 hesaptaki sorunları almak için accounts.issues.list yöntemini kullanın ve hesap kimliğini belirtin. Merchant API'de tek bir sorun için get yöntemi yoktur.
accountstatuses.list Doğrudan eşdeğeri yoktur. Kullanılamaz. Merchant API'deki accounts.issues.list yöntemi yalnızca belirtilen hesaptaki sorunları döndürür, alt hesaplardaki sorunları döndürmez. Tüm alt hesaplarla ilgili sorunları almak için önce accounts.listSubaccounts'ı, ardından her alt hesap için accounts.issues.list'ı aramanız gerekir.
accountstatuses.custombatch Doğrudan eşdeğeri yoktur. Kullanılamaz. Hesap sorunları için toplu işleme, Merchant API'de desteklenmez. Her hesap için ayrı ayrı list çağrı yapmanız gerekir.

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

Hesap sorunu kaynağındaki alanlar, daha fazla yapı ve netlik sağlamak için güncellendi.

Alan karşılaştırması

Content API for Shopping Merchant API Açıklama
accountLevelIssues (AccountStatus içindeki dizi) accountIssues (ListAccountIssuesResponse içindeki dizi) Sorunlar artık iç içe yerleştirilmiş bir alan değil, özel bir üst düzey kaynak olarak ele alınır.
id (dize) name (dize) Sorun tanımlayıcı artık tam bir kaynak adı (ör. accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}) olarak gösteriliyor.
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 bir şekilde yeniden adlandırıldı.
severity (dize) severity (enum) Önem derecesi artık dize yerine yapılandırılmış bir enum (CRITICAL, ERROR, SUGGESTION) olarak kullanılıyor.
country (dize), destination (dize) impactedDestinations (tekrarlanan mesaj) Etki artık bir liste halinde yapılandırılıyor ve etkilenen her alan için hedef, bölge ve önem derecesi gruplandırılıyor. 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ılar tarafından okunabilen alanların yerelleştirilmesine olanak tanır.
Önceki
Migrate account management
Sonraki
Migrate accountstatuses to Aggregate Product Statuses