Migracja zarządzania regionami

Z tego przewodnika dowiesz się, jak przenieść integrację z interfejsu RegionsService Content API for Shopping do interfejsu RegionsService w ramach podrzędnego interfejsu API Konta.

Usługa Regiony umożliwia definiowanie niestandardowych obszarów geograficznych na potrzeby takich przypadków użycia jak regionalne ceny i zastąpienia dostawy. Możesz używać regionów z usługami, takimi jak RegionalInventory i ShippingSettings.

Najważniejsze różnice

• Struktura interfejsu API: usługa Regions jest teraz częścią interfejsu API Accounts w Merchant API (np. merchantapi.googleapis.com/accounts/v1/...).
• Nazwy zasobów: interfejs Merchant API używa nazw zasobówaccounts/{account}/regions/{region} zamiast oddzielnych parametrów merchant_id i region_id w ścieżce adresu URL w przypadku operacji Get, Update i Delete.
• Zgodność z AIP: metody Merchant API są zgodne ze standardowymi wzorcami propozycji ulepszeń interfejsu API (np. używają parent w przypadku List/Create, name w przypadku Get/Delete i standardowego użycia update_mask).
• Typy opakowań: pola, które wcześniej używały google.protobuf.StringValue lub google.protobuf.BoolValue w Content API, teraz używają standardowych pól optional w Merchant API.
• Nowe funkcje:
  • Merchant API wprowadza RadiusArea w zasobie Region, aby definiować regiony na podstawie promienia wokół punktu (początkowo z widocznością TRUST_TESTER).
  • Dostępne są metody wsadowe – BatchCreateRegions, BatchUpdateRegions, BatchDeleteRegions.
• Obsługa błędów: kody błędów i komunikaty o błędach zawierają bardziej szczegółowe informacje.

Żądania

Oto jak zmieniają się wzorce żądań:

Produkt	Content API for Shopping	Interfejs API sprzedawcy	Opis
Punkt końcowy	https://shoppingcontent.googleapis.com	https://merchantapi.googleapis.com	Zmienia się domena podstawowa.
Pobierz ścieżkę	/content/v2.1/{merchant_id}/regions/{region_id}	/accounts/v1/{name=accounts/*/regions/*}	Interfejs Merchant API korzysta z interfejsu accounts i zasobu name.
Ścieżka listy	/content/v2.1/{merchant_id}/regions	/accounts/v1/{parent=accounts/*}/regions	Interfejs Merchant API używa znaku parent do określania konta.
Utwórz ścieżkę	/content/v2.1/{merchant_id}/regions	/accounts/v1/{parent=accounts/*}/regions	Interfejs API sprzedawcy korzysta z parent. region_id to pole w treści żądania.
Ścieżka aktualizacji	/content/v2.1/{merchant_id}/regions/{region_id}	/accounts/v1/{name=accounts/*/regions/*}	Nazwa zasobu w interfejsie Merchant API jest częścią obiektu region w treści.
Usuń ścieżkę	/content/v2.1/{merchant_id}/regions/{region_id}	/accounts/v1/{name=accounts/*/regions/*}	Używa zasobu name.

Identyfikatory

Zmień sposób używania identyfikatorów w ten sposób:

Produkt	Content API for Shopping	Interfejs API sprzedawcy	Opis
Konto	merchant_id (liczba całkowita)	account (liczba całkowita, część ciągu znaków name lub parent)	Znajdź identyfikator konta w ciągu nazwy zasobu, np. accounts/{account}.
Region	region_id (ciąg znaków)	{region} (ciąg znaków, część ciągu znaków name)	Znajdź identyfikator regionu w ciągu nazwy zasobu, np. accounts/{account}/regions/{region}.
Nazwa zasobu	Nie jest używany w przypadku żądań.	name: accounts/{account}/regions/{region}	Standardowy identyfikator żądań Get/Update/Delete.
Imię i nazwisko rodzica	Nie jest używany w przypadku żądań.	parent: accounts/{account}	Standardowy identyfikator żądań List/Create.

Zasoby

Struktura zasobu Region została nieznacznie zmieniona:

Produkt	Content API for Shopping	Interfejs API sprzedawcy	Opis
Identyfikator zasobu	region_id (ciąg znaków), merchant_id (64-bitowa liczba całkowita)	name (ciąg): accounts/{account}/regions/{region}	Interfejs Merchant API używa pojedynczego pola name jako identyfikatora zasobu.
display_name	google.protobuf.StringValue	optional string	Typ modułu owijającego został usunięty.
radius_area	Niedostępne	RadiusArea	Ten nowy typ określa regiony według promienia. Obejmuje:region_code, lat_lng, radius,radius_units. Domyślnie widoczność jest ograniczona.
regional_inventory_eligible	google.protobuf.BoolValue (tylko wyjście)	optional bool (tylko wyjście)	Typ modułu owijającego został usunięty.
shipping_eligible	google.protobuf.BoolValue (tylko wyjście)	optional bool (tylko wyjście)	Typ modułu owijającego został usunięty.

Metody

Zmień sposób używania metod w ten sposób:

Produkt	Content API for Shopping	Interfejs API sprzedawcy	Opis
Uzyskaj region	GetRegion	GetRegion	Żądanie używa metody name.
Utwórz region	CreateRegion	CreateRegion	Żądanie pobiera parent z adresu URL, a treść żądania zawiera obiekt region i region_id.
Zaktualizuj region	UpdateRegion	UpdateRegion	Żądanie używa parametrów region (który musi zawierać region.name) i update_mask.
Usuń region	DeleteRegion	DeleteRegion	Żądanie używa metody name.
Wyświetlanie listy regionów	ListRegions	ListRegions	Żądanie używa metody parent. Działanie funkcji page_size i page_token jest spójne.
Utwórz zbiorczo	Nie dotyczy	BatchCreateRegions	To nowa metoda.
Aktualizacja zbiorcza	Nie dotyczy	BatchUpdateRegions	To nowa metoda.
Usuwanie zbiorcze	Nie dotyczy	BatchDeleteRegions	To nowa metoda.

Pola, których nazwy zostały zmienione

Produkt	Content API for Shopping	Interfejs API sprzedawcy	Opis
Identyfikator konta	merchant_id	account (część name lub parent)	Zintegrowane z ciągami znaków zasobu name. Ma to wpływ na Region (odpowiedź) i wiadomości protokołu buforów używane do wysyłania żądań do interfejsu API, takie jak CreateRegionRequest, GetRegionRequest, UpdateRegionRequest, DeleteRegionRequest i ListRegionsRequest.
Identyfikator regionu	region_id	region (część name), region_id	Większość ma zintegrowane pole name, a osobne pole region_id w CreateRegionRequest. Dotyczy to Region (odpowiedzi) i wiadomości protokołu buforów protokołu używanych do wysyłania żądań do interfejsu API, takich jak CreateRegionRequest, GetRegionRequest, UpdateRegionRequest, DeleteRegionRequest i ListRegionsRequest.
Nazwa regionu (dane wyjściowe)	region_id	name	Głównym polem identyfikatora w odpowiedzi jest teraz pełny zasób name. Dotyczy to Region.
Wyświetlana nazwa	display_name	display_name	Typ zmienia się z StringValue na optional string. Dotyczy to Region.
Flagi kwalifikacji	...eligible	...eligible	Typ zmienia się z BoolValue na optional bool. Dotyczy to Region.
Aktualizuj maskę	update_mask	update_mask	Region polne ścieżki. Dotyczy to UpdateRegionRequest.

Więcej informacji

• Zasób REST: accounts.regions w interfejsie Merchant API
• Przewodnik po regionach
• Konfigurowanie regionów