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 kondycję konta. W porównaniu z zasobem accountstatuses w Content API for Shopping interfejs Merchant API wprowadza dedykowany zasób AccountIssue, który zawiera bardziej uporządkowane i szczegółowe informacje.

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

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 na zbiorcze stany produktów.

Najważniejsze różnice

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

• Dedykowany zasób: problemy z kontem są teraz osobnym zasobem. W Content API for Shopping problemy na poziomie konta były polem zagnieżdżonym w ogólnym zasobie AccountStatus. W interfejsie Merchant API możesz je wyświetlić bezpośrednio za pomocą metody accounts.issues.list.
• Ustrukturyzowane 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 wagę problemu w tym regionie.
• Waga jako wyliczenie: pole severity jest teraz wyliczeniem (z wartościami takimi jak CRITICAL, ERROR, SUGGESTION), co ułatwia programowe przetwarzanie w porównaniu z wartościami tekstowymi w Content API for Shopping.
• Ustandaryzowane identyfikatory: każdy problem z kontem ma unikalną, pełną nazwę zasobu name w formacie accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. To ustandaryzowane podejście zastępuje ciąg 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. W Content API for Shopping nie było to możliwe.
• Zaawansowane zachowanie konta: gdy wywołasz accounts.issues.list na koncie zaawansowanym, zwróci ona tylko problemy, które dotyczą bezpośrednio tego konta. Nie zwróci problemów z żadnym z jego subkont. W Content API for Shopping metoda accountstatuses.list zwracała stany wszystkich subkont. Aby uzyskać problemy ze wszystkimi subkontami w interfejsie Merchant API, musisz wywołać 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 kontem w przypadku 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 w przypadku 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 w przypadku wszystkich subkont konta zaawansowanego	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses	Niedostępne. Musisz iterować po subkontach.

Identyfikatory

W interfejsie 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 (np. "products-that-enable-dishonest-behavior-hacking-policy").	Pole name w treści odpowiedzi, które jest pełną nazwą zasobu (np. accounts/12345/issues/example-issue-id).

Metody

W interfejsie Merchant API metody pobierania problemów z kontem zostały ujednolicone i uproszczone.

Porównanie metod

Content API for Shopping	Merchant API	Dostępność i uwagi
accountstatuses.get	accounts.issues.list	Dostępne. Aby uzyskać problemy z jednym kontem, użyj accounts.issues.list i określ 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 z określonym kontem, a nie z jego subkontami. Aby uzyskać problemy ze wszystkimi subkontami, 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 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 pól

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 polem zagnieżdżonym.
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)	Bez zmian.
detail (ciąg znaków)	detail (ciąg znaków)	Bez zmian.
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)	Waga jest teraz ustrukturyzowanym wyliczeniem (CRITICAL, ERROR, SUGGESTION) zamiast ciągu znaków.
country (ciąg znaków), destination (ciąg znaków)	impactedDestinations (powtarzany komunikat)	Wpływ jest teraz ustrukturyzowany w postaci listy, która grupuje miejsce docelowe, region i wagę dla każdego obszaru, którego dotyczy problem. Pole country zostało zastąpione polem regionCode w komunikacie Impact.
(Niedostępne)	language_code, time_zone (parametry żądania)	Nowe parametry w żądaniu list umożliwiają lokalizację pól czytelnych dla człowieka, takich jak title i detail.