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 as informações mais atualizadas sobre produtos relevantes do seu site cheguem ao Google.

A API Content for Shopping só permite criar fontes de dados principais. Com a API Merchant Data Sources, é possível criar os seguintes tipos de fontes de dados:

A API Content for Shopping só permite gerenciar origens 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 e um contentLanguage específicos.
  • Crie uma fonte de dados que não tenha os campos 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 de dados 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 da 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 uma única localidade.

  • Para verificar se a conta já foi migrada para a divisão de destino de dados, use a lista de fontes de dados ou os métodos de acesso. 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 origens de dados principais são as principais fontes de dados do seu inventário do Merchant Center. Só é possível adicionar ou remover produtos usando uma fonte de dados principal. Se todos os produtos que você adicionar à sua fonte de dados principal atenderem aos requisitos de qualificação e de dados do Merchant Center, não será necessário criar mais fontes de dados.

Para criar uma nova fonte de dados principal com um feedLabel e um contentLanguage específicos, defina os campos feedLabel e contentLanguage na configuração específica do tipo. Para mais informações sobre esses campos, consulte PrimaryProductDataSource.

O exemplo de solicitação a seguir demonstra como criar uma fonte de dados de produto principal:

POST https://merchantapi.googleapis.com/datasources/v1beta/accounts/{ACCOUNT_ID}/dataSources

{
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "feedLabel": "{FEED_LABEL}",
    "countries": [
      "{COUNTRY}"
    ],
    "channel": "ONLINE_PRODUCTS"
  }
}

Substitua:

  • {ACCOUNT_ID}: o identificador exclusivo da sua conta do Merchant Center.
  • {DISPLAY_NAME}: o nome de exibição da fonte de dados.
  • {CONTENT_LANGUAGE}: o código de idioma ISO 639-1 de duas letras dos produtos na fonte de dados.
  • {FEED_LABEL}: o rótulo do feed da fonte de dados.
  • {COUNTRY}: o código de território CLDR do país de destino dos produtos que serão enviados usando a fonte de dados.

Depois que a solicitação for executada, você vai receber a seguinte resposta:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATA_SOURCE_ID}",
  "dataSourceId": "{DATA_SOURCE_ID}",
  "displayName": "{DISPLAY_NAME}",
  "primaryProductDataSource": {
    "channel": "ONLINE_PRODUCTS",
    "feedLabel": "{FEED_LABEL}",
    "contentLanguage": "{CONTENT_LANGUAGE}",
    "countries": [
      "{COUNTRY}"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

Para mais informações sobre como criar uma fonte de dados, consulte o método 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 Sources, é possível ter várias fontes de dados de API, algumas delas sem os campos feedLabel e contentLanguage definidos.

Somente as fontes de dados com entrada de API podem estar sem os campos feedLabel e contentLanguage definidos. Esse tipo de fonte de dados não é compatível com entradas de arquivo.

Criar uma fonte de dados complementar e vincular à principal

As fontes de dados complementares são usadas apenas para atualizar dados de produtos que já existem 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 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 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. Os campos feedLabel e contentLanguage das fontes de dados de API suplementares precisam estar sempre desmarcados.

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 configure fetchsettings usando o campo FileInput.FetchSettings.

Excluir uma fonte de dados

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

Origem de dados do patch

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

As fontes de dados de produtos principais permitem gerenciar a regra padrão das fontes de dados. A regra padrão é aquela que se aplica a todos os atributos na sua fonte de dados. A regra padrão pode ser definida ao criar a origem de dados ou atualizando uma origem de dados existente pelo campo de regra padrão.

Para mais informações sobre como configurar regras, consulte Configurar regras para suas fontes de dados de produtos.

A configuração de exemplo a seguir garante que todos os atributos sejam retirados primeiro da origem de dados com o identificador exclusivo 1001. Em seguida, os atributos ausentes são adicionados da fonte de dados principal. Eventualmente, os atributos restantes serão retirados da fonte de dados suplementar com o identificador exclusivo 1002, se não tiverem sido fornecidos em nenhuma outra fonte de dados. Se o mesmo atributo for fornecido em várias fontes de dados, o valor mais alto na lista será selecionado.

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 método accounts.autofeedSettings.updateAutofeedSettings para ativar o gerenciamento automático de fontes de dados. Ativar o gerenciamento automático de origens de dados permite que o Google adicione automaticamente os produtos da sua loja on-line e garanta que eles estejam sempre atualizados nas plataformas do Google.

Recuperar o status do upload de arquivo

Para conferir o status de uma fonte de dados com um arquivo, uma busca ou uma planilha, chame o método GET do serviço accounts.dataSources.fileUploads. 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/{ACCOUNT_ID}/datasources/{DATASOURCE_ID}/fileUploads/latest

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

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