Nesta página, mostramos como criar e atualizar de maneira programática suas fontes de dados que permitem inserir produtos. As fontes de dados automatizadas facilitam o envio dos dados do produto para o Google. As fontes de dados automatizadas garantem que as informações mais atualizadas sobre os produtos relevantes do seu site cheguem ao Google.
A API Content for Shopping só permite criar fontes de dados principais. Com ela, você pode criar os seguintes tipos de fontes de dados:
- Fontes de dados do produto principal
- Origens de dados complementares de produtos
- Origens de dados de inventário local
- Origens de dados de inventário regional
- Fontes de dados da promoção
A API Content for Shopping só permite o gerenciamento de fontes de dados com entrada de arquivo. Com a API Merchant, você pode gerenciar as fontes de dados com entradas de arquivo e de API.
Com a API Merchant Data Source, você pode fazer o seguinte:
- Crie uma nova fonte de dados principal com
feedLabel
econtentLanguage
específicos. - Crie uma fonte de dados com caracteres curinga. Uma fonte de dados curinga não tem os campos
feedLabel
econtentLanguage
definidos. As fontes de dados curinga permitem inserir produtos com diferentes combinações defeedLabel
econtentLanguage
em uma fonte de dados. - Crie uma fonte de dados complementar para vincular a uma fonte principal.
- Configure uma programação para uma fonte de dados de arquivos.
- Gerenciar fontes de dados de API.
- Use outros tipos de fontes de dados, como promoções.
Pré-requisitos
- Sua conta precisa ter sido migrada para feeds de localidade única.
Para verificar se a conta já foi migrada para a divisão de segmentação de dados, use os métodos "list" ou "get" da fonte de dados. Caso não se qualifique, você vai receber a mensagem de exceção a seguir e vai precisar entrar em contato com o suporte.
This account is in the data sources migration process and can't be used with this API yet. Contact support for more info on when this account will be able to use the data sources endpoint.
Criar uma fonte de dados
Para criar uma nova fonte de dados principal com feedLabel
e contentLanguage
específicos, defina os campos feedLabel
e contentLanguage
na configuração específica do tipo. Por exemplo, PrimaryProductDataSource
.
Para acessar a fonte de dados recém-criada, crie uma solicitação GET
ou LIST
.
Criar uma nova fonte de dados principal com caractere curinga
Para criar um novo feed principal de caractere curinga, configure sua fonte de dados usando PrimaryProductDataSource
e não defina os campos feedLabel
e contentLanguage
.
Com a API Content for Shopping, apenas uma fonte de dados da API é criada para você. Ao usar a API de fontes de dados do comerciante, é possível ter várias fontes de dados de API, algumas delas podem ser curinga.
Somente fontes de dados com entrada de API podem ser fontes de dados curinga. As fontes de dados curinga não são compatíveis com entradas de arquivo.
Criar uma fonte de dados complementar e vincular à fonte de dados principal
É possível usar fontes complementares para fazer atualizações parciais nos dados do produto adicionando o identificador exclusivo da fonte de dados como um parâmetro de consulta ao fazer chamadas para os métodos accounts.productInputs.insert
e accounts.productInputs.delete
. Só é possível usar fontes complementares para atualizar produtos atuais.
Para criar uma fonte de dados complementar, configure sua fonte de dados usando SupplementalProductDataSource
e, em seguida, vincule-a atualizando o campo defaultRule
na fonte de dados principal.
As fontes complementares de dados de arquivos não podem ser caracteres curinga. As fontes complementares de dados da API precisam ser sempre fontes de dados curinga.
Configurar uma programação para a fonte de dados de arquivos
Para definir uma programação para seu feed de arquivos, configure sua fonte de dados como uma fonte de dados de arquivos usando o campo FileInput
e configure fetchsettings
usando o campo FileInput.FetchSettings
.
Excluir uma fonte de dados
Para excluir uma fonte de dados atual da sua conta, use o
método
accounts.dataSources.delete
.
Buscar fonte de dados
Para buscar um arquivo configurado na fonte de dados, use o
método
accounts.dataSources.fetch
. Esse método realiza a busca de dados imediatamente em uma fonte de dados da sua conta. Esse método só funciona em fontes de dados com um conjunto de entrada de arquivos.
Acessar fonte de dados
Para recuperar a configuração da fonte de dados da sua conta, use o
método
accounts.dataSources.get
.
Listar fonte de dados
Para listar as configurações das fontes de dados da sua conta, use o
método
accounts.dataSources.list
.
Fonte de dados de patch
Para atualizar a configuração de uma fonte de dados atual, use o
método
accounts.dataSources.patch
.