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 Content API for Shopping jest teraz podzielona na osobne zasoby w Merchant API. Z tego przewodnika dowiesz się, jak przenieść integrację, aby korzystać z nowego zasobu aggregateProductStatuses.

Uwaga: w Merchant API problemy na poziomie konta i zbiorcze stany produktów są rozdzielone. Zapoznaj się też z naszym przewodnikiem dotyczącym przenoszenia danych z accountstatuses na konto.

Najważniejsze różnice

Oto główne 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 jak destinations do wybierania danych, Merchant API używa metody list z ciągiem znaków 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

Interfejs 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 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. Za pomocą parametrów zapytania wybrano konkretne wycinki danych.	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 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 ikony accountissues.list.

Szczegółowe zmiany w polach

Pola statystyk i problemów z produktami zostały zaktualizowane i przekształcone w nowym zasobie 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	Obiekt statistics zmienia nazwę 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 opisywać 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.