Este documento fornece diretrizes sobre práticas recomendadas. Consulte Dicas de performance para mais informações.
Quando usar a API
Para enviar solicitações de maneira programática
Se você prefere automatizar todas as partes do seu fluxo de trabalho ou criar um hook no seu sistema ERP (Enterprise Resource Planning), a API Content permite enviar atualizações assim que seu inventário muda.
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. Uma latência de 5 a 10 segundos é esperada para solicitações de lote grandes.
Para mudar os dados de produtos com frequência
Com a API Content, você pode fazer atualizações incrementais no inventário de produtos de alta rotatividade várias vezes ao dia, enquanto enviar todo o feed de dados a cada vez não é viável. Se as atualizações forem disponibilizadas individualmente, envie cada uma delas. Não espere até que haja várias atualizações para enviar em lote. Da mesma forma, se as atualizações estiverem disponíveis em lotes, envie-as em lotes, não as divida em solicitações individuais.
Para gerenciar várias subcontas
As contas do Merchant Center recém-criadas são únicas e mantêm seu próprio conjunto de dados de produtos. Isso funciona bem na maioria dos casos, mas, à medida que sua conta cresce, talvez você precise de um sistema de gerenciamento mais complexo para seus produtos. Se for esse o caso, use uma conta de múltiplos clientes (MCA). O gerenciamento no nível da API de uma conta da MCA pode ser feito pelo serviço Accounts, permitindo a adição e o gerenciamento programático de subcontas. Saiba mais sobre como conseguir uma conta da MCA aqui.
Como usar a API
Não use a API como se fosse um feed de dados
Evite atualizações diárias de todo o feed de produtos ao usar o recurso products.
Em vez disso, atualize apenas os produtos cujos dados foram realmente alterados. Enviar todo o feed de dados usando o recurso products consome mais tempo e recursos para o Google e para você.
Não use a API para recuperar regularmente as informações de produtos que você enviou
Se você for responsável por manter as informações de produtos em uma conta específica do Merchant Center, evite solicitar informações de produtos da API Content usando os 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 projetar 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 dos produtos, como um banco de dados de produtos locais, e os produtos no Merchant Center precisam refletir o conteúdo dessa fonte.
Não use feeds de dados e a API Content para enviar itens de produtos
Se você estiver considerando mudar para a API para envio de itens, verifique se não está mais usando feeds de dados para enviar itens de produtos. Se você continuar enviando itens nos dois meios, poderão ocorrer resultados inesperados.
Existe uma maneira de usar APIs e feeds de dados com segurança?
É possível manipular seus feeds de dados usando o serviço de feed de dados da API. Isso vai facilitar muito o gerenciamento de feeds de dados em grande escala, mas não insira nem atualize produtos usando a API simultaneamente com os feeds, porque podem ocorrer resultados inesperados.
Outros exemplos de maneiras aceitáveis de usar feeds e API juntos incluem:
Executar 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. Isso é aceitável porque as informações do produto só são atualizadas por feeds.
Usando a API para gerenciar suas subcontas (Serviço de contas) e/ou configurações de tributos e frete no nível da conta (Serviço de tributos da conta e Serviço de configurações de frete). Como esses não são recursos que os feeds de dados podem oferecer, não há conflito com o uso da API para gerenciar essas funções.
Como faço para migrar do uso de feeds de dados para usar apenas a API ou vice-versa?
Se você usa feeds de dados e quer mudar para usar apenas a API para atualizar produtos, faça upload novamente dos dados de produtos com a API. Quando você usa o serviço products para atualizar um determinado produto, a API assume o controle das informações dele. Excluir o produto do feed de dados ou o próprio feed não remove mais as informações do produto da sua conta do Merchant Center. Verifique se não há atualizações no feed de dados se você quiser remover o produto dele ou o próprio feed. Caso contrário, o feed vai assumir a propriedade novamente, e a remoção do produto vai causar a exclusão dele.
Se você usa apenas a API para informações de produtos e quer usar feeds de dados como sua principal fonte de informações, basta adicionar o novo feed à sua conta do Merchant Center. Assim, ele vai assumir a propriedade dos produtos listados. Se houver produtos que você quer remover antes do vencimento e que foram enviados apenas pela API, exclua-os no Merchant Center ou pela API.
Como 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 de produtos enviados
pela API Content, configure outros países no feed principal da API Content
no Merchant Center ou adicione esses países extras usando o campo shipping
no recurso products.
Confira abaixo um exemplo de como modificar as configurações do feed principal da API Content.
Para mais informações, consulte: 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 do desenvolvedor para o idioma escolhido em Exemplos e bibliotecas.
Use os atributos de destino para controlar quais produtos aparecem nos diferentes programas do Shopping.
A API Content adota automaticamente as configurações padrão do feed da API Content conforme ele foi configurado no Merchant Center. Você pode usar os atributos de produto includedDestinations ou excludedDestinations para controlar a participação no programa em um nível de produto dentro de um feed ou pela API Content.
Se o feed da API estiver incluído em um programa, por exemplo, Comprar com o Google
(antes conhecido como Shopping Actions), mas você quiser excluir determinados produtos,
use o atributo excludedDestinations e especifique Shopping Actions como o
valor. Desde que não haja erros, isso vai substituir as configurações padrão do feed no Merchant Center, e o item específico não vai aparecer no Comprar com o Google (antigo Shopping Actions). Por outro lado, se o feed não estiver inscrito em um programa, como o Shopping, você poderá incluir itens individuais usando o atributo includedDestinations e Shopping_ads como valor. Assim, 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 mudar antes de expirar, 30 dias após a última atualização ou na data de validade especificada, se for antes, atualize o item para evitar a desativação. Se você precisar atualizar muitos itens porque nenhum deles mudou ou não for possível rastrear quando foram atualizados pela última vez, não atualize todos os itens ao mesmo tempo. Em vez disso, distribua a carga uniformemente em vários dias.
Não exclua o feed da API Content, ou seus produtos podem desaparecer
Na primeira vez que você fizer upload de um produto com channel:online usando a API Content, um novo feed chamado API Content vai aparecer no Merchant Center. 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 com o título API Content e um subtítulo Produtos locais. Não exclua acidentalmente o feed da API Content on-line ou local. Dependendo do feed excluído, os produtos on-line ou locais que você adicionou ao Merchant Center pela API Content serão removidos.
Agrupe 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 custombatch que contenha todas as solicitações desejadas. Assim, a latência para fazer solicitações ao endpoint da API acontece apenas uma vez para a chamada custombatch, em vez de em cada solicitação individual. Isso é especialmente importante se você estiver fazendo solicitações sequenciais.
Não envie várias atualizações para um único item em um único lote
Isso vai gerar resultados inesperados devido à incerteza quanto à sequência de atualizações e pode causar um erro de conflito.
Não enviar atualizações para itens inalterados
Envie solicitações apenas para itens de produtos novos, alterados ou excluídos, a menos que eles expirem.
Use feeds complementares se os preços e/ou a disponibilidade mudarem rapidamente
Se você estiver com dificuldade para manter o preço, a disponibilidade ou as informações de venda de um produto atualizados, use os feeds complementares no recurso products para enviar atualizações apenas desses atributos. Como as atualizações do feed complementar são pequenas, você pode fazer muito mais atualizações desse tipo em um determinado período do que atualizações completas de produtos. Isso ajuda a manter os preços e a disponibilidade dos produtos alinhados com as páginas de destino.
Outra maneira de atualizar o preço e a disponibilidade dos produtos é usar as atualizações automáticas de itens. Isso pode ser usado além das atualizações da API para evitar incompatibilidades entre as informações no Merchant Center e nas páginas de destino do produto. No entanto, 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 é o que os desenvolvedores querem ter em mãos, já que remove a necessidade de solicitar repetidamente a autenticação do usuário, porque os tokens de acesso duram apenas 60 minutos antes de expirar.