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 da parceria de feeds locais (LFP, na sigla em inglês) para dados de inventário	LfpProvider
Conexão à conta do Perfil da Empresa no Google (PEG) para dados de lojas locais	GbpAccount

Além disso, com as configurações de LIA, havia um único recurso por conta e ele continha uma lista de configurações para cada entidade nacional. Com 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 é removido. A API Merchant oferece suporte para enviar várias solicitações de uma só 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 é removido. Em vez disso, use accounts.omnichannelSettings.create ou accounts.omnichannelSettings.update com uma máscara atualizada.
	liasettings.setomnichannelexperience	Esse método é removido. 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 o 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 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 vitrine local (LSF) para esta regionCode. Os valores possíveis são os seguintes: GHLSF (Vitrine local hospedada pelo Google) MHLSF_BASIC (vitrine local hospedada pelo comerciante (versão 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 da página do produto em estoque (identificador universal de recursos) e o status de veiculação para esse regionCode. Defina pelo menos um dos objetos inStock ou pickup na API de criação se você escolheu um dos tipos MHLSF, mas defina inStock apenas 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 para 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 o defina quando GHLSF for definido como lsfType.
posDataProvider	object (LiaPosDataProvider)	lfpLink	object (LfpLink)	Apenas saída. O link estabelecido para 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 os dados de contato para essa 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 MHLSF. Obrigatório se o objeto estiver definido. Para GHLSF, ele precisa estar vazio, mas para MHLSF, não pode estar vazio. O serviço usa isso apenas para analisar a veiculação em estoque. Esse 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 conferir a versão do conteúdo de compras, 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 esse campo para analisar a veiculação de retirada. Esse 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 conferir a versão do conteúdo de compras, 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 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 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 conferir a versão do conteúdo do 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 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 responsável pelo 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 é removido.
displayName	string	displayName	string	O nome de exibição do provedor de LFP

Para conferir a versão do conteúdo do Google 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 de 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 de 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 empresa.
listingCount	string	listingCount	int64	Número de fichas associadas a esta conta

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