Migracja stanu konta na zbiorcze stany produktów

Zmieniliśmy sposób pobierania zbiorczych statystyk i problemów z produktami. Funkcja, która była wcześniej dostępna w zasobie accountstatuses w Content API for Shopping, jest teraz podzielona na osobne zasoby w Merchant API. Z tego przewodnika dowiesz się, jak przeprowadzić migrację integracji, aby korzystać z nowego aggregateProductStatuses zasobu.

Najważniejsze różnice

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

  • Osobne zasoby: zasób accountstatuses z Content API for Shopping jest teraz podzielony. W Merchant API problemy na poziomie konta są dostępne za pomocą zasobu accountissues , a zbiorcze statystyki produktów i problemy na poziomie produktu są dostępne za pomocą nowego aggregateProductStatuses zasobu.
  • 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 jak destinations do wybierania danych, Merchant API używa metody list z ciągiem filter 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

Merchant API używa żądania GET z parametrem filter do pobierania zbiorczych stanów produktów.

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 problemów 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. Za pomocą parametrów zapytania wybrano konkretne wycinki danych. Nazwa zasobu jednoznacznie identyfikuje dane dla konkretnego kontekstu 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 zwracał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 metody accountissues.list.

Szczegółowe zmiany w polach

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

Content API for Shopping Merchant API Opis
products aggregate_product_statuses Tablica products jest zastępowana przez powtarzające się pole aggregate_product_statuses w odpowiedzi listy.
destination reporting_context Pole destination jest zastępowane przez reporting_context, które określa kontekst programu dla statystyk.
channel (brak odpowiednika) Pole channel zostało usunięte. Te informacje są teraz częścią reporting_context.
statistics stats Obiekt statistics został zmieniony na stats. Nazwy pól w tym obiekcie są przekształcane na snake_case, np. activeCount to teraz active_count.
itemLevelIssues.servability item_level_issues.severity Wyliczenie servability jest zastępowane przez wyliczenie severity, aby opisać wpływ problemu.
itemLevelIssues.attributeName item_level_issues.attribute Pole attributeName zostało zmienione na attribute.
itemLevelIssues.documentation item_level_issues.documentation_uri Pole documentation zostało zmienione na documentation_uri.
itemLevelIssues.numItems item_level_issues.product_count Pole numItems zostało zmienione na product_count.
Wstecz
Migrate accountstatuses to Account Issues
Dalej
Migrate user and access management