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

Ürünlerinizi ve hesap durumunuzu 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 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 farklılıklar

Merchant API AccountIssue kaynağındaki temel iyileştirmeler ve farklar aşağıda verilmiştir:

  • Özel kaynak: Hesap sorunları kendi kaynağıdır. Alışveriş için Content API'de hesap düzeyindeki sorunlar, genel AccountStatus kaynağının iç içe yerleştirilmiş bir alanıydı. Merchant API ile accounts.issues.list yöntemini kullanarak bunları doğrudan 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, sorun 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ş 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ıyla ilgili 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 gövdesindeki 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 kullanın ve hesap kimliğini belirtin. Merchant API'de tek sayı 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 numarasını 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 sunuluyor.
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 derecesi 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ı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ştirildi.
(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
Overview
Sonraki
Migrate accountstatuses to Aggregate Product Statuses