Neste documento, você encontra diretrizes de práticas recomendadas. Consulte Dicas de desempenho para mais informações.
Quando usar a API
Para enviar solicitações de maneira programática
Se você prefere automatizar todas as partes do fluxo de trabalho ou criar um gancho para seu sistema de ERP (Enterprise Resource Planning), a API Content permite que você envie atualizações assim que seu 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 depois que os feeds de dados são processados. Espera-se uma latência de cinco a dez segundos para grandes solicitações em lote.
Para alterar os dados do produto com frequência
Com a API Content, é possível fazer atualizações incrementais no seu inventário de produtos dinâmico várias vezes ao dia. No entanto, não é possível enviar todo o feed de dados todas as vezes. Se as atualizações ficarem disponíveis individualmente, envie-as individualmente, não espere até que haja várias atualizações para agrupá-las. 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 recém-criadas do Merchant Center são contas únicas que mantêm um conjunto próprio de dados de produtos. Isso funciona bem na maioria dos casos, mas, à medida que sua conta cresce, talvez você descubra que precisa 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 da MCA pode ser feito pelo serviço de contas e permite a adição e o gerenciamento programáticos de subcontas. Confira mais informações sobre como conseguir uma MCA aqui.
Como usar a API
Não use a API como você usaria 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 que realmente
foram alterados. O envio de todo o feed de dados pelo products consome mais
tempo e recursos para o Google e para você.
Não use a API para recuperar regularmente informações de produtos enviadas por você
Se você for responsável por manter as informações do produto em uma
conta específica do Merchant Center, evite solicitar informações do
produto pela API Content usando os métodos
products.get
ou
products.list
com frequência. 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 se destinam à recuperação regular de
informações do produto 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 fonte.
Não use feeds de dados e a API Content para enviar itens de produtos ao mesmo tempo
Se você está pensando em mudar para a API de envio de itens, verifique se não está mais usando feeds de dados para enviar itens de produtos. Se você continuar enviando itens nas duas mídias, resultados inesperados poderão ocorrer.
Existe uma maneira de usar a API e os feeds de dados juntos de forma segura?
Você pode manipular seus feeds de dados usando o serviço Datafeed da API. Embora isso facilite muito o gerenciamento de feeds de dados em grande escala, lembre-se de que você não deve inserir ou atualizar produtos usando a API simultaneamente com feeds, já que podem ocorrer resultados inesperados.
Alguns outros exemplos de maneiras aceitáveis de usar feeds e API em conjunto 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 dos produtos; Isso é aceitável porque as informações do produto só são atualizadas por feeds.
Usar a API para gerenciar suas subcontas (Serviço de contas) e/ou as configurações de tributos e frete no nível da conta (Serviço Accounttax e Serviço Shippingsettings). Essas não são funções que o Datafeeds pode fornecer, portanto, 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 passar a usar apenas a API para atualizar produtos, faça um novo upload dos dados do produto com a API. Quando você usa o serviço de produtos para atualizar um determinado produto, a API assume o controle das informações do produto. Além disso, excluir o produto do feed de dados ou excluir o próprio feed de dados não remove mais as informações do produto da sua conta do Merchant Center. Certifique-se de que não há atualizações do 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 voltará a assumir a propriedade e a remoção do produto do feed fará com que o produto seja removido.
Se atualmente você usa apenas a API para informações do produto e quer usar os 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 enviados somente pela API antes que expirem, exclua-os no Merchant Center ou usando a API.
Como faço para segmentar vários países com produtos que usam 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 outros países pelo 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: 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 de compras.
A API Content adota automaticamente as configurações padrão para seu feed da API Content, conforme definido no Merchant Center. Você pode usar os atributos do produto includedDestinations ou excludedDestinations para controlar a participação no programa no nível do produto em um feed ou pela API Content.
Se o feed de API foi ativado em um programa, por exemplo, o Comprar com o Google (antigo Ações de Shopping), mas você quer excluir determinados produtos, use o atributo excludedDestinations e especifique Shopping Actions como o valor. Se não houver erros, as configurações padrão de feed no Merchant Center serão substituídas, e esse item específico não será exibido no Comprar com o Google (anteriormente conhecido como Shopping Actions). Por outro lado, se o seu feed não foi incluído em um programa (por exemplo, o Shopping), é possível incluir itens individuais usando o atributo includedDestinations e Shopping_ads como o valor, e o item será exibido 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ê precisar atualizar muitos itens, porque nenhum deles foi alterado ou você não consegue rastrear quando eles foram atualizados pela última vez, não atualize todos os itens ao mesmo tempo, mas espalhe a carga uniformemente ao longo de vários dias.
Não exclua o feed da API Content para que seus produtos desapareçam.
Na primeira vez que você fizer upload de um produto com channel:online pela API Content, um novo feed vai aparecer no Merchant Center chamado API Content. Na primeira vez que você fizer upload de um produto com channel:local pela API Content, um novo feed vai aparecer no Merchant Center chamado API Content com um subtítulo 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 locais 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 de lote personalizado
Em vez de fazer muitas solicitações sequenciais ou paralelas para o mesmo serviço, faça uma única solicitação em lote personalizado que contenha 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 de 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 vai gerar resultados inesperados devido à incerteza sobre a sequência das atualizações e pode causar um erro de conflito.
Não enviar atualizações para itens inalterados
Envie apenas solicitações de itens de produtos novos, alterados ou excluídos, a menos que eles expirem de outra forma.
Use feeds complementares se os preços e/ou a disponibilidade mudarem rapidamente
Se você tiver problemas para manter atualizadas as informações de preço, disponibilidade ou promoção de um produto, use os feeds complementares no recurso products para enviar atualizações apenas para esses atributos. Como as atualizações de feed complementar são pequenas, você pode fazer muito mais atualizações de feed complementar em um determinado período do que atualizações completas do produto. Isso 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 as atualizações automáticas de itens. Isso pode ser usado em conjunto com as atualizações da API para ajudar a evitar incompatibilidades entre as informações no Merchant Center e as informações nas páginas de destino do produto. No entanto, lembre-se de que isso foi criado para corrigir pequenos problemas com a precisão do preço e da disponibilidade do produto. Portanto, as atualizações automáticas de itens não substituem o envio das informações corretas por meio da 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 ter, 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.