Cómo migrar la configuración de los anuncios del inventario local (LIA)

Si usaste la configuración de anuncios del inventario local en la Content API para Shopping, hay varios cambios importantes en la API de Merchant.

La configuración de los LIA ahora pertenece a uno de los tres componentes principales, cada uno con un recurso asociado.

Componente principal	Recurso
Configuración de la cuenta para la publicación de anuncios en varios canales	OmnichannelSetting
Conexión con el socio del Programa de socios de feeds locales (LFP) para obtener datos de inventario	LfpProvider
Conexión a la cuenta del Perfil de Negocio de Google (GBP) para obtener datos de las tiendas locales	GbpAccount

Además, con la configuración de LIA, había un solo recurso por cuenta y contenía una lista de parámetros de configuración para cada entidad nacional. Con OmnichannelSettings, puedes asociar varios recursos a una cuenta. Cada recurso representa la configuración de una entidad nacional en particular.

Aquí se muestra cómo cambiaron las solicitudes y los recursos.

Solicitudes

Dominio nuevo	Nombre del método de la Content API	Nombre del método de la API de Merchant
accounts.omnichannelSettings	liasettings.custombatch	Este método desaparece. La API de Merchant admite la capacidad de enviar varias solicitudes a la vez.
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	Ya no está disponible directamente un método para obtener todos los parámetros de configuración de LIA para todas las cuentas secundarias. En su lugar, consulta todas las cuentas secundarias y usa accounts.omnichannelSettings.list para obtener la configuración de varios canales de las que te interesen.
	liasettings.update	accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
	liasettings.requestinventoryverification	accounts.omnichannelSettings.requestInventoryVerification
	liasettings.setinventoryverificationcontact	Este método desaparece. En su lugar, usa accounts.omnichannelSettings.create o accounts.omnichannelSettings.update con una máscara actualizada.
	liasettings.setomnichannelexperience	Este método desaparece. En su lugar, usa accounts.omnichannelSettings.create o accounts.omnichannelSettings.update con una máscara actualizada.
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

Recursos

• OmnichannelSetting
  • LsfType
  • InStock
  • Retiro
  • LfpLink
  • OnDisplayToOrder
  • Información
  • InventoryVerification
• LfpProvider
• GbpAccount

Además, el servicio se comporta de manera diferente para PickupType. Consulta Retiro.

OmnichannelSetting

API de contenido de Shopping		API de Merchant
Campo	Tipo	Campo	Tipo	Descripción
(n/c)	(n/c)	name	string	Es el nombre del recurso de este parámetro de configuración de varios canales. Formato: Formato: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country	string	regionCode	string	Obligatorio. Código de país del repositorio de datos de configuración regional común (CLDR) (por ejemplo, "US")
hostedLocalStorefrontActive	boolean	lsfType	enum (LsfType)	Obligatorio. Es el tipo de vidriera local (LSF) para este regionCode. Entre los valores posibles, se incluyen los siguientes: GHLSF (tienda local alojada en Google) MHLSF_BASIC (tienda local alojada por el comerciante básica, que hace referencia a las páginas de productos con información de disponibilidad en tienda) MHLSF_FULL (vidriera local alojada por el comerciante completa, que hace referencia a las páginas de productos con información de disponibilidad en tienda)
(n/c)	(n/c)	inStock	object (InStock)	Es el URI (identificador de recursos universal) de la página del producto en stock y el estado de publicación de este regionCode. Establece al menos uno de los objetos inStock o pickup en la API de creación si elegiste uno de los tipos MHLSF, pero solo establece inStock si el lsfType es GHLSF.
storePickupActive	boolean	pickup	object (Pickup)	Es el URI de la página del producto con retiro y el estado de publicación de este regionCode. Establece al menos uno de los objetos inStock o Pickup en la API de creación si elegiste uno de los tipos MHLSF, pero no lo establezcas cuando GHLSF se establezca como lsfType.
posDataProvider	object (LiaPosDataProvider)	lfpLink	object (LfpLink)	Solo salida. El vínculo establecido con un proveedor de LFP
onDisplayToOrder	object (LiaOnDisplayToOrderSettings)	odo	object (OnDisplayToOrder)	El URI y el estado de la política de "en exhibición para pedido" (ODO) de este regionCode
about	object (LiaAboutPageSettings)	about	object (About)	El URI y el estado de la página de información de este regionCode
inventory	object (LiaInventorySettings)	inventoryVerification	object (InventoryVerification)	El estado del proceso de verificación del inventario y la información de contacto de este regionCode
omnichannelExperience	object (LiaOmnichannelExperience)	(n/c)	(n/c)	Usa lsfType y pickup (arriba).

LsfType

API de contenido de Shopping		API de Merchant
Campo	Tipo	Campo	Tipo	Descripción
lsfType	string	lsfType	enum (LsfType)	Es el tipo de vidriera local (LSF). Estos son los posibles valores: GHLSF (vidriera local alojada en Google) MHLSF_BASIC (Vidriera local alojada por el comercio, básica) MHLSF_FULL (Vidriera local alojada por el comercio, completa)

InStock

API de Content para Shopping		API de Merchant
Campo	Tipo	Campo	Tipo	Descripción
(n/c)	(n/c)	uri	string	Es el URI de la página de destino del producto. Obligatorio si elegiste uno de los tipos de MHLSF. Es obligatorio si se configura el objeto. Para GHLSF, debe estar vacío, pero para MHLSF, no debe estar vacío. El servicio lo usa solo para revisar la publicación de anuncios de productos en stock. Este dominio de URI debe coincidir con la página principal del comercio.
(n/c)	(n/c)	state	enum (ReviewState.State)	Solo salida. Es el estado de la publicación de anuncios de productos en stock. Los valores disponibles son ACTIVE FAILED RUNNING ACTION_REQUIRED

Para revisar la versión de contenido de compras, consulta LiaCountrySettings y LiaOmnichannelExperience.

Retiro

API de contenido de Shopping		API de Merchant
Campo	Tipo	Campo	Tipo	Descripción
(n/c)	(n/c)	uri	string	Es el URI de la página del producto con retiro. Es obligatorio si se configura el objeto. La API solo lo usa para revisar el servicio de retiro. Este dominio de URI debe coincidir con la página principal del comercio.
LiaInventorySettings.status	string	state	enum (ReviewState.State)	Solo salida. Es el estado de la publicación del retiro. Los valores disponibles son ACTIVE FAILED RUNNING

Para revisar la versión de contenido de compras, consulta LiaCountrySettings y LiaOmnichannelExperience.

LfpLink

API de contenido de Shopping		API de Merchant
Campo	Tipo	Campo	Tipo	Descripción
posDataProviderId	string	lfpProvider	string	Obligatorio. Es el nombre del recurso del proveedor de LFP.
posExternalAccountId	string	externalAccountId	string	Obligatorio. Es el ID de cuenta con el que el proveedor de LFP conoce a este comercio.
(n/c)	(n/c)	state	enum (ReviewState.State)	Solo salida. Es el estado del LfpLink. Los valores disponibles son ACTIVE RUNNING

Para revisar la versión de contenido de compras, consulta LiaPosDataProvider.

OnDisplayToOrder

API de contenido de Shopping		API de Merchant
Campo	Tipo	Campo	Tipo	Descripción
shippingCostPolicyUrl	string	uri	string	Obligatorio. Es el URI de la política de "en exhibición para pedido" (ODO).
status	string	state	enum (ReviewState.State)	Solo salida. Es el estado del URI. Los valores posibles son ACTIVE FAILED RUNNING

Para revisar la versión de contenido de compras, consulta LiaOnDisplayToOrderSettings.

Acerca de

API de Content para Shopping		API de Merchant
Campo	Tipo	Campo	Tipo	Descripción
url	string	uri	string	Obligatorio. El URI de la página de información
status	string	state	enum (ReviewState.State)	Solo salida. Es el estado del URI. Los valores posibles son ACTIVE FAILED RUNNING

Para revisar la versión de contenido de compras, consulta LiaAboutPageSettings.

InventoryVerification

API de contenido de Shopping		API de Merchant
Campo	Tipo	Campo	Tipo	Descripción
status	string	state	enum (InventoryVerification.State)	Solo salida. Es el estado del proceso de verificación del inventario. Los valores posibles son ACTION_REQUIRED INACTIVE RUNNING SUCCEEDED SUSPENDED
inventoryVerificationContactName	string	contact	string	Obligatorio. Es el nombre del contacto para el proceso de verificación del inventario.
inventoryVerificationContactEmail	string	contactEmail	string	Obligatorio. Es el correo electrónico del contacto para el proceso de verificación del inventario.
inventoryVerificationContactStatus	string	contactState	enum (ReviewState.State)	Solo salida. Es el estado de la verificación del contacto. Los valores posibles son ACTIVE RUNNING

Para revisar la versión de contenido de compras, consulta LiaCountrySettings y LiaInventorySettings.

LfpProvider

API de contenido de Shopping		API de Merchant
Campo	Tipo	Campo	Tipo	Descripción
fullName	string	name	string	Es el nombre del recurso del proveedor de LFP. Formato: accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}
(n/c)	(n/c)	regionCode	string	Obligatorio. Código de país CLDR
providerId	string	(n/c)	(n/c)	Este campo desaparece.
displayName	string	displayName	string	El nombre visible del proveedor de LFP

Para revisar la versión de contenido de compras, consulta PosDataProvidersPosDataProvider.

GbpAccount

Shopping Content API		API de Merchant
Field	Type	Campo	Tipo	Descripción
name	string	name	string	Es el nombre del recurso de la cuenta del Perfil de Negocio de Google. Formato: accounts/{account}/gbpAccount/{gbp_account}
(n/c)	(n/c)	gbpAccountId	string	El ID del Perfil de Negocio
type	string	type	enum (GbpAccount.Type)	Es el tipo de perfil de negocio. Los valores disponibles son USER (cuenta personal) BUSINESS_ACCOUNT (cuenta de empresa)
email	string	gbpAccountName	string	El nombre del Perfil de Negocio: En el caso de las cuentas personales, este es el ID de correo electrónico del propietario. En el caso de las cuentas comerciales, este es el nombre de la cuenta comercial.
listingCount	string	listingCount	int64	Cantidad de fichas asociadas a esta cuenta

Para revisar la versión de contenido de compras, consulta GmbAccountsGmbAccount.