API Explorer do Google Ads

O Google Ads API Explorer é um ambiente de execução interativo que permite criar e enviar solicitações de API Google Ads ativas diretamente do navegador. Incorporada à documentação de referência, ela lida com as complexidades da autenticação OAuth 2.0 e da formatação de payload JSON, permitindo que você teste serviços e métodos específicos sem escrever uma única linha de código.

Vantagens

  • Teste sem código:execute chamadas de API ativas (leitura e gravação) diretamente da documentação sem configurar um ambiente de desenvolvimento local.
  • Descoberta de protocolo:confira a estrutura exata das solicitações e respostas HTTP para entender o comportamento da API.
  • Protótipos de baixo atrito:verifique o comportamento do endpoint e inspecione as respostas brutas da API imediatamente antes de implementar a lógica no seu aplicativo.
  • Autenticação simplificada:a ferramenta gerencia fluxos do OAuth 2.0 automaticamente, permitindo que você se concentre na solicitação de API em vez de gerenciamento de credenciais.

Primeiros passos

  1. Navegue até a documentação:acesse a Documentação de referência e selecione o serviço e o método que você quer testar, como GoogleAdsService/Search.
  2. Abra o Explorer:procure o painel Testar este método no lado direito da página.
  3. Configure a solicitação:
    • Insira os Parâmetros de solicitação obrigatórios, como customerId, e expanda Cabeçalhos para fornecer cabeçalhos HTTP opcionais, como login-customer-id (obrigatório apenas ao acessar uma conta por uma conta de administrador). Observação: os tokens de desenvolvedor (developer-token) foram desativados em 9 de setembro de 2026 e são ignorados pelos servidores de API. No entanto, você ainda pode inserir um valor se o formulário solicitar.
    • Defina o corpo da solicitação usando o editor JSON interativo se o método exigir um payload, como nas operações search ou mutate.
  4. Executar:clique em Executar para enviar a solicitação. A ferramenta mostra a solicitação HTTP completa e a resposta JSON ativa da API.

Principais recursos

  • Execução em tempo real:realize operações search e mutate em tempo real nas suas contas de produção ou de teste.
  • Formatação de payload JSON:crie de forma interativa objetos JSON complexos para solicitações. A ferramenta destaca campos obrigatórios e estruturas de esquema válidas.
  • Máscaras de campo:teste a lógica update_mask para ver como as atualizações parciais de recursos se comportam na prática.
  • Inspeção de erros:veja mensagens e códigos de erro detalhados (como QUERY_ERROR ou AUTHENTICATION_ERROR) na resposta bruta para facilitar a depuração mais rápida.
  • Exportação de código:exporte comandos curl, solicitações HTTP brutas ou exemplos de código JavaScript da visualização expandida do API Explorer.

Exemplos de casos de uso

  • Auditar as configurações da conta:recupere rapidamente as configurações ou os metadados no nível da conta executando uma solicitação GoogleAdsService/Search no recurso customer.
  • Testar mutações:verifique o sucesso da criação de uma campanha ou da atualização de um orçamento antes de implantar o código na produção.
  • Depurar GAQL:use o Explorer para executar uma string da linguagem de consulta do Google Ads (GAQL) e verifique se a estrutura JSON retornada corresponde às expectativas do seu aplicativo.
  • Verificação de protocolo:inspecione os cabeçalhos HTTP exatos e o aninhamento JSON necessários para uma versão específica da API.