Testes

O teste é uma etapa importante na criação de uma integração bem-sucedida da API Google Ads, esteja você apenas começando, fazendo a manutenção de um aplicativo ou adicionando novos recursos a uma integração existente. Este guia apresenta algumas práticas recomendadas para testar a integração da API Google Ads.

Contas de teste

As contas de teste estão disponíveis para fins de desenvolvimento. Embora nem todos os recursos possam ser testados em uma conta de teste, essa ainda é uma ferramenta útil para validar se o código e a configuração do aplicativo estão funcionando conforme o esperado.

A produção é responsável pelo desenvolvimento

Quando as limitações da conta de teste impedem que você teste alguns recursos na integração, use uma conta de produção para o desenvolvimento. As contas de produção para desenvolvimento são diferentes das contas de teste nos seguintes aspectos:

  • Veicular anúncios que podem ser vistos pelos usuários
  • Exija URLs válidos
  • Precisa obedecer às políticas de publicidade.

Como as contas de produção veiculam anúncios, elas geram métricas que permitem testar relatórios de desempenho e desbloquear todos os outros recursos da API Google Ads.

Ao mesmo tempo, o uso deles para desenvolvimento exige muito cuidado. Recomendamos seguir estas medidas:

  • Conceda acesso apenas aos usuários que precisam dele para fins de desenvolvimento.
  • Definir um orçamento diário baixo e fixo da conta.
  • Use contas de produção para desenvolvimento somente quando não for possível usar contas de teste.

Credenciais de teste

Para minimizar o risco de modificar acidentalmente contas de produção ao tentar modificar contas de desenvolvimento, recomendamos manter um conjunto de credenciais de teste separado das credenciais do aplicativo de produção.

Também recomendamos criar tokens de atualização separados para fins de desenvolvimento.

Um token de atualização é gerado quando um usuário autoriza um app a acessar a API Google Ads em nome dele. Assim, cada token de atualização tem o mesmo acesso que o usuário autorizador. Se todos os tokens de atualização usados para acessar contas de desenvolvimento estiverem associados a usuários que não têm acesso a contas de produção, incluindo contas de administrador que gerenciam contas de produção, o risco de usar acidentalmente um token de atualização de teste para modificar uma conta de produção é reduzido.

Como o acesso depende do token de atualização usado, não é necessário criar credenciais de teste, exceto tokens de atualização de teste. O token de desenvolvedor, o ID e a chave secreta do cliente usados para acessar as contas de produção podem ser usados com segurança para acessar as contas de teste, desde que o token de atualização seja distinto.

Solicitar validação

Se você só precisa testar se uma solicitação é válida, por exemplo, para verificar se ela está estruturada corretamente e não viola as políticas, use o campo validate_only, que está disponível para solicitações GoogleAdsService.SearchStream e GoogleAdsService.Search, bem como para a maioria das solicitações de mutação. Consulte a documentação de referência para verificar se esse campo está disponível para um determinado método.

API REST

Para testes ad hoc, por exemplo, para validar que uma solicitação gera a saída esperada, o uso da API REST geralmente é a opção mais fácil. Consulte os exemplos da REST para saber como usar o cURL ao fazer solicitações à API REST.