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

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

Ahora, la configuración de los LIA 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 canales múltiples OmnichannelSetting
Conexión con el socio de Local Feed Partnership (LFP) para los datos de inventario LfpProvider
Conexión a la cuenta del Perfil de Negocio de Google (GBP) para los datos de las tiendas locales GbpAccount

Además, con la configuración de los LIA, había un solo recurso por cuenta, que 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 explica 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 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 las LIA para todas las cuentas secundarias. En cambio, consulta todas las cuentas secundarias y usa accounts.omnichannelSettings.list para obtener la configuración de 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

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

OmnichannelSetting

Content API de Shopping API de Merchant Center
Campo Tipo Campo Tipo Descripción
(n/a) (n/a) name string Es el nombre del recurso de este parámetro de configuración omnicanal. Formato:
Formato: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country string regionCode string Obligatorio. Código de país del Common Locale Data Repository (CLDR) (por ejemplo, "US")
hostedLocalStorefrontActive boolean lsfType enum (LsfType) Obligatorio. Tipo de vidriera local (LSF) para este regionCode. Entre los valores posibles, se incluyen los siguientes:
  • GHLSF (vidriera 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/a) (n/a) inStock object
(InStock)
Es el URI (identificador uniforme de recursos) 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)
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 de MHLSF, pero no lo establezcas cuando GHLSF se establezca como lsfType.
posDataProvider object
(LiaPosDataProvider)
lfpLink object
(LfpLink)
Solo salida. Es 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) para este regionCode
about object
(LiaAboutPageSettings)
about object
(About)
Es el URI y el estado de la página Acerca 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 (arriba).

LsfType

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

InStock

Content API de Shopping API de Merchant Center
Campo Tipo Campo Tipo Descripción
(n/a) (n/a) uri string Es el URI de la página de destino del producto. Se requiere si elegiste uno de los tipos de MHLSF. Obligatorio si se configura el objeto. Para GHLSF, debe estar vacío, pero para MHLSF, no debe estar vacío. El servicio solo la usa para revisar la publicación de productos en stock. El dominio de este 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 de anuncios en stock. Los valores disponibles son los siguientes:
  • 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 Center
Campo Tipo Campo Tipo Descripción
(n/a) (n/a) uri string Es el 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 recogida. El dominio de este 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 recogida. Los valores disponibles son los siguientes:
  • ACTIVE
  • FAILED
  • RUNNING

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

Content API de Shopping API de Merchant Center
Campo Tipo Campo Tipo Descripción
posDataProviderId string lfpProvider string Obligatorio. Nombre del recurso del proveedor de LFP
posExternalAccountId string externalAccountId string Obligatorio. ID de la cuenta con la 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 Center
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 los siguientes:
  • ACTIVE
  • FAILED
  • RUNNING

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

Acerca de

Content API de Shopping API de Merchant Center
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 Center
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 los siguientes:
  • ACTION_REQUIRED
  • INACTIVE
  • RUNNING
  • SUCCEEDED
  • SUSPENDED
inventoryVerificationContactName string contact string Obligatorio. 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 los siguientes:
  • ACTIVE
  • RUNNING

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

LfpProvider

Content API de Shopping API de Merchant Center
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 dejará de estar disponible.
displayName string displayName string Nombre visible del proveedor de LFP

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

GbpAccount

Shopping Content API API de Merchant Center
Field Type Campo Tipo Descripción
name string name string Nombre del recurso de la cuenta de GBP
Formato: accounts/{account}/gbpAccount/{gbp_account}
(n/a) (n/a) gbpAccountId string 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 comercial)
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 del contenido de Shopping, consulta GmbAccountsGmbAccount.