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:
- Fontes de dados do produto principal
- Origens de dados complementares de produtos
- Origens de dados de inventário local
- Origens de dados de inventário regional
- Fontes de dados da promoção
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 econtentLanguage
. - Crie uma fonte de dados com caracteres curinga. Uma fonte de dados curinga não tem
feedLabel
. econtentLanguage
definidos. As fontes de dados com caracteres curinga permitem inserir produtos com combinações diferentes defeedLabel
econtentLanguage
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
.