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 API sprzedawcy 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 API sprzedawcy 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 API sprzedawcy:

  • 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 API sprzedawcy 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 API sprzedawcy, musisz wywołać accounts.listSubaccounts, a następnie accounts.issues.list dla każdego subkonta.

Żądania

W interfejsie API sprzedawcy 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 iterować po subkontach.

Identyfikatory

W interfejsie API sprzedawcy 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 API sprzedawcy 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 API sprzedawcy nie ma metody get dla pojedynczego problemu.
accountstatuses.list Brak bezpośredniego odpowiednika. Niedostępne. Metoda accounts.issues.list w interfejsie API sprzedawcy 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 wsadowe problemów z kontem nie jest obsługiwane w interfejsie API sprzedawcy. 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 osobnym 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), a nie ciągiem 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.
Wstecz
Migrate account management
Dalej
Migrate accountstatuses to Aggregate Product Statuses