Este documento apresenta diretrizes para as práticas recomendadas. Consulte Dicas de desempenho para mais informações.
Quando usar a API
Enviar solicitações de maneira programática
Se você prefere automatizar todas as partes do fluxo de trabalho ou criar um gancho para o sistema de planejamento de recursos empresariais (ERP), a API Content permite enviar atualizações assim que o inventário for alterado.
Para receber feedback imediato
Na API Content, você recebe uma resposta para cada solicitação instantaneamente, em vez de um resumo por e-mail após o processamento dos feeds de dados. Espera-se uma latência de cinco a dez segundos para solicitações em lote grandes.
Para alterar com frequência os dados do produto
Com a API Content, você pode fazer atualizações incrementais no seu inventário de produtos de migração rápida muitas vezes por dia, mas não é viável enviar todo o feed de dados todas as vezes. Se as atualizações forem disponibilizadas individualmente, envie-as individualmente. Não espere até que haja várias atualizações para poder alocá-las em lote. Da mesma forma, se as atualizações estiverem disponíveis em lotes, envie-as em lotes e não as divida em solicitações individuais.
Gerenciar várias subcontas
As contas do Merchant Center recém-criadas são contas únicas que mantêm o próprio conjunto de dados de produtos. Isso funciona bem na maioria dos casos, mas, à medida que sua conta crescer, você vai precisar de um sistema de gerenciamento mais complexo para seus produtos. Se esse for seu caso, use uma conta de múltiplos clientes, ou MCA. O gerenciamento no nível da API de uma conta MCA pode ser realizado por meio do serviço de contas e permite a adição e o gerenciamento programáticos de subcontas. Mais informações sobre como conseguir uma conta de MCA podem ser encontradas neste link.
Como usar a API
Não use a API como faria com feeds de dados
Evite atualizações diárias de todo o feed de produtos ao usar o recurso products.
Em vez disso, atualize especificamente apenas os produtos com dados realmente
alterados. O envio de todo o feed de dados pelo recurso products consome mais tempo e recursos para o Google e para você.
Não use a API para recuperar regularmente as informações do produto que você enviou por upload
Se você é responsável por manter as informações do produto em uma
conta específica do Merchant Center, evite solicitar informações
do produto à API Content pelos métodos
products.get
ou
products.list
regularmente. Para clientes que fazem upload de informações, esses
métodos podem ajudar a depurar problemas ao criar soluções que
usam a API Content. No entanto, eles não são destinados à recuperação regular de informações de produtos por esses clientes. Você precisa ter outra fonte para
as informações do produto, como um banco de dados de produtos locais, e os produtos
no Merchant Center precisam refletir o conteúdo dessa origem.
Não use feeds de dados e a API Content para enviar itens de produtos ao mesmo tempo
Se estiver pensando em mudar para a API para envio de itens, certifique-se de não usar mais feeds de dados para enviar itens de produtos. Se você continuar enviando itens nos dois meios de comunicação, resultados inesperados poderão ocorrer.
Existe uma maneira de usar a API e os feeds de dados com segurança juntos?
Você pode manipular seus feeds de dados usando o serviço Datafeed da API. Embora isso facilite muito o gerenciamento do feed de dados em grande escala, lembre-se de que você não deve inserir ou atualizar produtos usando a API simultaneamente com feeds, porque podem ocorrer resultados inesperados.
Alguns outros exemplos de maneiras aceitáveis de usar feeds e a API em conjunto:
Execução de solicitações somente leitura (get ou list) da API: alguns comerciantes querem usar a API para buscar informações e atualizações de status sobre os produtos deles. Isso é aceitável porque as informações do produto só são atualizadas por feeds.
Uso da API para gerenciar suas subcontas (Serviço de contas) e/ou configurações de tributos e frete no nível da conta (Accounttax Service e Shippingsettings Service). Essas funções não podem ser fornecidas pelo Datafeeds. Portanto, não há conflito com o uso da API para gerenciar essas funções.
Como faço para migrar dos feeds de dados para a API ou vice-versa?
Se você usa feeds de dados e quer passar a usar apenas a API para atualizar produtos, faça um novo upload dos dados com a API. Quando você usa o serviço de produtos para atualizar um determinado item, a API assume o controle das informações do produto. Excluir o produto do feed de dados ou excluir o próprio feed de dados não removerá mais as informações do produto da sua conta do Merchant Center. Certifique-se de que não haja atualizações no feed de dados se você quiser remover o produto do feed de dados ou do próprio feed de dados. Caso contrário, o feed de dados assumirá a propriedade novamente e remover o produto do feed fará com que o produto seja excluído.
Se você usa atualmente apenas a API para informações de produtos e quer utilizar feeds de dados como sua principal fonte de informações, basta adicionar o novo feed de dados à sua conta do Merchant Center para que eles assumam a propriedade dos produtos listados. Se você quiser remover produtos antes que eles expirem, e eles tiverem sido enviados exclusivamente da API, eles precisarão ser excluídos pelo Merchant Center ou pela API.
Como faço para segmentar vários países com produtos usando a API Content for Shopping?
Para segmentar vários países com anúncios e listagens sem custo financeiro para produtos enviados
pela API Content, configure mais países no feed principal da API Content
no Merchant Center ou adicione esses países usando o campo shipping
no recurso products.
Confira abaixo um exemplo de como modificar as configurações de feed principal da API Content.
Para mais informações, consulte: Como segmentar anúncios do Shopping e listagens sem custo financeiro em vários países.
Verifique se as bibliotecas de cliente estão atualizadas
Se você estiver usando uma biblioteca de cliente do Google para interagir com a API Content, use o gerenciador de pacotes da linguagem de programação escolhida e verifique se a versão da biblioteca está atualizada. Para mais informações, consulte o Guia para desenvolvedores da linguagem escolhida em Amostras e bibliotecas.
Use os atributos de destinos para controlar quais produtos aparecem nos diferentes programas do Shopping.
A API Content adota automaticamente as configurações padrão do feed, que foram configuradas no Merchant Center. Você pode usar os
atributos do produto includedDestinations ou excludedDestinations para
controlar a participação do programa no nível de um produto em um feed ou pela
API Content.
Se o feed da API estiver ativado em um programa, por exemplo, o Comprar com o Google
(antigo Ações do Shopping), mas você quiser excluir determinados produtos,
use o atributo excludedDestinations e especifique Shopping Actions como o
valor. Se não houver erros, ele vai substituir as configurações padrão de feed no Merchant Center e esse item específico não vai aparecer no Comprar com o Google (anteriormente conhecido como Ações do Shopping). Por outro lado, se
seu feed não estiver ativado em um programa, como o Shopping, será possível
incluir itens individuais usando o atributo includedDestinations e
Shopping_ads como o valor, e o item vai aparecer nos anúncios do Shopping.
Para mais informações sobre os atributos de produto includedDestinations e
excludedDestinations, consulte a
Central de Ajuda.
Atualize os itens antes que eles expirem
Se um item não for alterado antes de expirar, 30 dias após a última atualização ou na data de validade especificada (se antes), atualize o item para evitar a desativação. Se você precisa atualizar muitos itens, porque nenhum deles foi alterado ou não é possível rastrear quando eles foram atualizados pela última vez, não atualize todos ao mesmo tempo, mas distribua a carga uniformemente ao longo de vários dias.
Não exclua o feed da API Content. Caso contrário, seus produtos poderão desaparecer
Na primeira vez que você fizer upload de um produto com channel:online usando a API
Content, um novo feed vai aparecer no Merchant Center com o nome API Content. Na primeira
vez que você fizer upload de um produto com channel:local usando a API Content, um novo
feed vai aparecer no Merchant Center chamado API Content com um subtítulo de
Produtos locais. Não exclua acidentalmente o feed on-line ou local da API Content. Dependendo do feed excluído, os produtos on-line ou disponíveis na loja física que você adicionou ao Merchant Center usando a API Content serão removidos.
Agrupar várias solicitações para o mesmo serviço usando o método custombatch
Em vez de fazer muitas solicitações sequenciais ou paralelas para o mesmo serviço, faça uma única solicitação em lote personalizado com todas as solicitações desejadas. Dessa forma, a latência para fazer solicitações ao endpoint da API só acontece uma vez para a chamada em lote personalizado, e não em cada solicitação individual, o que é especialmente importante se você estiver fazendo solicitações sequenciais.
Não envie várias atualizações para um único item de um único lote
Isso fornecerá resultados inesperados devido à incerteza quanto à sequência das atualizações e pode causar um erro de conflito.
Não enviar atualizações para itens inalterados
Envie solicitações somente para itens de produtos novos, alterados ou excluídos, a menos que os itens expirem.
Use feeds complementares se os preços e/ou a disponibilidade mudarem rapidamente
Se você tiver problemas para manter as informações de preço, disponibilidade ou
venda de um produto atualizadas, use os
feeds complementares no recurso products
para enviar atualizações apenas desses atributos. Como as atualizações de feed complementar são pequenas, você pode fazer muitas outras atualizações de feed complementar em um determinado período do que as atualizações completas do produto, o que ajuda a manter os preços e a disponibilidade dos seus produtos alinhados com as páginas de destino.
Outra maneira de atualizar o preço e a disponibilidade do produto é usar atualizações automáticas de itens. Isso pode ser usado além das atualizações da API para evitar inconsistências entre as informações no Merchant Center e as informações nas páginas de destino do produto. No entanto, lembre-se de que esse recurso foi criado para corrigir pequenos problemas com a precisão do preço e da disponibilidade do produto. Por isso, as atualizações automáticas de itens não substituem o fornecimento das informações corretas pela API.
Quando usar um token de atualização
O token de atualização é retornado no cabeçalho HTTP das solicitações de autorização. Ele contém muitas outras informações relacionadas à autenticação, mas o token de atualização geralmente é a peça que os desenvolvedores querem colocar na prática, porque elimina a necessidade de solicitar repetidamente a autenticação do usuário, já que os tokens de acesso duram apenas 60 minutos antes de expirar.