Migracja ustawień reklam lokalnego asortymentu produktów

Jeśli korzystasz z ustawień reklam lokalnego asortymentu produktów w interfejsie Content API for Shopping, musisz wiedzieć o kilku ważnych zmianach w interfejsie Merchant API.

Ustawienia LIA należą teraz do jednego z 3 głównych komponentów, z których każdy ma powiązany zasób.

Główny komponent	Zasób
Konfiguracja konta na potrzeby wyświetlania wielokanałowego	OmnichannelSetting
połączenie z partnerem w ramach programu partnerskiego plików danych o asortymencie lokalnym w celu uzyskania danych o asortymencie;	LfpProvider
Połączenie z kontem Profilu Firmy w Google w celu uzyskania danych o lokalnych sklepach	GbpAccount

Dodatkowo w przypadku ustawień LIA na każde konto przypadał 1 zasób z listą ustawień dla każdego podmiotu krajowego. Za pomocą OmnichannelSettings możesz powiązać z kontem wiele zasobów. Każdy zasób reprezentuje ustawienia określonego podmiotu krajowego.

Oto, jak zmieniły się żądania i zasoby.

Żądania

Nowa domena	Nazwa metody Content API	Nazwa metody interfejsu API sprzedawcy
accounts.omnichannelSettings	liasettings.custombatch	Ta metoda zostanie wycofana. Interfejs Merchant API umożliwia wysyłanie wielu żądań jednocześnie.
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	Metoda umożliwiająca bezpośrednie pobieranie wszystkich ustawień LIA na wszystkich subkontach nie jest już dostępna. Zamiast tego przeprowadź zapytanie do wszystkich subkont i użyj opcji accounts.omnichannelSettings.list, aby uzyskać ustawienia omnichannel dotyczące tych, które Cię interesują.
	liasettings.update	accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
	liasettings.requestinventoryverification	accounts.omnichannelSettings.requestInventoryVerification
	liasettings.setinventoryverificationcontact	Ta metoda zostanie wycofana. Zamiast tego użyj tagu accounts.omnichannelSettings.create lub accounts.omnichannelSettings.update z aktualizowaną maską.
	liasettings.setomnichannelexperience	Ta metoda zostanie wycofana. Zamiast tego użyj tagu accounts.omnichannelSettings.create lub accounts.omnichannelSettings.update z aktualizowaną maską.
accounts.omnichannelSettings.lfpProvider	liasettings.listposdataproviders	accounts.omnichannelSettings.lfpProviders.findLfpProviders
	liasettings.setposdataprovider	accounts.omnichannelSettings.lfpProviders.linkLfpProvider
accounts.gbpAccount	liasettings.getaccessiblegmbaccounts	accounts.gbpAccount.list
	liasettings.requestgmbaccess	accounts.gbpAccount.linkGbpAccount

Zasoby

• OmnichannelSetting
  • LsfType
  • InStock
  • Odbiór
  • LfpLink
  • OnDisplayToOrder
  • Informacje
  • InventoryVerification
• LfpProvider
• GbpAccount

Dodatkowo usługa działa inaczej w przypadku typu odbioru. Zobacz sekcję Odbiór.

OmnichannelSetting

Shopping Content API		Merchant API
Pole	Typ	Pole	Typ	Opis
(nie dotyczy)	(nie dotyczy)	name	string	Nazwa zasobu tego ustawienia omnichannel. Format: Format: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country	string	regionCode	string	Wymagane. Kod kraju w standardowym repozytorium danych (CLDR) (np. „US”)
hostedLocalStorefrontActive	boolean	lsfType	enum (LsfType)	Wymagane. Typ lokalnej witryny sklepowej (LSF) dla tego regionCode. Możliwe wartości: GHLSF (lokalna witryna sklepowa na serwerze Google) MHLSF_BASIC (lokalna witryna sklepowa sprzedawcy w ramach podstawowej implementacji, która odnosi się do stron produktów z informacjami o dostępności w sklepie) MHLSF_FULL (lokalna witryna sklepowa sprzedawcy w ramach pełnej implementacji, która odnosi się do stron produktów z dostępnością w sklepie)
(nie dotyczy)	(nie dotyczy)	inStock	object (InStock)	Identyfikator URI strony produktu dostępnego w magazynie (uniwersalny identyfikator zasobu) oraz stan wyświetlania dla tego regionCode. W interfejsie API do tworzenia ustaw co najmniej jeden z obiektów inStock lub pickup, jeśli wybierzesz jeden z typów MHLSF, ale tylko wtedy, gdy lsfType ma wartość GHLSF.inStock
storePickupActive	boolean	pickup	object (Pickup)	Identyfikator URI strony produktu z odbiorem i stan wyświetlaniaregionCode. Jeśli wybierzesz jeden z typów MHLSF, ustaw w interfejsie API do tworzenia co najmniej jeden obiekt inStock lub Pickup, ale nie rób tego, gdy jako lsfType ustawisz obiekt GHLSF.
posDataProvider	object (LiaPosDataProvider)	lfpLink	object (LfpLink)	Tylko dane wyjściowe. Ustanowione połączenie z dostawcą LFP
onDisplayToOrder	object (LiaOnDisplayToOrderSettings)	odo	object (OnDisplayToOrder)	URI zasady „dostępny na zamówienie” (ODO) i jej stanregionCode
about	object (LiaAboutPageSettings)	about	object (About)	Identyfikator URI strony z informacjami i jej stan w przypadku regionCode
inventory	object (LiaInventorySettings)	inventoryVerification	object (InventoryVerification)	Stan procesu weryfikacji asortymentu i informacje kontaktowe dotyczące tego regionCode
omnichannelExperience	object (LiaOmnichannelExperience)	(nie dotyczy)	(nie dotyczy)	Użyj właściwości lsfType i pickup (powyżej).

LsfType

Shopping Content API		Merchant API
Pole	Typ	Pole	Typ	Opis
lsfType	string	lsfType	enum (LsfType)	Typ lokalnej witryny sklepowej (LSF). Możliwe wartości: GHLSF (lokalna witryna sklepowa na serwerze Google) MHLSF_BASIC (lokalna witryna sklepowa sprzedawcy w ramach podstawowej implementacji) MHLSF_FULL (lokalna witryna sklepowa hostowana przez sprzedawcę w ramach pełnej implementacji)

InStock (na stanie)

Shopping Content API		Merchant API
Pole	Typ	Pole	Typ	Opis
(nie dotyczy)	(nie dotyczy)	uri	string	Adres URI strony docelowej produktu. Wymagane, jeśli wybierzesz jeden z typów MHLSF. Wymagany, jeśli obiekt jest ustawiony. W przypadku atrybutu GHLSF musi być pusty, a w przypadku atrybutu MHLSF nie może być pusty. Usługa używa go tylko do sprawdzania dostępności produktów na stanie. Domena identyfikatora URI powinna być zgodna z domeną strony głównej sprzedawcy.
(nie dotyczy)	(nie dotyczy)	state	enum (ReviewState.State)	Tylko dane wyjściowe. Stan wyświetlania reklam z produktami dostępnymi w magazynie. Dostępne wartości: ACTIVE FAILED RUNNING ACTION_REQUIRED

Aby sprawdzić wersję treści w Zakupach Google, zapoznaj się z LiaCountrySettings i LiaOmnichannelExperience.

Odbiór

Shopping Content API		Merchant API
Pole	Typ	Pole	Typ	Opis
(nie dotyczy)	(nie dotyczy)	uri	string	URI strony produktu z odbiorem. Wymagany, jeśli obiekt jest ustawiony. Interfejs API używa go tylko do sprawdzania obsługi odbioru. Domena identyfikatora URI powinna być zgodna ze stroną główną sprzedawcy.
LiaInventorySettings.status	string	state	enum (ReviewState.State)	Tylko dane wyjściowe. Stan odbioru. Dostępne wartości: ACTIVE FAILED RUNNING

Aby sprawdzić wersję treści w Zakupach Google, zobacz LiaCountrySettings i LiaOmnichannelExperience.

LfpLink

Shopping Content API		Merchant API
Pole	Typ	Pole	Typ	Opis
posDataProviderId	string	lfpProvider	string	Wymagane. Nazwa zasobu dostawcy LFP
posExternalAccountId	string	externalAccountId	string	Wymagane. Identyfikator konta, pod którym sprzedawca jest znany dostawcy usługi LFP
(nie dotyczy)	(nie dotyczy)	state	enum (ReviewState.State)	Tylko dane wyjściowe. Stan LfpLink. Dostępne wartości: ACTIVE RUNNING

Aby sprawdzić wersję treści w Zakupach Google, zapoznaj się z artykułem LiaPosDataProvider.

OnDisplayToOrder

Shopping Content API		Merchant API
Pole	Typ	Pole	Typ	Opis
shippingCostPolicyUrl	string	uri	string	Wymagane. Adres URI zasady „dostępny na zamówienie”.
status	string	state	enum (ReviewState.State)	Tylko dane wyjściowe. Stan identyfikatora URI. Możliwe wartości: ACTIVE FAILED RUNNING

Aby sprawdzić wersję dla Zakupów Google, zobacz LiaOnDisplayToOrderSettings.

Informacje

Shopping Content API		Merchant API
Pole	Typ	Pole	Typ	Opis
url	string	uri	string	Wymagane. Identyfikator URI strony z informacjami
status	string	state	enum (ReviewState.State)	Tylko dane wyjściowe. Stan identyfikatora URI. Możliwe wartości: ACTIVE FAILED RUNNING

Aby sprawdzić wersję treści w Zakupach Google, otwórz stronę LiaAboutPageSettings.

InventoryVerification

Shopping Content API		Merchant API
Pole	Typ	Pole	Typ	Opis
status	string	state	enum (InventoryVerification.State)	Tylko dane wyjściowe. Stan procesu weryfikacji asortymentu. Możliwe wartości: ACTION_REQUIRED INACTIVE RUNNING SUCCEEDED SUSPENDED
inventoryVerificationContactName	string	contact	string	Wymagane. Nazwa osoby kontaktowej ds. weryfikacji asortymentu
inventoryVerificationContactEmail	string	contactEmail	string	Wymagane. adres e-mail osoby kontaktowej ds. weryfikacji asortymentu,
inventoryVerificationContactStatus	string	contactState	enum (ReviewState.State)	Tylko dane wyjściowe. Stan weryfikacji osoby kontaktowej. Możliwe wartości: ACTIVE RUNNING

Aby sprawdzić wersję treści w Zakupach Google, zapoznaj się z LiaCountrySettings i LiaInventorySettings.

LfpProvider

Shopping Content API		Merchant API
Pole	Typ	Pole	Typ	Opis
fullName	string	name	string	Nazwa zasobu dostawcy LFP. Format: accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}
(nie dotyczy)	(nie dotyczy)	regionCode	string	Wymagane. Kod kraju CLDR
providerId	string	(nie dotyczy)	(nie dotyczy)	To pole zostanie usunięte.
displayName	string	displayName	string	Wyświetlana nazwa dostawcy LFP

Aby sprawdzić wersję treści w Zakupach Google, zobacz PosDataProvidersPosDataProvider.

GbpAccount

Shopping Content API		Merchant API
Field	Type	Pole	Typ	Opis
name	string	name	string	Nazwa zasobu konta Google Business Profile Format:accounts/{account}/gbpAccount/{gbp_account}
(nie dotyczy)	(nie dotyczy)	gbpAccountId	string	Identyfikator profilu firmy
type	string	type	enum (GbpAccount.Type)	Typ profilu firmy. Dostępne wartości: USER (konto osobiste) BUSINESS_ACCOUNT (konto firmowe)
email	string	gbpAccountName	string	Nazwa profilu firmy: W przypadku kont osobistych jest to adres e-mail właściciela. W przypadku kont firmowych jest to nazwa konta firmowego.
listingCount	string	listingCount	int64	Liczba wizytówek powiązanych z tym kontem

Aby sprawdzić wersję treści w Zakupach Google, otwórz GmbAccountsGmbAccount.