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 strukturalne i szczegółowe informacje.
Więcej informacji o korzystaniu z tej nowej funkcji znajdziesz w przewodniku Wyświetlanie problemów z kontem.
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ą metodyaccounts.issues.list
. - Uporządkowane dane o wpływie: zasób
AccountIssue
zawiera szczegółowe poleimpactedDestinations
. 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 jakCRITICAL
,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 formacieaccounts/{ACCOUNT_ID}/issues/{ISSUE_ID}
. To ustandaryzowane podejście zastępuje ciąg znakówid
z Content API for Shopping. - Obsługa lokalizacji: metoda
accounts.issues.list
umożliwia określenielanguage_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 metodaaccountstatuses.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/v1beta/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/v1beta/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 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 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ągu tekstowego. |
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 . |