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, ci sono diverse modifiche importanti con l'API Merchant.

Le impostazioni degli annunci di inventario locale ora appartengono a uno dei tre componenti principali, ognuno dei quali ha una risorsa associata.

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

Inoltre, con le impostazioni degli annunci di inventario locale era presente una singola risorsa per account e conteneva un elenco di impostazioni per ogni entità nazionale. Con OmnichannelSettings puoi associare più risorse a un account. Ogni risorsa rappresenta le impostazioni per una determinata entità nazionale.

Ecco come sono cambiate le richieste e le risorse.

Richieste

Nuovo dominio	Nome del metodo API Content	Nome del metodo 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 degli annunci di inventario locale per tutti gli account secondari non è più disponibile direttamente. Esegui invece una query su tutti i subaccount e utilizza accounts.omnichannelSettings.list per ottenere 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
  • Pickup
  • LfpLink
  • OnDisplayToOrder
  • Informazioni
  • InventoryVerification
• LfpProvider
• GbpAccount

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

OmnichannelSetting

API Content di 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 esempio "US")
hostedLocalStorefrontActive	boolean	lsfType	enum (LsfType)	Obbligatorio. Il tipo Vetrina locale (LSF) per questo regionCode. I valori possibili includono GHLSF (vetrina locale su Google) MHLSF_BASIC (vetrina locale ospitata dal commerciante 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 di 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 di 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 su Google) MHLSF_BASIC (Vetrina locale ospitata dal commerciante, implementazione di base) MHLSF_FULL (Vetrina locale ospitata dal commerciante - implementazione completa)

InStock

API Content di 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 vuoto. Il servizio lo utilizza solo per esaminare la pubblicazione in stock. 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 in magazzino. I valori disponibili sono ACTIVE FAILED RUNNING ACTION_REQUIRED

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

Ritiro

API Content di 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 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 di Shopping		API Merchant
Campo	Tipo	Campo	Tipo	Descrizione
posDataProviderId	string	lfpProvider	string	Obbligatorio. Il nome della risorsa del fornitore di LFP
posExternalAccountId	string	externalAccountId	string	Obbligatorio. L'ID account con cui questo commerciante è noto al fornitore di 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 di Shopping, vedi LiaPosDataProvider.

OnDisplayToOrder

API Content di Shopping		API Merchant
Campo	Tipo	Campo	Tipo	Descrizione
shippingCostPolicyUrl	string	uri	string	Obbligatorio. L'URI della norma "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 di Shopping, consulta LiaOnDisplayToOrderSettings.

Informazioni

API Content di 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 di 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 di 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 di 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 email del proprietario. Per gli account aziendali, questo è il nome dell'account aziendale.
listingCount	string	listingCount	int64	Numero di schede associate a questo account

Per esaminare la versione di Shopping Content, vedi GmbAccountsGmbAccount.