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

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

La configuración de la 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 en varios canales	OmnichannelSetting
Conexión con el socio de Local Feed Partnership (LFP) para los datos de inventario	LfpProvider
Conexión a la cuenta de Perfil de Negocio de Google (GBP) para los 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.

A continuación, se muestra cómo cambiaron las solicitudes y los recursos.

Solicitudes

Dominio nuevo	Nombre del método de Content API	Nombre del método de la API del comercio
accounts.omnichannelSettings	liasettings.custombatch	Este método dejará de estar disponible. 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 la LIA para todas las cuentas secundarias. En su lugar, consulta todas las cuentas secundarias y usa accounts.omnichannelSettings.list para obtener el omnichannelSettings de las que te interesan.
	liasettings.update	accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
	liasettings.requestinventoryverification	accounts.omnichannelSettings.requestInventoryVerification
	liasettings.setinventoryverificationcontact	Este método dejará de estar disponible. En su lugar, usa accounts.omnichannelSettings.create o accounts.omnichannelSettings.update con una máscara actualizada.
	liasettings.setomnichannelexperience	Este método dejará de estar disponible. 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 Lugar de partida.

OmnichannelSetting

Content API de Shopping		API de Merchant
Campo	Tipo	Campo	Tipo	Descripción
(n/a)	(n/a)	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. 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 se refiere a las páginas de productos con información de disponibilidad en tienda) MHLSF_FULL (tienda local alojada por el comerciante completa, que hace referencia a las páginas de productos con información de disponibilidad en tienda)
(n/a)	(n/a)	inStock	object (InStock)	El URI (identificador de recursos uniforme) 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 lsfType es GHLSF.
storePickupActive	boolean	pickup	object (Pickup)	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 configures cuando GHLSF esté configurado 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 Acerca de 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/a)	(n/a)	Usa lsfType y pickup (más arriba).

LsfType

Content API de Shopping		API de Merchant
Campo	Tipo	Campo	Tipo	Descripción
lsfType	string	lsfType	enum (LsfType)	El tipo de vidriera local (LSF). Los valores posibles son los siguientes: GHLSF (tienda local alojada en Google) MHLSF_BASIC (tienda local básica alojada por el comercio) MHLSF_FULL (tienda local alojada por el comerciante completa)

InStock

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

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

Retiro

Content API de Shopping		API de Merchant
Campo	Tipo	Campo	Tipo	Descripción
(n/a)	(n/a)	uri	string	URI de la página del producto con retiro. Obligatorio si se configura el objeto. La API solo la usa para revisar la publicación de la información de partida. 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 de la ficha de producto. Los valores disponibles son los siguientes: ACTIVE FAILED RUNNING

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

LfpLink

Content API 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 por el que el proveedor de LFP conoce a este comercio.
(n/a)	(n/a)	state	enum (ReviewState.State)	Solo salida. Es el estado del LfpLink. Los valores disponibles son los siguientes: ACTIVE RUNNING

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

OnDisplayToOrder

Content API de Shopping		API de Merchant
Campo	Tipo	Campo	Tipo	Descripción
shippingCostPolicyUrl	string	uri	string	Obligatorio. 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 del contenido de Shopping, consulta LiaOnDisplayToOrderSettings.

Acerca de

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

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

InventoryVerification

Content API de Shopping		API de Merchant
Campo	Tipo	Campo	Tipo	Descripción
status	string	state	enum (InventoryVerification.State)	Solo salida. 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. El correo electrónico del contacto para el proceso de verificación del inventario
inventoryVerificationContactStatus	string	contactState	enum (ReviewState.State)	Solo salida. El estado de la verificación del contacto. Los valores posibles son ACTIVE RUNNING .

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

LfpProvider

Content API 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/a)	(n/a)	regionCode	string	Obligatorio. Código de país de CLDR
providerId	string	(n/a)	(n/a)	Este campo desaparecerá.
displayName	string	displayName	string	Es el nombre visible del proveedor de LFP.

Para revisar la versión del contenido de Shopping, 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 de GBP. Formato:accounts/{account}/gbpAccount/{gbp_account}
(n/a)	(n/a)	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 los siguientes: 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.
listingCount	string	listingCount	int64	Cantidad de fichas asociadas a esta cuenta

Para revisar la versión de Shopping Content, consulta GmbAccountsGmbAccount.