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 do Shopping, há várias mudanças importantes na API Merchant.

As configurações do LIA agora pertencem a um de 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 um parceiro da Parceria 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.

Confira 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 vez.
	liasettings.get	accounts.omnichannelSettings.list
	liasettings.list	Um método para receber todas as configurações de LIA de todas as subcontas não está mais disponível diretamente. Em vez disso, consulte todas as subcontas e use accounts.omnichannelSettings.list para receber as omnichannelSettings das subcontas de 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 Content para o Shopping		API Merchant
Campo	Tipo	Campo	Tipo	Descrição
(n/a)	(n/a)	name	string	O nome do recurso dessa configuração omnicanal. Formato: Formato: accounts/{account}/omnichannelSettings/{omnichannel_setting}
country	string	regionCode	string	Obrigatório. Código do país do Common Locale Data Repository (CLDR) (por exemplo, "US")
hostedLocalStorefrontActive	boolean	lsfType	enum (LsfType)	Obrigatório. O tipo Vitrine local (LSF, na sigla em inglês) para este regionCode. Os valores possíveis incluem GHLSF (vitrine local hospedada pelo Google) MHLSF_BASIC (vitrine local hospedada pelo comerciante (versão básica), que se refere a páginas de produtos com disponibilidade na loja) MHLSF_FULL (vitrine local hospedada pelo comerciante (versão completa), que se refere a páginas de produtos com disponibilidade na loja)
(n/a)	(n/a)	inStock	object (InStock)	O URI (identificador uniforme de recursos) da página do produto em estoque e o status de veiculação deste regionCode. Defina pelo menos um dos objetos inStock ou pickup na API de criação se você escolheu um dos tipos MHLSF, mas defina apenas inStock se o 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ê escolheu um dos tipos MHLSF, mas não defina quando GHLSF for 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 "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" para este regionCode.
inventory	object (LiaInventorySettings)	inventoryVerification	object (InventoryVerification)	O status do processo de verificação de inventário e as informações de contato para este regionCode
omnichannelExperience	object (LiaOmnichannelExperience)	(n/a)	(n/a)	Use lsfType e pickup (acima).

LsfType

API Content para o Shopping		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, versão básica) MHLSF_FULL (vitrine local hospedada pelo comerciante, versão completa)

InStock

API Content para o Shopping		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 de MHLSF. Obrigatório se o objeto estiver definido. Para GHLSF, ele precisa estar vazio, mas para MHLSF, não pode estar. O serviço usa isso apenas para analisar a veiculação em estoque. O domínio do URI precisa corresponder à página inicial da loja.
(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 revisar a versão do conteúdo do Shopping, consulte LiaCountrySettings e LiaOmnichannelExperience.

Retirada

API Content para o Shopping		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ó usa isso para analisar a veiculação de 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 revisar a versão do conteúdo do Shopping, consulte LiaCountrySettings e LiaOmnichannelExperience.

LfpLink

API Content para o Shopping		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 o 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 revisar a versão do conteúdo do Shopping, consulte LiaPosDataProvider.

OnDisplayToOrder

API Content para o Shopping		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, na sigla em inglês).
status	string	state	enum (ReviewState.State)	Apenas saída. O status do URI. Os valores possíveis são ACTIVE FAILED RUNNING

Para revisar a versão do conteúdo do Google Shopping, consulte LiaOnDisplayToOrderSettings.

Sobre

API Content para o Shopping		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 revisar a versão do conteúdo do Google Shopping, consulte LiaAboutPageSettings.

InventoryVerification

API Content para o Shopping		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 responsável pelo 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 revisar a versão do conteúdo do Shopping, consulte LiaCountrySettings e LiaInventorySettings.

LfpProvider

API Content para o Shopping		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 do país do 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 revisar a versão do conteúdo do Shopping, consulte PosDataProvidersPosDataProvider.

GbpAccount

Shopping Content API		API Merchant
Field	Type	Campo	Tipo	Descrição
name	string	name	string	O nome do recurso da conta em 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 comercial)
email	string	gbpAccountName	string	O nome do Perfil da Empresa: Para contas pessoais, é o ID de e-mail do proprietário. Para contas empresariais, é o nome da conta.
listingCount	string	listingCount	int64	Número de fichas associadas a esta conta

Para revisar a versão do conteúdo do Shopping, consulte GmbAccountsGmbAccount.