API Explorer do Google Ads

O APIs Explorer da API Google Ads é um ambiente de execução interativo que permite criar e enviar solicitações de API em tempo real diretamente do seu navegador. Incorporado à documentação de referência, ele 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 em tempo real (leitura e gravação) diretamente da documentação sem configurar um ambiente de desenvolvimento local.
  • Descoberta de protocolo: veja a estrutura exata das solicitações e respostas HTTP para entender como a API se comporta.
  • Prototipagem 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 os fluxos do OAuth 2.0 automaticamente, permitindo que você se concentre na solicitação de API, em vez de no Credential Manager.

Primeiros passos

  1. Acesse 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). Os tokens de desenvolvedor (developer-token) foram desativados em 9 de setembro de 2026 e são ignorados pelos servidores de API, mas você ainda pode inserir um valor se solicitado pelo formulário.
    • 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 exibe a solicitação HTTP completa e a resposta JSON em tempo real 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 objetos JSON complexos de forma interativa para solicitações, com a ferramenta destacando os campos obrigatórios e as 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: confira mensagens de erro e códigos detalhados (como QUERY_ERROR ou AUTHENTICATION_ERROR) na resposta bruta para facilitar a depuração.
  • 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 ou os metadados no nível da conta 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 a 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 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.