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 ha subito diverse modifiche importanti.

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

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

Inoltre, con le impostazioni LIA era presente 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 dell'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	Non è più disponibile un metodo per recuperare direttamente tutte le impostazioni LIA per tutti gli account secondari. Esegui invece una query su tutti i subaccount e utilizza accounts.omnichannelSettings.list per recuperare omnichannelSettings per quelli di tuo 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
  • Pickup
  • LfpLink
  • OnDisplayToOrder
  • Informazioni
  • InventoryVerification
• LfpProvider
• GbpAccount

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

OmnichannelSetting

API Content for 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. Codice paese Common Locale Data Repository (CLDR) (ad es. "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 (Uniform Resource Identifier) della pagina del prodotto disponibile e lo stato di pubblicazione per questo regionCode. Imposta almeno uno degli oggetti inStock o pickup nell'API create se hai scelto uno dei tipi MHLSF, ma imposta inStock solo se lsfType è GHLSF.
storePickupActive	boolean	pickup	object (Pickup)	L'URI della pagina di prodotto per il ritiro e lo stato di pubblicazione per questo regionCode. Imposta almeno uno degli oggetti inStock o Pickup nell'API create se hai scelto uno dei tipi MHLSF, ma non impostarlo quando GHLSF è impostato come lsfType.
posDataProvider	object (LiaPosDataProvider)	lfpLink	object (LfpLink)	Solo output. Il collegamento stabilito a un fornitore LFP
onDisplayToOrder	object (LiaOnDisplayToOrderSettings)	odo	object (OnDisplayToOrder)	L'URI e lo stato del criterio "In esposizione, può essere ordinato" (ODO) per questo regionCode
about	object (LiaAboutPageSettings)	about	object (About)	L'URI e lo stato della pagina Informazioni per 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 for Shopping		API Merchant
Campo	Tipo	Campo	Tipo	Descrizione
lsfType	string	lsfType	enum (LsfType)	Il tipo di vetrina locale (LSF). I valori possibili sono: GHLSF (vetrina locale su Google) MHLSF_BASIC (vetrina locale ospitata dal commerciante, implementazione di base) MHLSF_FULL (Vetrina locale ospitata dal commerciante (implementazione completa))

InStock

API Content for 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 di prodotti disponibili. Il dominio dell'URI deve corrispondere alla home page del commerciante.
(n/a)	(n/a)	state	enum (ReviewState.State)	Solo output. Lo stato della pubblicazione in stock. I valori disponibili sono: ACTIVE FAILED RUNNING ACTION_REQUIRED

Per esaminare la versione dei contenuti di Shopping, consulta LiaCountrySettings e LiaOmnichannelExperience.

Pickup

API Content for 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 di annunci con ritiro. Il dominio dell'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 di Shopping, consulta LiaCountrySettings e LiaOmnichannelExperience.

LfpLink

API Content for Shopping		API Merchant
Campo	Tipo	Campo	Tipo	Descrizione
posDataProviderId	string	lfpProvider	string	Obbligatorio. Il nome della risorsa del provider 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 relativi agli acquisti, consulta LiaPosDataProvider.

OnDisplayToOrder

API Content for Shopping		API Merchant
Campo	Tipo	Campo	Tipo	Descrizione
shippingCostPolicyUrl	string	uri	string	Obbligatorio. L'URI delle norme relative ai prodotti in esposizione che possono essere ordinati (ODO).
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 di Shopping, consulta LiaOnDisplayToOrderSettings.

Informazioni

API Content for 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 dei contenuti di Shopping, consulta LiaAboutPageSettings.

InventoryVerification

API Content for 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 di Shopping, consulta LiaCountrySettings e LiaInventorySettings.

LfpProvider

API Content for Shopping		API Merchant
Campo	Tipo	Campo	Tipo	Descrizione
fullName	string	name	string	Il nome della risorsa del provider 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 provider LFP

Per esaminare la versione dei contenuti di Shopping, consulta PosDataProvidersPosDataProvider.

GbpAccount

Shopping Content API		API Merchant
Field	Type	Campo	Tipo	Descrizione
name	string	name	string	Il nome della risorsa dell'account GBP 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 indirizzo 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 di Shopping, consulta GmbAccountsGmbAccount.