Przenoszenie z accountstatuses do Account Issues

Sposób pobierania problemów na poziomie konta, które mogą mieć wpływ na Twoje produkty i stan konta, uległ zmianie. W porównaniu z zasobem accountstatuses w Content API for Shopping Merchant API wprowadza dedykowany zasób AccountIssue, który zawiera bardziej uporządkowane 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 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 APIAccountIssue:

• Osobny zasób: problemy z kontem są osobnym zasobem. W interfejsie Content API for Shopping problemy na poziomie konta były zagnieżdżonym polem w ogólnym zasobie AccountStatus. Dzięki Merchant API możesz wyświetlać 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 jasne zestawienie wpływu problemu, w tym miejsce docelowe (np. reklamy produktowe), konkretny region i stopień nasilenia 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 opartymi na ciągach znaków w 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 preferowanym języku. Nie było to możliwe w interfejsie Content API for Shopping.
• Zaawansowane zachowanie konta: gdy wywołasz accounts.issues.list na koncie zaawansowanym, zwróci ono 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 na wszystkich subkontach 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 interfejsie 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 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 dla wszystkich subkont konta zaawansowanego	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses	Niedostępne. Musisz przejść przez wszystkie subkonta.

Identyfikatory

W Merchant API zmieniły się identyfikatory kont i problemów.

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ł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 określ 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 interfejsie 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 Merchant API. W przypadku każdego konta musisz wykonać osobne wywołanie list.

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 osobnym 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)	Nazwa pola została zmieniona w celu uniknięcia wątpliwości, aby wskazywać, ż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 (powtarzająca się wiadomość)	Informacje o wpływie są teraz uporządkowane w formie listy, która zawiera miejsce docelowe, region i stopień nasilenia w przypadku każdego obszaru, którego to dotyczy. 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 czytelnych dla użytkownika, takich jak title i detail.