Migrar fontes de dados

Este guia explica como migrar sua integração dos serviços datafeeds e datafeedstatuses da API Content for Shopping para a sub-API Fontes de dados na API Merchant. A nova sub-API Data Sources oferece um controle mais direto sobre seus pipelines de dados e simplifica o gerenciamento de fontes de dados.

Para mais informações sobre os novos recursos, consulte o guia Gerenciar suas fontes de dados.

principais diferenças

Em comparação com a API Content for Shopping, a API Merchant oferece várias vantagens.

• Criação explícita de fontes de dados. A API não cria mais automaticamente uma fonte de dados "API Content" na primeira inserção de produto. Na API Merchant, você cria explicitamente as fontes de dados antes de fazer upload de produtos para elas. Assim, você tem mais controle sobre a organização e o gerenciamento dos pipelines de dados de produtos desde o início.

• Suporte a várias fontes de dados de API. Na API Content for Shopping, você tinha apenas uma fonte de dados "API Content" criada automaticamente. Com a API Merchant, é possível criar e gerenciar várias fontes de dados do tipo de entrada API.

• Fontes de dados sem rótulo e idioma. Com a API Merchant, é possível criar uma fonte de dados principal sem especificar um feedLabel e contentLanguage. Esse tipo de fonte de dados aceita produtos em qualquer combinação de feedLabel e contentLanguage, o que simplifica os envios de produtos para integrações que não exigem fontes de dados separadas para diferentes regiões.

• Destinos de dados simplificados. Cada fonte de dados agora corresponde a um único destino, definido por uma combinação exclusiva de feedLabel e contentLanguage. Os feeds de segmentação de vários dados foram descontinuados na API Merchant.

• Escolha sua estratégia de fonte de dados. Você tem três opções para gerenciar suas fontes de dados:

  1. Mantenha as fontes de dados da API Content atuais. Você pode continuar usando as fontes de dados criadas com a API Content for Shopping, já que elas são compatíveis com a API Merchant. É possível encontrar os nomes de recursos usando dataSources.list ou na interface do Merchant Center. As fontes de dados principais da API Content só são compatíveis com os feedLabel e contentLanguage específicos com que foram criadas. As fontes de dados da API Content são mostradas no Merchant Center com a origem "API Content", mesmo que os produtos sejam inseridos usando a API Merchant. É possível combiná-las com novas fontes de dados da API Merchant que também segmentam pares específicos de feedLabel e contentLanguage.

  2. Crie novas fontes de dados da API Merchant para cada rótulo e idioma. Use essa opção se você precisar oferecer suporte a novas combinações de feedLabel e contentLanguage (e preferir manter uma separação estrita entre elas) ou se usar a configuração de regras de fonte de dados, que depende de feedLabel e contentLanguage específicos. É necessário criar uma fonte de dados separada para cada par de feedLabel e contentLanguage que você usa.

  3. Crie uma única fonte de dados da API Merchant para qualquer rótulo e idioma. Use essa opção para simplificar o gerenciamento com uma única fonte de dados que aceita produtos com qualquer feedLabel e contentLanguage. Se você escolher essa opção, recomendamos migrar todos os produtos para essa nova fonte de dados e remover as fontes de dados antigas da API Content depois que os produtos forem migrados.

• Status dedicado do upload de arquivos. A API Merchant representa o status das fontes de dados baseadas em arquivos usando um recurso fileUploads separado e somente leitura. Para recuperar o status de um upload de arquivo, use o método fileUploads.get com o alias latest.

• Novos tipos de fontes de dados. O recurso DataSource é compatível com mais segmentos verticais, incluindo promoções, inventário local e regional, oferecendo uma maneira unificada de gerenciar todos os seus pipelines de dados.

• Fontes de dados automáticas. Com a API Merchant, agora é possível ativar ou desativar o recurso Fontes de dados automatizadas na sua conta usando o método autofeedSettings.updateAutofeedSettings na sub-API Accounts. Para mais informações, consulte Configurar as opções de Autofeed.

Solicitações

A tabela a seguir compara os formatos de URL de solicitação entre a API Content do Shopping e a API Merchant.

Descrição da solicitação	API Content for Shopping	API Merchant
Criar uma fonte de dados	POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds	POST https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources
Acessar uma fonte de dados	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}	GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
Listar fontes de dados	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds	GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources
Atualizar uma fonte de dados	PUT https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}	PATCH https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
Excluir uma fonte de dados	DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}	DELETE https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}
Buscar uma fonte de dados	POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeeds/{DATAFEED_ID}/fetchNow	POST https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}:fetch
Acessar o status da fonte de dados	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeedstatuses/{DATAFEED_ID}	GET https://merchantapi.googleapis.com/v1/accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}/fileUploads/latest
Listar status da fonte de dados	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/datafeedstatuses	Indisponível. Use dataSources.list e fileUploads.get para cada fonte de dados baseada em arquivo.

Identificadores

A API Merchant usa um nome de recurso baseado em string como identificador.

Descrição do identificador	API Content for Shopping	API Merchant
Identificador da fonte de dados	datafeedId (numérico)	name (string, formato: accounts/{account}/dataSources/{datasource})

Métodos

Esta tabela compara os métodos dos serviços datafeeds e datafeedstatuses da API Content for Shopping com os equivalentes na API Merchant.

Método da API Content for Shopping	Método da API Merchant	Disponibilidade e observações
datafeeds.custombatch	Indisponível	Use chamadas de API individuais.
datafeeds.delete	dataSources.delete	Disponível.
datafeeds.fetchnow	dataSources.fetch	Disponível. Agora, esse método só funciona para fontes de dados com uma entrada de arquivo.
datafeeds.get	dataSources.get	Disponível.
datafeeds.insert	dataSources.create	Disponível.
datafeeds.list	dataSources.list	Disponível.
datafeeds.update	dataSources.update	Disponível. Usa a semântica PATCH em vez de PUT.
datafeedstatuses.custombatch	Indisponível	Use chamadas de API individuais. Consulte Enviar várias solicitações de uma só vez para mais detalhes.
datafeedstatuses.get	fileUploads.get	Disponível para fontes de dados baseadas em arquivos. Use o alias latest para conferir o status do envio mais recente. Para outros tipos de fontes de dados, as informações de status fazem parte do recurso DataSource.
datafeedstatuses.list	Indisponível	Para conferir o status de várias fontes de dados, primeiro liste todas as fontes com dataSources.list. Em seguida, chame fileUploads.get com o alias latest para cada fonte de dados baseada em arquivo.

Mudanças detalhadas nos campos

Esta tabela mostra as mudanças no nível do campo entre os recursos Datafeed e DatafeedStatus na API Content for Shopping e os recursos DataSource e FileUpload na API Merchant.

API Content for Shopping	API Merchant	Descrição
Datafeed	DataSource	O principal recurso para configuração de fonte de dados.
id	name	O identificador do recurso. Mudou de um ID numérico para um nome de recurso de string.
name	displayName	O nome da fonte de dados que aparece para o usuário.
attributeLanguage	primaryProductDataSource.contentLanguage	O código de idioma ISO 639-1 de duas letras dos itens na fonte de dados.
fileName	fileInput.fileName	O nome do arquivo enviado. Agora, esse campo está aninhado em fileInput.
fetchSchedule	fileInput.fetchSettings	A programação para buscar uma fonte de dados baseada em arquivo. Agora, ele está aninhado em fileInput.
fetchSchedule.paused	fileInput.fetchSettings.enabled	A lógica é invertida. paused: true é equivalente a enabled: false.
format	Indisponível	Os campos fileEncoding, columnDelimiter e quotingMode são removidos. Agora eles são detectados automaticamente.
targets	primaryProductDataSource.feedLabel, primaryProductDataSource.contentLanguage, primaryProductDataSource.countries	O campo repetido targets é removido. Cada fonte de dados agora tem uma única meta definida por esses campos, refletindo a descontinuação dos feeds com várias metas de dados.
DatafeedStatus	FileUpload	O status de um upload de arquivo agora é um recurso separado e somente leitura.
datafeedId	name	O identificador do upload de arquivo, que faz referência à fonte de dados principal.
processingStatus	processingState	O status de processamento do upload. Os valores de string (success, failure, in progress) são substituídos por uma enumeração (SUCCEEDED, FAILED, IN_PROGRESS).
errors, warnings	issues	Erros e avisos são mesclados em uma única lista issues. Cada problema tem um campo severity (ERROR ou WARNING).
lastUploadDate	uploadTime	O carimbo de data/hora do último upload. O formato mudou de uma string para um objeto Timestamp.
country, language, feedLabel	Não relevante	Esses campos não estão mais no recurso de status. Eles fazem parte do recurso DataSource.
targets[].included_destinations, targets[].excluded_destinations	primaryProductDataSource.destinations	As duas listas separadas de destinos incluídos e excluídos são substituídas por uma única lista destinations. Cada item na nova lista é um objeto que especifica o destino e o estado dele (ENABLED ou DISABLED), fornecendo uma configuração mais explícita.