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 ativas diretamente do navegador. Incorporado à documentação de referência, ele lida com as complexidades da autenticação do 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 baixa fricção:verifique o comportamento do endpoint e inspecione as respostas brutas da API instantaneamente 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 gerenciar 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 "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. Executar: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 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 os campos obrigatórios e as estruturas de esquema válidas.
  • Máscaras de campo:teste uma 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 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 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 e o aninhamento JSON exatos necessários para uma versão específica da API.