Przenoszenie z accountstatuses do Account Issues

Zmieniliśmy sposób pobierania problemów na poziomie konta, które mogą wpływać na Twoje produkty i stan konta. W porównaniu z zasobem accountstatuses w Content API for Shopping interfejs Merchant API wprowadza dedykowany zasób AccountIssue, który dostarcza bardziej uporządkowane i szczegółowe informacje.

Więcej informacji o korzystaniu z nowej funkcji znajdziesz w przewodniku po wyświetlaniu problemów z kontem.

Uwaga: w interfejsie Merchant API problemy na poziomie konta i zbiorcze stany produktów są rozdzielone. Zapoznaj się też z naszym przewodnikiem dotyczącym migracji z accountstatuses do zbiorczych stanów produktów.

Najważniejsze różnice

Oto najważniejsze ulepszenia i różnice w zasobie Merchant API AccountIssue:

  • Dedykowane zasoby: problemy z kontem są osobnym zasobem. W Content API for Shopping problemy na poziomie konta były polem zagnieżdżonym w ogólnym zasobie AccountStatus. Dzięki Merchant API możesz wyświetlić je bezpośrednio za pomocą metody accounts.issues.list.
  • Uporządkowane dane o wpływie: zasób AccountIssue zawiera szczegółowe pole impactedDestinations. To pole zawiera przejrzyste zestawienie wpływu problemu, w tym miejsce docelowe (np. reklamy produktowe), konkretny region i wagę problemu w tym regionie.
  • Waga jako typ wyliczeniowy: pole severity jest teraz typem wyliczeniowym (z wartościami takimi jak CRITICAL, ERROR, SUGGESTION), co ułatwia przetwarzanie programowe w porównaniu z wartościami opartymi na ciągach znaków w Content API for Shopping.
  • Identyfikatory standardowe: każdy problem z kontem ma unikalny, pełny zasób name w formacie accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. To ustandaryzowane podejście zastępuje ciąg znaków id z Content API for Shopping.
  • Obsługa lokalizacji: metoda accounts.issues.list umożliwia określenie parametru language_code, aby otrzymywać szczegóły problemu, takie jak tytuł i opis, w preferowanym języku. W Content API for Shopping nie było to możliwe.
  • Działanie konta zaawansowanego: gdy wywołasz metodę accounts.issues.list na koncie zaawansowanym, zwróci ona tylko problemy, które dotyczą bezpośrednio tego konta. Nie zwraca problemów dotyczących subkont. W Content API for Shopping metoda accountstatuses.list zwraca stany wszystkich subkont. Aby uzyskać problemy dotyczące wszystkich subkont w interfejsie Merchant API, musisz wywołać metodę accounts.listSubaccounts, a następnie accounts.issues.list dla każdego subkonta osobno.

Żądania

W interfejsie Merchant API możesz wyświetlić listę problemów z konkretnym kontem Merchant Center.

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

Porównanie adresów URL żądań

Opis prośby Content API for Shopping Merchant API
Wyświetlanie listy problemów na poziomie konta dla jednego konta GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID} GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/issues
Wyświetlanie listy problemów na poziomie konta dotyczących wszystkich subkont konta zaawansowanego GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses Niedostępne. Musisz przejść przez subkonta.

Identyfikatory

Identyfikatory kont i problemów uległy zmianie w interfejsie Merchant API.

Porównanie identyfikatorów

Opis identyfikatora Content API for Shopping Merchant API
Identyfikator konta {MERCHANT_ID} i {ACCOUNT_ID} jako parametry ścieżki. {ACCOUNT_ID} jako parametr ścieżki w formacie accounts/{ACCOUNT_ID}.
Identyfikator problemu Pole id w treści odpowiedzi (na przykład "products-that-enable-dishonest-behavior-hacking-policy"). name w treści odpowiedzi, czyli pełną nazwę zasobu (np. accounts/12345/issues/example-issue-id).

Metody

Metody pobierania problemów z kontem zostały skonsolidowane i uproszczone w interfejsie Merchant API.

Porównanie metod

Content API for Shopping Merchant API Dostępność i uwagi
accountstatuses.get accounts.issues.list Dostępne. Aby uzyskać problemy dotyczące jednego konta, użyj metody accounts.issues.list i podaj identyfikator konta. Interfejs Merchant API nie ma metody get dla pojedynczego problemu.
accountstatuses.list Brak bezpośredniego odpowiednika. Niedostępne. Metoda accounts.issues.list w interfejsie Merchant API zwraca tylko problemy dotyczące określonego konta, a nie jego subkont. Aby uzyskać problemy dotyczące wszystkich subkont, musisz najpierw wywołać accounts.listSubaccounts, a następnie accounts.issues.list dla każdego subkonta.
accountstatuses.custombatch Brak bezpośredniego odpowiednika. Niedostępne. Przetwarzanie wsadowe problemów z kontem nie jest obsługiwane w Merchant API. Musisz wykonać osobne wywołania list dla każdego konta.

Szczegółowe zmiany w polach

Zaktualizowaliśmy pola w zasobie problemu z kontem, aby zapewnić większą przejrzystość i lepszą strukturę.

Porównanie pól

Content API for Shopping Merchant API Opis
accountLevelIssues (tablica w: AccountStatus) accountIssues (tablica w: ListAccountIssuesResponse) Problemy są teraz osobnym zasobem najwyższego poziomu, a nie zagnieżdżonym polem.
id (ciąg tekstowy) name (ciąg tekstowy) Identyfikator problemu jest teraz pełną nazwą zasobu, na przykład accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}.
title (ciąg tekstowy) title (ciąg tekstowy) Nic się nie zmieni.
detail (ciąg tekstowy) detail (ciąg tekstowy) Nic się nie zmieni.
documentation (ciąg tekstowy) documentationUri (ciąg tekstowy) Zmieniliśmy nazwę pola w celu uniknięcia wątpliwości, aby wskazać, że chodzi o adres URL.
severity (ciąg tekstowy) severity (wyliczenie) Poziom ważności jest teraz uporządkowanym typem wyliczeniowym (CRITICAL, ERROR, SUGGESTION), a nie ciągiem znaków.
country (ciąg tekstowy), destination (ciąg tekstowy) impactedDestinations (powtórzona wiadomość) Wpływ jest teraz uporządkowany w formie listy, która grupuje miejsce docelowe, region i poziom ważności dla każdego obszaru, którego dotyczy problem. Pole country jest zastępowane przez regionCode w wiadomości Impact.
(Niedostępne) language_code, time_zone (parametry żądania) Nowe parametry w żądaniu list umożliwiają lokalizację pól zrozumiałe dla człowieka, takich jak title i detail.
Wstecz
Migrate account management
Dalej
Migrate accountstatuses to Aggregate Product Statuses