API Explorer do Google Ads

O APIs Explorer do Google Ads é um ambiente de execução interativo que permite criar e enviar solicitações de API ativas diretamente do navegador. Incorporado à documentação de referência, ele processa 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

  • Testes 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 baixa fricção:verifique o comportamento do endpoint e inspecione as respostas brutas da API imediatamente antes de implementar a lógica no 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 do Credential Manager.

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 necessários, como customerId, e expanda Cabeçalhos para fornecer cabeçalhos HTTP opcionais, como login-customer-id (necessário apenas ao acessar uma conta por uma conta de administrador). Observe que os tokens de desenvolvedor (developer-token) foram desativados em 9 de setembro de 2026 e são ignorados pelos servidores de API, embora você ainda possa 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 para 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 ativa:realize operações search e mutate em tempo real nas suas contas de produção ou de teste.
  • Formatação de payload JSON:crie objetos JSON complexos de forma interativa para solicitações, com a ferramenta destacando campos obrigatórios e estruturas de esquema válidas.
  • Máscaras de campo:teste a lógica update_mask para conferir o comportamento das atualizações parciais de recursos na prática.
  • Inspeção de erros:confira mensagens de erro e códigos 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 APIs Explorer.

Exemplos de casos de uso

  • Auditar as configurações da conta: recupere rapidamente as configurações no nível da conta ou metadados executando uma solicitação GoogleAdsService/Search no recurso customer.
  • Testar mutações:verifique se a criação de uma campanha ou a atualização de um orçamento foi bem-sucedida 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 verificar se a estrutura JSON retornada corresponde às expectativas do 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.