Visão geral da API de fontes de dados do comerciante

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:

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 e contentLanguage específicos.
  • Crie uma fonte de dados com caracteres curinga. Uma fonte de dados curinga não tem os campos feedLabel e contentLanguage definidos. As fontes de dados curinga permitem inserir produtos com diferentes combinações de feedLabel e contentLanguage 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.