Migrar as configurações dos anúncios de inventário local (AIL)

Se você usou as configurações de anúncios de inventário local na API Content for Shopping, há várias mudanças importantes na API Merchant.

As configurações de LIA agora pertencem a um dos três componentes principais, cada um com um recurso associado.

Componente principal	Recurso
Configuração da conta para veiculação omnichannel	OmnichannelSetting
Conexão com o parceiro do Programa de Parcerias de Feeds Locais (LFP) para dados de inventário	LfpProvider
Conexão com a conta do Perfil da Empresa no Google (GBP) para dados de lojas locais	GbpAccount

Além disso, com as configurações de LIA, havia um único recurso por conta, que continha uma lista de configurações para cada entidade nacional. Com o OmnichannelSettings, é possível associar vários recursos a uma conta. Cada recurso representa as configurações de uma entidade nacional específica.

Veja como as solicitações e os recursos mudaram.

Solicitações

Novo domínio	Nome do método da API Content	Nome do método da API Merchant
accounts.omnichannelSettings	liasettings.custombatch	Esse método será desativado. A API Merchant permite enviar várias solicitações de uma só vez.
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	Não é mais possível acessar diretamente um método para receber todas as configurações de LIA de todas as subcontas. Em vez disso, consulte todas as subcontas e use accounts.omnichannelSettings.list para receber as omnichannelSettings das que são do seu interesse.
	liasettings.update	accounts.omnichannelSettings.create, accounts.omnichannelSettings.update
	liasettings.requestinventoryverification	accounts.omnichannelSettings.requestInventoryVerification
	liasettings.setinventoryverificationcontact	Esse método será desativado. Em vez disso, use accounts.omnichannelSettings.create ou accounts.omnichannelSettings.update com uma máscara atualizada.
	liasettings.setomnichannelexperience	Esse método será desativado. Em vez disso, use accounts.omnichannelSettings.create ou accounts.omnichannelSettings.update com uma máscara atualizada.
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
  • Retirada
  • LfpLink
  • OnDisplayToOrder
  • Sobre
  • InventoryVerification
• LfpProvider
• GbpAccount

Além disso, o serviço se comporta de maneira diferente para PickupType. Consulte Retirada.

OmnichannelSetting

API Shopping Content		API Merchant
Campo	Tipo	Campo	Tipo	Descrição
(n/a)	(n/a)	name	string	O nome do recurso dessa configuração omnichannel. Formato: Formato: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country	string	regionCode	string	Obrigatório. Código de país do Common Locale Data Repository (CLDR) (por exemplo, "US")
hostedLocalStorefrontActive	boolean	lsfType	enum (LsfType)	Obrigatório. O tipo de vitrine local (LSF) para este regionCode. Os valores possíveis são os seguintes: GHLSF (vitrine local hospedada pelo Google) MHLSF_BASIC (vitrine local hospedada pelo comerciante básica, que se refere às páginas de produtos com disponibilidade na loja) MHLSF_FULL (vitrine local hospedada pelo comerciante completa, que se refere às páginas de produtos com disponibilidade na loja)
(n/a)	(n/a)	inStock	object (InStock)	O URI (identificador universal de recursos) da página do produto em estoque e o status de veiculação para este regionCode. Defina pelo menos um dos objetos inStock ou pickup na API de criação se você tiver escolhido um dos tipos MHLSF, mas defina inStock apenas se lsfType for GHLSF.
storePickupActive	boolean	pickup	object (Pickup)	O URI da página do produto para retirada e o status de veiculação deste regionCode. Defina pelo menos um dos objetos inStock ou Pickup na API de criação se você tiver escolhido um dos tipos MHLSF, mas não o defina quando GHLSF estiver definido como lsfType.
posDataProvider	object (LiaPosDataProvider)	lfpLink	object (LfpLink)	Apenas saída. O link estabelecido com um provedor de LFP
onDisplayToOrder	object (LiaOnDisplayToOrderSettings)	odo	object (OnDisplayToOrder)	O URI e o status da política de "em mostruário sem pronta entrega" (ODO) para este regionCode
about	object (LiaAboutPageSettings)	about	object (About)	O URI e o status da página "Sobre" deste regionCode
inventory	object (LiaInventorySettings)	inventoryVerification	object (InventoryVerification)	O status do processo de verificação de inventário e os dados de contato deste regionCode
omnichannelExperience	object (LiaOmnichannelExperience)	(n/a)	(n/a)	Use lsfType e pickup (acima).

LsfType

API Shopping Content		API Merchant
Campo	Tipo	Campo	Tipo	Descrição
lsfType	string	lsfType	enum (LsfType)	O tipo de vitrine local (LSF, na sigla em inglês). Os valores possíveis são: GHLSF (vitrine local hospedada pelo Google) MHLSF_BASIC (vitrine local hospedada pelo comerciante básica) MHLSF_FULL (vitrine local hospedada pelo comerciante, versão completa)

InStock

API Shopping Content		API Merchant
Campo	Tipo	Campo	Tipo	Descrição
(n/a)	(n/a)	uri	string	URI da página de destino do produto. Obrigatório se você escolheu um dos tipos MHLSF. Obrigatório se o objeto estiver definido. Para GHLSF, ele precisa estar vazio, mas para MHLSF, não vazio. O serviço usa esses dados apenas para analisar a veiculação em estoque. O domínio do URI precisa corresponder à página inicial do comerciante.
(n/a)	(n/a)	state	enum (ReviewState.State)	Apenas saída. O status da veiculação em estoque. Os valores disponíveis são ACTIVE FAILED RUNNING ACTION_REQUIRED

Para analisar a versão do conteúdo com merchandising, consulte LiaCountrySettings e LiaOmnichannelExperience.

Retirada

API Shopping Content		API Merchant
Campo	Tipo	Campo	Tipo	Descrição
(n/a)	(n/a)	uri	string	URI da página do produto para retirada. Obrigatório se o objeto estiver definido. A API só o usa para analisar a retirada. O domínio do URI precisa corresponder à página inicial do comerciante.
LiaInventorySettings.status	string	state	enum (ReviewState.State)	Apenas saída. O status da veiculação de retirada. Os valores disponíveis são ACTIVE FAILED RUNNING

Para analisar a versão do conteúdo com merchandising, consulte LiaCountrySettings e LiaOmnichannelExperience.

LfpLink

API Shopping Content		API Merchant
Campo	Tipo	Campo	Tipo	Descrição
posDataProviderId	string	lfpProvider	string	Obrigatório. O nome do recurso do provedor de LFP
posExternalAccountId	string	externalAccountId	string	Obrigatório. O ID da conta pelo qual esse comerciante é conhecido pelo provedor de LFP.
(n/a)	(n/a)	state	enum (ReviewState.State)	Apenas saída. O status do LfpLink. Os valores disponíveis são ACTIVE RUNNING

Para analisar a versão do conteúdo com merchandising, consulte LiaPosDataProvider.

OnDisplayToOrder

API Shopping Content		API Merchant
Campo	Tipo	Campo	Tipo	Descrição
shippingCostPolicyUrl	string	uri	string	Obrigatório. O URI da política "em mostruário sem pronta entrega" (ODO).
status	string	state	enum (ReviewState.State)	Apenas saída. O status do URI. Os valores possíveis são ACTIVE FAILED RUNNING

Para analisar a versão do conteúdo com merchandising, consulte LiaOnDisplayToOrderSettings.

Sobre

API Shopping Content		API Merchant
Campo	Tipo	Campo	Tipo	Descrição
url	string	uri	string	Obrigatório. O URI da página "Sobre"
status	string	state	enum (ReviewState.State)	Apenas saída. O status do URI. Os valores possíveis são ACTIVE FAILED RUNNING

Para analisar a versão do conteúdo com merchandising, consulte LiaAboutPageSettings.

InventoryVerification

API Shopping Content		API Merchant
Campo	Tipo	Campo	Tipo	Descrição
status	string	state	enum (InventoryVerification.State)	Apenas saída. O status do processo de verificação de inventário. Os valores possíveis são ACTION_REQUIRED INACTIVE RUNNING SUCCEEDED SUSPENDED
inventoryVerificationContactName	string	contact	string	Obrigatório. O nome do contato para o processo de verificação de inventário
inventoryVerificationContactEmail	string	contactEmail	string	Obrigatório. O e-mail do contato para o processo de verificação de inventário
inventoryVerificationContactStatus	string	contactState	enum (ReviewState.State)	Apenas saída. O status da verificação de contato. Os valores possíveis são ACTIVE RUNNING

Para analisar a versão do conteúdo com merchandising, consulte LiaCountrySettings e LiaInventorySettings.

LfpProvider

API Shopping Content		API Merchant
Campo	Tipo	Campo	Tipo	Descrição
fullName	string	name	string	O nome do recurso do provedor de LFP. Formato: accounts/{account}/omnichannelSettings/{omnichannel_setting}/lfpProviders/{lfp_provider}
(n/a)	(n/a)	regionCode	string	Obrigatório. Código de país CLDR
providerId	string	(n/a)	(n/a)	Esse campo será removido.
displayName	string	displayName	string	O nome de exibição do provedor de LFP

Para conferir a versão do conteúdo com merchandising, consulte PosDataProvidersPosDataProvider.

GbpAccount

Shopping Content API		API Merchant
Field	Type	Campo	Tipo	Descrição
name	string	name	string	O nome do recurso da conta do GBP Formato: accounts/{account}/gbpAccount/{gbp_account}
(n/a)	(n/a)	gbpAccountId	string	O ID do Perfil da Empresa
type	string	type	enum (GbpAccount.Type)	O tipo do Perfil da Empresa. Os valores disponíveis são USER (conta pessoal) BUSINESS_ACCOUNT (conta empresarial)
email	string	gbpAccountName	string	O nome do Perfil da Empresa: Para contas pessoais, esse é o ID de e-mail do proprietário. Para contas empresariais, é o nome da conta empresarial.
listingCount	string	listingCount	int64	Número de fichas de empresa associadas a esta conta

Para conferir a versão do conteúdo com merchandising, consulte GmbAccountsGmbAccount.