Esegui la migrazione delle impostazioni degli annunci di inventario locale (LIA)

Se hai utilizzato le impostazioni degli annunci di inventario locale nell'API Content for Shopping, tieni presente che l'API Merchant presenta diverse modifiche importanti.

Le impostazioni LIA ora appartengono a uno dei tre componenti principali, ognuno con una risorsa associata.

Componente principale	Risorsa
Configurazione dell'account per la pubblicazione omnicanale	OmnichannelSetting
Collegamento al partner del programma di partnership per i feed locali (LFP) per i dati di inventario	LfpProvider
Collegamento all'account Profilo dell'attività su Google per i dati dei negozi locali	GbpAccount

Inoltre, con le impostazioni LIA, esisteva una singola risorsa per account che conteneva un elenco di impostazioni per ogni entità nazionale. Con OmnichannelSettings puoi associare più risorse a un account. Ogni risorsa rappresenta le impostazioni di una determinata entità nazionale.

Ecco come sono cambiate le richieste e le risorse.

Richieste

Nuovo dominio	Nome del metodo API Content	Nome del metodo dell'API Merchant
accounts.omnichannelSettings	liasettings.custombatch	Questo metodo non sarà più disponibile. L'API Merchant supporta la possibilità di inviare più richieste contemporaneamente.
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	Un metodo per ottenere tutte le impostazioni LIA per tutti i sub-account non è più disponibile direttamente. Esegui invece una query su tutti i subaccount e utilizza accounts.omnichannelSettings.list per ottenere le impostazioni omnichannelSettings per quelli di interesse.
	liasettings.update	accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
	liasettings.requestinventoryverification	accounts.omnichannelSettings.requestInventoryVerification
	liasettings.setinventoryverificationcontact	Questo metodo non sarà più disponibile. Utilizza invece accounts.omnichannelSettings.create o accounts.omnichannelSettings.update con una maschera aggiornata.
	liasettings.setomnichannelexperience	Questo metodo non sarà più disponibile. Utilizza invece accounts.omnichannelSettings.create o accounts.omnichannelSettings.update con una maschera aggiornata.
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

Risorse

• OmnichannelSetting
  • LsfType
  • InStock
  • Ritiro
  • LfpLink
  • OnDisplayToOrder
  • Informazioni
  • InventoryVerification
• LfpProvider
• GbpAccount

Inoltre, il servizio si comporta in modo diverso per PickupType. Consulta Ritiro.

OmnichannelSetting

API Content per lo shopping		API Merchant
Campo	Tipo	Campo	Tipo	Descrizione
(n/a)	(n/a)	name	string	Il nome della risorsa di questa impostazione omnicanale. Formato: Formato: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country	string	regionCode	string	Obbligatorio. Common Locale Data Repository (CLDR): codice paese (ad esempio "US")
hostedLocalStorefrontActive	boolean	lsfType	enum (LsfType)	Obbligatorio. Il tipo di vetrina locale (LSF) per questo regionCode. I valori possibili includono: GHLSF (Vetrina locale su Google) MHLSF_BASIC (vetrina locale ospitata dal commerciante (implementazione di base), che si riferisce alle pagine di prodotto con disponibilità in negozio) MHLSF_FULL (vetrina locale ospitata dal commerciante - implementazione completa, che si riferisce alle pagine di prodotto con disponibilità in negozio)
(n/a)	(n/a)	inStock	object (InStock)	L'URI (Universal Resource Identifier) della pagina di prodotto disponibile e lo stato di pubblicazione di questo regionCode. Imposta almeno uno degli oggetti inStock o pickup nell'API di creazione se hai scelto uno dei tipi MHLSF, ma imposta solo inStock se lsfType è GHLSF.
storePickupActive	boolean	pickup	object (Pickup)	L'URI della pagina di prodotto per il ritiro e lo stato di pubblicazione di questo regionCode. Imposta almeno uno degli oggetti inStock o Pickup nell'API di creazione se hai scelto uno dei tipi MHLSF, ma non impostarlo quando GHLSF è impostato come lsfType.
posDataProvider	object (LiaPosDataProvider)	lfpLink	object (LfpLink)	Solo output. Il link stabilito con un fornitore LFP
onDisplayToOrder	object (LiaOnDisplayToOrderSettings)	odo	object (OnDisplayToOrder)	L'URI e lo stato delle norme "In esposizione, può essere ordinato" (ODO) per questo regionCode
about	object (LiaAboutPageSettings)	about	object (About)	L'URI e lo stato della pagina Informazioni su questo regionCode
inventory	object (LiaInventorySettings)	inventoryVerification	object (InventoryVerification)	Lo stato della procedura di verifica dell'inventario e i dati di contatto per questo regionCode
omnichannelExperience	object (LiaOmnichannelExperience)	(n/a)	(n/a)	Utilizza lsfType e pickup (sopra).

LsfType

API Content per lo shopping		API Merchant
Campo	Tipo	Campo	Tipo	Descrizione
lsfType	string	lsfType	enum (LsfType)	Il tipo di vetrina locale. I valori possibili sono: GHLSF (Vetrina locale ospitata da Google) MHLSF_BASIC (Vetrina locale ospitata dal commerciante, implementazione di base) MHLSF_FULL (Vetrina locale ospitata dal commerciante - implementazione completa)

InStock

API Content per lo shopping		API Merchant
Campo	Tipo	Campo	Tipo	Descrizione
(n/a)	(n/a)	uri	string	URI della pagina di destinazione del prodotto. Obbligatorio se hai scelto uno dei tipi MHLSF. Obbligatorio se l'oggetto è impostato. Per GHLSF, deve essere vuoto, ma per MHLSF non deve essere vuoto. Il servizio lo utilizza solo per esaminare la pubblicazione dei prodotti disponibili. Il dominio di questo URI deve corrispondere alla home page del commerciante.
(n/a)	(n/a)	state	enum (ReviewState.State)	Solo output. Lo stato della pubblicazione degli articoli disponibili. I valori disponibili sono ACTIVE FAILED RUNNING ACTION_REQUIRED

Per esaminare la versione dei contenuti per lo shopping, consulta LiaCountrySettings e LiaOmnichannelExperience.

Ritiro

API Content per lo shopping		API Merchant
Campo	Tipo	Campo	Tipo	Descrizione
(n/a)	(n/a)	uri	string	URI della pagina di prodotto per il ritiro. Obbligatorio se l'oggetto è impostato. L'API lo utilizza solo per esaminare la pubblicazione del ritiro. Il dominio di questo URI deve corrispondere alla home page del commerciante.
LiaInventorySettings.status	string	state	enum (ReviewState.State)	Solo output. Lo stato della pubblicazione del ritiro. I valori disponibili sono ACTIVE FAILED RUNNING

Per esaminare la versione dei contenuti per lo shopping, consulta LiaCountrySettings e LiaOmnichannelExperience.

LfpLink

API Content per lo shopping		API Merchant
Campo	Tipo	Campo	Tipo	Descrizione
posDataProviderId	string	lfpProvider	string	Obbligatorio. Il nome della risorsa del fornitore LFP
posExternalAccountId	string	externalAccountId	string	Obbligatorio. L'ID account con cui questo commerciante è noto al fornitore LFP
(n/a)	(n/a)	state	enum (ReviewState.State)	Solo output. Lo stato di LfpLink. I valori disponibili sono ACTIVE RUNNING

Per esaminare la versione dei contenuti per lo shopping, consulta LiaPosDataProvider.

OnDisplayToOrder

API Content per lo shopping		API Merchant
Campo	Tipo	Campo	Tipo	Descrizione
shippingCostPolicyUrl	string	uri	string	Obbligatorio. L'URI delle norme relative alla funzionalità "In esposizione, può essere ordinato".
status	string	state	enum (ReviewState.State)	Solo output. Lo stato dell'URI. I valori possibili sono ACTIVE FAILED RUNNING

Per esaminare la versione dei contenuti per lo shopping, consulta LiaOnDisplayToOrderSettings.

Informazioni

API Content per lo shopping		API Merchant
Campo	Tipo	Campo	Tipo	Descrizione
url	string	uri	string	Obbligatorio. L'URI della pagina Informazioni
status	string	state	enum (ReviewState.State)	Solo output. Lo stato dell'URI. I valori possibili sono: ACTIVE FAILED RUNNING

Per esaminare la versione di contenuti per lo shopping, consulta LiaAboutPageSettings.

InventoryVerification

API Content per lo shopping		API Merchant
Campo	Tipo	Campo	Tipo	Descrizione
status	string	state	enum (InventoryVerification.State)	Solo output. Lo stato della procedura di verifica dell'inventario. I valori possibili sono ACTION_REQUIRED INACTIVE RUNNING SUCCEEDED SUSPENDED
inventoryVerificationContactName	string	contact	string	Obbligatorio. Il nome del contatto per la procedura di verifica dell'inventario
inventoryVerificationContactEmail	string	contactEmail	string	Obbligatorio. L'indirizzo email del contatto per la procedura di verifica dell'inventario
inventoryVerificationContactStatus	string	contactState	enum (ReviewState.State)	Solo output. Lo stato della verifica del contatto. I valori possibili sono ACTIVE RUNNING

Per esaminare la versione dei contenuti per lo shopping, consulta LiaCountrySettings e LiaInventorySettings.

LfpProvider

API Content per lo shopping		API Merchant
Campo	Tipo	Campo	Tipo	Descrizione
fullName	string	name	string	Il nome della risorsa del fornitore LFP. Formato: accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}
(n/a)	(n/a)	regionCode	string	Obbligatorio. Codice paese CLDR
providerId	string	(n/a)	(n/a)	Questo campo non sarà più disponibile.
displayName	string	displayName	string	Il nome visualizzato del fornitore LFP

Per esaminare la versione dei contenuti per lo shopping, consulta PosDataProvidersPosDataProvider.

GbpAccount

Shopping Content API		API Merchant
Field	Type	Campo	Tipo	Descrizione
name	string	name	string	Il nome risorsa dell'account Profilo dell'attività Formato: accounts/{account}/gbpAccount/{gbp_account}
(n/a)	(n/a)	gbpAccountId	string	L'ID del profilo dell'attività
type	string	type	enum (GbpAccount.Type)	Il tipo di profilo dell'attività. I valori disponibili sono USER (account personale) BUSINESS_ACCOUNT (account aziendale)
email	string	gbpAccountName	string	Il nome del profilo dell'attività: Per gli account personali, si tratta dell'ID email del proprietario. Per gli account aziendali, si tratta del nome dell'account aziendale.
listingCount	string	listingCount	int64	Numero di schede associate a questo account

Per esaminare la versione dei contenuti per lo shopping, consulta GmbAccountsGmbAccount.