Migracja ustawień reklam lokalnego asortymentu produktów

Jeśli w sekcji Ustawienia reklam lokalnego asortymentu produktów w Content API usługi Zakupy Google korzystasz z interfejsu Merchant API, musisz pamiętać o kilku ważnych zmianach.

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

Komponent podstawowy	Zasób
Konfiguracja konta na potrzeby wyświetlania w Omnichannel	OmnichannelSetting
Połączenie z partnerem programu partnerskiego plików danych o produktach dostępnych lokalnie w celu uzyskania danych o asortymencie	LfpProvider
Połączenie z kontem Profilu Firmy w Google na potrzeby danych o sklepach lokalnych	GbpAccount

Dodatkowo w przypadku ustawień LIA na koncie był tylko 1 zasób, który zawierał 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 konkretnego 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 pobierania wszystkich ustawień lokalnych reklam w asortymencie produktów dla wszystkich subkont nie jest już bezpośrednio dostępna. Zamiast tego wysyłaj zapytania do wszystkich subkont i używaj parametru accounts.omnichannelSettings.list, aby uzyskać ustawienia wielokanałowe dla interesujących Cię kont.
	liasettings.update	accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
	liasettings.requestinventoryverification	accounts.omnichannelSettings.requestInventoryVerification
	liasettings.setinventoryverificationcontact	Ta metoda zostanie wycofana. Zamiast tego użyj accounts.omnichannelSettings.create lub accounts.omnichannelSettings.update ze zaktualizowaną maską.
	liasettings.setomnichannelexperience	Ta metoda zostanie wycofana. Zamiast tego użyj accounts.omnichannelSettings.create lub accounts.omnichannelSettings.update ze zaktualizowaną 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 PickupType. Zobacz sekcję Odbiór.

OmnichannelSetting

Shopping Content API		Interfejs API sprzedawcy
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 ze standardowego repozytorium danych (Common Locale Data Repository, CLDR) (np. „US”).
hostedLocalStorefrontActive	boolean	lsfType	enum (LsfType)	Wymagane. Typ Lokalna witryna sklepowa (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 danymi 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 danymi o dostępności w sklepie)
(nie dotyczy)	(nie dotyczy)	inStock	object (InStock)	Identyfikator URI (Universal Resource Identifier) strony produktu w magazynie i stan wyświetlania tego regionCode. W interfejsie API do tworzenia ustaw co najmniej 1 obiekt inStock lub pickup, jeśli wybrano jeden z typów MHLSF, ale ustaw tylko inStock, jeśli lsfType ma wartość GHLSF.
storePickupActive	boolean	pickup	object (Pickup)	Identyfikator URI strony produktu z opcją odbioru i stan wyświetlania tego regionCode. Ustaw co najmniej 1 obiekt inStock lub Pickup w interfejsie API do tworzenia, jeśli wybrano jeden z typów MHLSF, ale nie ustawiaj go, gdy GHLSF jest ustawiony jako lsfType.
posDataProvider	object (LiaPosDataProvider)	lfpLink	object (LfpLink)	Tylko dane wyjściowe. utworzone połączenie z dostawcą LFP;
onDisplayToOrder	object (LiaOnDisplayToOrderSettings)	odo	object (OnDisplayToOrder)	Adres URI zasad „dostępny na zamówienie” i stan dla tego produktu:regionCode
about	object (LiaAboutPageSettings)	about	object (About)	Identyfikator URI strony z informacjami i stan tego 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		Interfejs API sprzedawcy
Pole	Typ	Pole	Typ	Opis
lsfType	string	lsfType	enum (LsfType)	Typ lokalnej witryny sklepowej. 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 sprzedawcy w ramach pełnej implementacji)

InStock (na stanie)

Shopping Content API		Interfejs API sprzedawcy
Pole	Typ	Pole	Typ	Opis
(nie dotyczy)	(nie dotyczy)	uri	string	Identyfikator URI strony docelowej produktu. Wymagane, jeśli wybierzesz jeden z typów MHLSF. Wymagane, jeśli obiekt jest ustawiony. W przypadku atrybutu GHLSF musi być pusty, a w przypadku atrybutu MHLSF – niepusty. Usługa używa go tylko do sprawdzania wyświetlania produktów dostępnych w magazynie. Domena tego identyfikatora URI powinna być zgodna ze stroną główną sprzedawcy.
(nie dotyczy)	(nie dotyczy)	state	enum (ReviewState.State)	Tylko dane wyjściowe. Stan wyświetlania produktów dostępnych w magazynie. Dostępne wartości: ACTIVE FAILED RUNNING ACTION_REQUIRED

Aby sprawdzić wersję treści o zakupach, zobacz LiaCountrySettings i LiaOmnichannelExperience.

Odbiór

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

Aby sprawdzić wersję treści o zakupach, zobacz LiaCountrySettings i LiaOmnichannelExperience.

LfpLink

Shopping Content API		Interfejs API sprzedawcy
Pole	Typ	Pole	Typ	Opis
posDataProviderId	string	lfpProvider	string	Wymagane. Nazwa zasobu dostawcy LFP
posExternalAccountId	string	externalAccountId	string	Wymagane. Identyfikator konta, pod którym ten sprzedawca jest znany dostawcy platformy 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, zobacz LiaPosDataProvider.

OnDisplayToOrder

Shopping Content API		Interfejs API sprzedawcy
Pole	Typ	Pole	Typ	Opis
shippingCostPolicyUrl	string	uri	string	Wymagane. Adres URI zasad „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ę treści w Zakupach Google, zobacz LiaOnDisplayToOrderSettings.

Informacje

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

Aby sprawdzić wersję dotyczącą treści w Zakupach Google, zobacz LiaAboutPageSettings.

InventoryVerification

Shopping Content API		Interfejs API sprzedawcy
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. Imię i nazwisko 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 kontaktu. Możliwe wartości: ACTIVE RUNNING

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

LfpProvider

Shopping Content API		Interfejs API sprzedawcy
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 wycofane.
displayName	string	displayName	string	Wyświetlana nazwa dostawcy LFP

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

GbpAccount

Shopping Content API		Interfejs API sprzedawcy
Field	Type	Pole	Typ	Opis
name	string	name	string	Nazwa zasobu konta GBP. 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 identyfikator 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, zobacz GmbAccountsGmbAccount.