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.
  • Inscreva sua conta no gerenciamento automático de fontes de dados.
  • Gerenciar fontes de dados de API.
  • Gerencie a regra padrão de fontes de dados usando fontes de dados de produtos principais.
  • 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 caracteres 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 .

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 .

O exemplo de configuração a seguir garante que todos os atributos sejam utilizados primeiro da fonte de dados com o identificador exclusivo 1001. Então, o que falta atributos 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 fontes de dados, você precisa fazer o seguintes:

  • Verifique se sua conta está qualificada para inscrição chamando o Accounts.AutofeedSettings.Get.
  • Verifique se sua conta não é de um marketplace padrão.

Depois que sua conta estiver qualificada para registro, você poderá usar o Método Accounts.AutofeedSettings.Update para ativar o gerenciamento automático de dados de dados. Com o gerenciamento automático de fontes de dados, o Google adicione os produtos da sua loja on-line e garanta que eles estejam sempre atualizados nas plataformas do Google.

Recuperar o status de upload de arquivos

Para saber o status de uma fonte de dados com um arquivo, uma busca ou uma planilha, pode chamar o método GET do serviço FileUpload. Para obter o resultado de a última recuperação da fonte de dados calculada de forma assíncrona quando os dados o processamento de origem 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 for solicitado logo depois o arquivo é carregado.