Os testes são uma etapa importante na criação de uma integração bem-sucedida da API Google Ads, seja para começar, manter um app ou adicionar 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 e de produção
As contas de teste estão disponíveis para fins de desenvolvimento. Com contas de teste, você pode 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 impedem que você teste alguns recursos na 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 do Explorer (Explorer, Básico ou Padrão) para
chamar uma conta de produção. O acesso do Explorer 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
Explorer), que exigem acesso Básico ou Padrão. A tentativa de 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 da v25 ou
AuthorizationError.ACTION_NOT_PERMITTED na v24 e
versões 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
- Precisam 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, o uso delas para desenvolvimento exige mais cuidado. 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 as contas de teste não puderem ser usadas.
Portanto, para fazer testes completos da integração, você provavelmente precisará 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 separadas 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. Confira se você concedeu os níveis de acesso adequados a esse usuário ou conta de serviço. Não conceda acesso a nenhuma conta de produção.
- Se você estiver usando o fluxo de autenticação do usuário 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 confirme no controle de origem.
Solicitar validação
Se você só precisar 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 (observe que
GoogleAdsService.SearchStream não oferece suporte a
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, o uso da API REST costuma ser a opção mais fácil. Consulte os exemplos de REST para saber como usar o curl ao fazer solicitações para a API REST. Além disso, tente testar no REST Explorer.