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, Content API for Shopping'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 rehberine 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 farklılıklar şunlardır:

  • Özel kaynak: Hesap sorunları kendi kaynağıdır. Alışveriş İçin İçerik API'sinde hesap düzeyindeki sorunlar, genel AccountStatus kaynağının iç içe yerleştirilmiş bir alanıydı. 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, bir sorunun etkisine ilişkin net bir döküm sunar. Bu dökümde hedef (ör. Alışveriş reklamları), belirli bölge ve bu bölgedeki sorunun ciddiyet düzeyi gibi bilgiler yer alır.
  • 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 benzersiz ve tam bir kaynağı vardır. name biçimindedir.accounts/{ACCOUNT_ID}/issues/{ISSUE_ID} 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 language_code belirtmenize olanak tanır. Bu, Alışveriş için Content API'de mümkün değildi.
  • Gelişmiş hesap davranışı: Bir gelişmiş hesapta accounts.issues.list işlevini çağırdığınızda yalnızca doğrudan bu gelişmiş hesapla ilgili sorunlar döndürülür. Alt hesaplarının hiçbirinde sorun 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 önce accounts.listSubaccounts'yı, ardından her alt hesap için ayrı ayrı accounts.issues.list'yı ç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 hesapların ve sorunların 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 metnindeki 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 hesapla ilgili sorunları almak için accounts.issues.list simgesini 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 dizisi) accountIssues (ListAccountIssuesResponse dizisi) Sorunlar artık iç içe yerleştirilmiş bir alan değil, özel bir üst düzey kaynak olarak gösteriliyor.
id (dize) name (dize) Sorun tanımlayıcı artık tam 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 belirtecek şekilde daha anlaşılır olması için 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 tanımlanı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 okunabilir alanların yerelleştirilmesine olanak tanır.
Önceki
Migrate account management
Sonraki
Migrate accountstatuses to Aggregate Product Statuses