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

Esta página mostra como criar e atualizar de forma programática as fontes de dados que permitem inserir produtos. As fontes de dados automatizadas facilitam o envio de dados do produto ao 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 gerenciar fontes de dados com entrada de arquivo. A API Merchant permite gerenciar fontes de dados com entradas de arquivo e de API.

Com a API Merchant Data Sources, é possível fazer o seguinte:

  • Crie uma nova fonte de dados principal com um feedLabel específico e contentLanguage.
  • Criar uma fonte de dados que não tem feedLabel e contentLanguage definidos. Com esse tipo de fonte de dados, você pode segmentar vários países para seus produtos, inserindo itens com diferentes combinações de feedLabel e contentLanguage em uma única 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.
  • Inscreva sua conta para o gerenciamento automático de fontes de dados.
  • Gerenciar fontes de dados de API.
  • Gerenciar a regra padrão das fontes de dados usando as fontes de dados de produtos principais.
  • Use outros tipos de fontes de dados, como promoções.

Não é possível usar a API Merchant para inserir produtos em uma fonte de dados que contenha produtos locais e on-line. Para mais informações sobre os canais de fontes de dados, consulte Canais.

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 contrário, você vai receber a mensagem de exceção abaixo e 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 nova fonte de dados

As fontes de dados principais são as fontes de dados principais da sua conta do Merchant Center inventário. Só é possível adicionar ou remover produtos usando uma fonte de dados principal. Se cada produto adicionado à sua fonte de dados principal atende aos dados do Merchant Center. e requisitos de qualificação, não será necessário criar mais nenhuma 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. Para mais informações sobre esses campos, consulte PrimaryProductDataSource.

Para mais informações sobre como criar uma fonte de dados, consulte a accounts.dataSources.create .

Para conferir a fonte de dados recém-criada, use o método accounts.dataSources.get ou accounts.dataSources.list.

Criar uma nova fonte de dados principal para segmentar vários países

Para criar um novo feed principal que ajude a segmentar vários países, configure a fonte de dados usando PrimaryProductDataSource e não defina os campos feedLabel e contentLanguage.

Ao usar a API Content for Shopping, há apenas uma fonte de dados da API criada para você. Com a API Merchant Data Source, é possível ter várias fontes de dados de API. Algumas delas podem ficar sem os campos feedLabel e contentLanguage definidos.

Somente fontes de dados com entrada de API podem ficar sem feedLabel e Campos contentLanguage definidos. Esse tipo de fonte de dados não é compatível com o arquivo de entrada.

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

As fontes de dados complementares são usadas somente para atualizar os dados do produto que já em uma ou mais fontes de dados principais. É possível ter várias fontes de dados complementares, e cada uma delas pode complementar os dados em qualquer número de fontes de dados principais.

É possível usar fontes de dados complementares para fazer atualizações parciais nos dados do produto adicionando o identificador exclusivo da fonte 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 de dados complementares para atualizar produtos existentes.

Para criar uma fonte de dados complementar, configure-a usando SupplementalProductDataSource e vincule-a atualizando o campo defaultRule na fonte de dados principal.

As fontes de dados de arquivos complementares precisam ter os campos feedLabel e contentLanguage definidos. As fontes de dados complementares da API sempre precisam ter os atributos feedLabel e Campos contentLanguage não definidos.

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

Para configurar uma programação para o feed de arquivos, defina a fonte de dados como uma fonte de dados de arquivos 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 a fonte de dados

Para buscar um arquivo configurado na fonte de dados, use o método accounts.dataSources.fetch. Esse método executa 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 arquivo.

Acessar fonte de dados

Para recuperar a configuração da fonte de dados da sua conta, use o método accounts.dataSources.get .

Listar a 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 .

As fontes de dados dos produtos principais permitem gerenciar regra das fontes de dados. A regra padrão é aquela que se aplica a todos na sua fonte de dados. A regra padrão pode ser definida durante a criação do fonte de dados ou atualizando uma atual pela regra padrão .

A configuração de exemplo a seguir garante que todos os atributos sejam primeiro retirados da origem de dados com o identificador exclusivo 1001. Em seguida, os atributos ausentes são adicionados da fonte de dados principal. Em algum momento, o restante atributos serão extraídos da fonte de dados complementar com o atributo identificador 1002, caso ainda não tenha sido fornecido em outra fonte de dados. Se o mesmo atributo for fornecido em várias fontes de dados, o valor mais alto na lista será selecionados.

defaultRule {
 takeFromDataSources: [
   '1001', // Supplemental product data source
   'self', //  Self reference to the primary data source
   '1002' // Supplemental product data source
 ]
}

Gerenciamento automático de feeds

Para inscrever sua conta no gerenciamento automático de origens de dados, faça o seguinte:

Depois que sua conta estiver qualificada para inscrição, você poderá usar o accounts.autofeedSettings.updateAutofeedSettings para ativar o gerenciamento automático de fontes de dados. Ativação automática de fontes de dados permite que o Google adicione automaticamente seus produtos loja on-line e garantir que estejam sempre atualizados nas plataformas do Google.

Recuperar o status do upload de arquivo

Para saber o status de uma fonte de dados com um arquivo, uma busca ou uma planilha, pode chamar o método GET do accounts.dataSources.fileUploads serviço. Para receber o resultado da última recuperação da fonte de dados computada de forma assíncrona quando o processamento da fonte de dados for concluído, use o identificador de nome latest.

GET https://merchantapi.googleapis.com/accounts/v1beta/{accountId}/datasources/{datasourceId}/fileUploads/latest

O status de upload do arquivo pode conter uma visão detalhada dos seus produtos, incluindo: possíveis problemas.

O status de upload do arquivo pode não existir se ele nunca tiver sido enviado. O status de upload do arquivo pode estar em processamento se solicitado logo após o upload.