Migracja stanu konta na zbiorcze stany produktów

Zmieniliśmy sposób pobierania zbiorczych statystyk i problemów dotyczących produktów. Funkcja dostępna wcześniej w zasobie accountstatuses w interfejsie Content API for Shopping została podzielona na osobne zasoby w interfejsie Merchant API. Z tego przewodnika dowiesz się, jak przekształcić integrację, aby korzystała z nowego zasobu aggregateProductStatuses.

Najważniejsze różnice

Oto najważniejsze różnice między funkcjami stanu produktu w interfejsie Content API for Shopping a interfejsie Merchant API:

  • Osobne zasoby: zasób accountstatuses z Content API for Shopping został podzielony. W Merchant API problemy na poziomie konta są dostępne w zasobie accountissues, a zagregowane statystyki produktów i problemy na poziomie produktu są dostępne w nowym zasobie aggregateProductStatuses.
  • Nowa struktura zasobów: AggregateProductStatus to nowy zasób, który reprezentuje statystyki i problemy dotyczące konkretnej kombinacji kontekstu raportowania i kraju.
  • Mechanizm filtrowania: zamiast używać parametrów zapytania, takich jakdestinations, do wybierania danych Merchant API używa metody list z ciągiem znakówfilter do wysyłania zapytań o konkretne konteksty raportowania i kraje.
  • Usunięcie pola kanału: pole channel nie jest już używane. Te informacje są teraz niejawnie częścią reportingContext.

Żądania

Interfejs Merchant API używa żądania GET z parametrem filter do pobierania zbiorczych stanów produktów. Szczegółowe informacje o składni filtra znajdziesz w artykule Składnia filtra.

GET https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses

Format adresu URL żądania

Opis prośby Content API for Shopping Merchant API
Pobieranie statystyk i informacji o problemach z produktami GET /content/v2.1/{merchantId}/accountstatuses/{accountId} GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses

Identyfikatory

Sposób identyfikowania zasobów został zmieniony, aby obsługiwać nową strukturę.

Format identyfikatora

Opis identyfikatora Content API for Shopping Merchant API
Identyfikator zasobu Zasób został zidentyfikowany przez accountId. Wybrano konkretne wycinki danych za pomocą parametrów zapytania. Nazwa zasobu jednoznacznie identyfikuje dane w określonym kontekście raportowania i kraju: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}.

Metody

Metoda pobierania stanów produktów została zaktualizowana do metody list, która obsługuje filtrowanie.

Metoda Content API for Shopping Metoda Merchant API Dostępność i uwagi
accountstatuses.get aggregateProductStatuses.list Metoda accountstatuses.get zwróciła pojedynczy zasób zawierający wszystkie statystyki produktów. Nowa metoda aggregateProductStatuses.list zwraca listę zasobów, po jednym dla każdej kombinacji kontekstu raportowania i kraju. Aby pobrać konkretne dane, użyj parametru filter. W przypadku problemów na poziomie konta użyj ikony accountissues.list.

Szczegółowe zmiany w polach

Pola statystyk i problemów z produktami zostały zaktualizowane i przekształcone w nowym AggregateProductStatus.

Content API for Shopping Merchant API Opis
products aggregate_product_statuses Tablica products jest zastępowana powtarzanym polem aggregate_product_statuses w odpowiedzi listy.
destination reporting_context Pole destination jest zastąpione polem reporting_context, które określa kontekst programu dla statystyk.
channel (brak odpowiedniego pola) Pole channel zostanie usunięte. Te informacje są teraz częścią reporting_context.
statistics stats Nazwa obiektu statistics została zmieniona na stats. Nazwy pól w nich są przekształcane na format snake_case, np. activeCount to teraz active_count.
itemLevelIssues.servability item_level_issues.severity Wyliczenie servability zostało zastąpione wyliczeniem severity, aby opisać wpływ problemu.
itemLevelIssues.attributeName item_level_issues.attribute Nazwa pola attributeName została zmieniona na attribute.
itemLevelIssues.documentation item_level_issues.documentation_uri Nazwa pola documentation została zmieniona na documentation_uri.
itemLevelIssues.numItems item_level_issues.product_count Nazwa pola numItems została zmieniona na product_count.
Wstecz
Migrate accountstatuses to Account Issues
Dalej
Migrate user and access management