Os testes são uma etapa importante para criar uma integração bem-sucedida com a API Google Ads, seja para começar, manter um app ou adicionar novos recursos a uma integração atual. Neste guia, apresentamos algumas práticas recomendadas para testar sua integração com a API Google Ads.
Contas de teste e de produção
As contas de teste estão disponíveis para fins de desenvolvimento. Com as contas de teste, é possível validar se o código do aplicativo e a configuração estão funcionando conforme o esperado.
No entanto, nem todos os recursos podem ser testados em uma conta de teste.
Quando as limitações da conta de teste impedirem que você teste alguns recursos na sua
integração, use uma conta de produção para o desenvolvimento. Seu
projeto do Google Cloud precisa ter pelo menos o
nível de acesso Explorer (Explorer, Basic ou Standard) para
chamar uma conta de produção. O acesso de explorador ainda restringe determinados
serviços, incluindo faturamento (BillingSetupService
e AccountBudgetProposalService),
planejamento, criação de contas e convites de usuários (consulte Restrições de recursos do
explorador), que exigem acesso básico ou
padrão. Tentar chamar uma conta de produção de um
projeto com o nível de acesso de teste retorna
AuthorizationError.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
a partir de v25 ou
AuthorizationError.ACTION_NOT_PERMITTED em v24 e
anteriores.
As contas de produção para desenvolvimento diferem das contas de teste das seguintes maneiras:
- Veicular anúncios que podem ser vistos pelos usuários
- Exigir 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 performance, além de desbloquear todos os outros recursos da API Google Ads. No entanto, é preciso ter cuidado ao usá-los para desenvolvimento. Recomendamos que você tome as seguintes medidas:
- Conceda acesso apenas aos usuários que precisam dele para fins de desenvolvimento.
- Defina um orçamento da conta diário fixo e baixo.
- Use contas de produção para desenvolvimento apenas quando não for possível usar contas de teste.
Portanto, para fazer testes completos da sua integração, é provável que você precise de credenciais de teste e de produção.
Credenciais para o 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.
Para criar um conjunto de credenciais de teste, siga estas etapas:
- Crie uma conta de e-mail (por exemplo,
api.test@example.com) ou uma conta de serviço que será usada apenas para fins de teste. - Adicione esse usuário ou conta de serviço como um usuário válido nas contas do Google Ads em que você está executando os testes. Conceda os níveis de acesso apropriados a esse usuário ou conta de serviço. Não conceda a esse usuário ou conta de serviço acesso a nenhuma conta de produção.
- Se você estiver usando o fluxo de autenticação de usuário do OAuth 2.0 em vez do fluxo da conta de serviço, gere um token de atualização para sua conta de usuário de teste.
- Use essas novas credenciais ao testar o aplicativo. O ID do cliente e a chave secreta do cliente podem ser reutilizados para fins de teste, já que não têm efeito na determinação de quais contas do Google Ads podem ser acessadas. Armazene todas as credenciais e tokens de atualização com segurança e nunca os envie para o controle de origem.
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.Search (GoogleAdsService.SearchStream não é compatível com
validate_only) e 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 se uma solicitação gera a saída esperada, usar a API REST geralmente é a opção mais fácil. Consulte os exemplos de REST para saber como usar o curl para fazer solicitações à API REST. Além disso, teste no explorador REST.