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 ativas diretamente do 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.

Benefícios

  • 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 de 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 instantaneamente 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 gerenciamento de credenciais.

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 "Teste agora" no lado direito da página.
  3. Configure a solicitação:
    • Insira os parâmetros de solicitação obrigatórios, como developer-token e login-customer-id.
    • Defina o corpo da solicitação usando o editor JSON interativo se o método exigir um payload, como para operações mutate.
  4. Execute:clique em "Executar" para enviar a solicitação. A ferramenta vai mostrar 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 uma lógica update_mask para conferir o comportamento das atualizações parciais de recursos na prática.
  • Inspeção de erros:confira 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 APIs Explorer.

Exemplos de casos de uso

  • Auditar as configurações da conta:recupere rapidamente as configurações ou metadados da conta executando uma solicitação get ou search.
  • 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 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 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.