Przenoszenie z accountstatuses do Account Issues

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

Więcej informacji o korzystaniu z tej nowej funkcji znajdziesz w przewodniku Wyświetlanie problemów z kontem.

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

Najważniejsze różnice

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

  • Osobne zasoby: problemy z kontem są osobnym zasobem. W Content API for Shopping problemy na poziomie konta były zagnieżdżonym polem w ogólnym zasobie AccountStatus. Za pomocą Merchant API możesz je wyświetlać 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 szczegółowe informacje o wpływie problemu, w tym miejsce docelowe (np. reklamy produktowe), konkretny region i powagę problemu w tym regionie.
  • Ważność jako wyliczenie: pole severity jest teraz wyliczeniem (z wartościami takimi jak CRITICAL, ERROR, SUGGESTION), co ułatwia przetwarzanie programowe w porównaniu z wartościami tekstowymi w interfejsie Content API for Shopping.
  • Ustandaryzowane identyfikatory: każdy problem z kontem ma unikalny, pełny zasób name w formacie accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. To ujednolicone 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 language_code, aby otrzymywać szczegóły problemu, takie jak tytuł i opis, w wybranym języku. Nie było to możliwe w interfejsie Content API for Shopping.
  • Zaawansowane działanie konta: gdy wywołasz funkcję accounts.issues.list na koncie zaawansowanym, zwróci ona tylko problemy, które dotyczą bezpośrednio tego konta. Nie zwraca problemów dotyczących żadnego z subkont. W Content API for Shopping metoda accountstatuses.list zwracałaby stany wszystkich subkont. Aby uzyskać informacje o problemach dotyczących wszystkich subkont w interfejsie Merchant API, musisz wywołać funkcję accounts.listSubaccounts, a następnie wywołać funkcję accounts.issues.list dla każdego subkonta z osobna.

Żądania

W Merchant API możesz wyświetlić listę problemów z kontem dla konkretnego konta Merchant Center.

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

Porównanie URL-i żą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 dla wszystkich subkont konta zaawansowanego GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses Niedostępne. Musisz przejść przez wszystkie subkonta.

Identyfikatory

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

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 w treści odpowiedzi (np. "products-that-enable-dishonest-behavior-hacking-policy").id name w treści odpowiedzi, czyli pełna nazwa 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ć informacje o problemach dotyczących jednego konta, użyj znaku accounts.issues.list i podaj identyfikator konta. Interfejs Merchant API nie ma metody get dla pojedynczego wydania.
accountstatuses.list Brak bezpośredniego odpowiednika. Niedostępne Metoda accounts.issues.list w Merchant API zwraca tylko problemy dotyczące określonego konta, a nie jego subkont. Aby uzyskać informacje o problemach na wszystkich subkontach, musisz najpierw wywołać funkcję accounts.listSubaccounts, a potem wywołać funkcję accounts.issues.list dla każdego subkonta.
accountstatuses.custombatch Brak bezpośredniego odpowiednika. Niedostępne Przetwarzanie zbiorcze problemów z kontem nie jest obsługiwane w interfejsie Merchant API. Musisz wykonać osobne wywołania list dla każdego konta.

Szczegółowe zmiany w polach

Pola w zasobie problemu z kontem zostały zaktualizowane, aby zapewnić większą strukturę i przejrzystość.

Porównanie pól

Content API for Shopping Merchant API Opis
accountLevelIssues (tablica w AccountStatus) accountIssues (tablica w ListAccountIssuesResponse) Problemy są teraz dedykowanym zasobem najwyższego poziomu, a nie zagnieżdżonym polem.
id (ciąg znaków) name (ciąg znaków) Identyfikator problemu jest teraz pełną nazwą zasobu, np. accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}.
title (ciąg znaków) title (ciąg znaków) Nic się nie zmieni.
detail (ciąg znaków) detail (ciąg znaków) Nic się nie zmieni.
documentation (ciąg znaków) documentationUri (ciąg znaków) Zmieniliśmy nazwę pola, aby wskazać, że jest to adres URL.
severity (ciąg znaków) severity (wyliczenie) Poziom ważności jest teraz uporządkowanym typem wyliczeniowym (CRITICAL, ERROR, SUGGESTION) zamiast ciągiem znaków.
country (ciąg znaków), destination (ciąg znaków) impactedDestinations (powtarzany komunikat) Informacje o wpływie są teraz uporządkowane w postaci listy, która zawiera miejsce docelowe, region i stopień zagrożenia w przypadku każdego obszaru, na który ma wpływ. Pole country jest zastępowane wartością regionCode w wiadomości Impact.
(Niedostępne) language_code, time_zone (parametry żądania) Nowe parametry w żądaniu list umożliwiają lokalizację pól czytelnych dla użytkownika, takich jak title i detail.
Wstecz
Overview
Dalej
Migrate accountstatuses to Aggregate Product Statuses