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 que você insira produtos. Dados automatizados fontes facilitam o envio os dados do produto para o Google. As fontes de dados automatizadas garantem que a maior informações atualizadas sobre produtos relevantes do seu site chegam ao Google.

A API Content for Shopping só permite criar fontes de dados principais. Com API Merchant Data Source, é possível 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 um feedLabel específico e contentLanguage.
  • Crie uma fonte de dados com caracteres curinga. Uma fonte de dados curinga não tem feedLabel. e contentLanguage definidos. As fontes de dados com caracteres curinga permitem inserir produtos com combinações diferentes 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 o método lista de fontes de dados ou métodos get. Caso não se qualifique, você receberá a seguinte mensagem de exceção e você deve 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 nova fonte de dados

Para criar uma nova fonte de dados principal com um feedLabel específico e contentLanguage, defina os campos feedLabel e contentLanguage nas 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 sem definir os campos feedLabel e contentLanguage.

Ao usar a API Content for Shopping, é criada apenas uma fonte de dados da API para para você. Com a API Merchant Data Source, é possível ter várias fontes de dados de API. e algumas podem ser curinga.

Somente fontes de dados com entrada de API podem ser fontes de dados curinga. Dados de caractere curinga as fontes não têm suporte para entradas de arquivo.

Criar uma fonte de dados complementar e vincular à fonte de dados principal

Você pode usar fontes complementares para fazer atualizações parciais nos dados do produto: adicionando o identificador único da fonte de dados como um parâmetro de consulta ao fazer chamadas para o accounts.productInputs.insert e accounts.productInputs.delete métodos. 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 a vincule atualizando o defaultRule na sua fonte de dados principal.

As fontes complementares de dados de arquivos não podem ser caracteres curinga. API complementar as origens de dados precisam ser de dados curinga.

Configurar uma programação para a fonte de dados de arquivos

Para definir uma programação para o feed de arquivos, configure a fonte de dados como um arquivo fonte de dados usando o campo FileInput e, em seguida, configure fetchsettings usando o campo FileInput.FetchSettings.

Excluir uma fonte de dados

Para excluir uma fonte de dados da sua conta, use o 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 de 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 accounts.dataSources.list .

Fonte de dados de patch

Para atualizar a configuração de uma fonte de dados, use o accounts.dataSources.patch .