O Criador de consultas do Google Ads é uma ferramenta interativa criada para ajudar você a criar e validar consultas usando a linguagem de consulta do Google Ads (GAQL). Seja você um usuário novo ou experiente da GAQL, o Criador de consultas pode simplificar o processo de busca dos dados exatos que você precisa da API Google Ads.
Vantagens
- Facilidade de uso:simplifica o processo de gravação de consultas GAQL sem exigir familiaridade com a sintaxe específica e os campos disponíveis.
- Capacidade de descoberta:ajuda a explorar e encontrar recursos, campos, segmentos e métricas disponíveis no modelo de dados da API Google Ads.
- Redução de erros:ao fornecer uma interface estruturada e menus suspensos de opções válidas, ela ajuda a evitar erros de sintaxe e digitação, garantindo que a consulta gerada seja válida.
- Criação de consultas mais rápida:acelera o processo de desenvolvimento automatizando a geração de strings de consulta.
- Validação:a ferramenta está vinculada ao APIs Explorer e ao Query Validator para verificar consultas em relação às regras da API antes da execução.
Como funciona
O criador de consultas do Google Ads oferece uma interface fácil de usar para montar visualmente consultas da GAQL. Este é o fluxo de trabalho básico:
- Selecione um recurso:comece escolhendo o recurso principal na guia Referência da versão que você quer consultar. Esse recurso é colocado na cláusula
FROM. Os recursos representam entidades no Google Ads, comocampaign,ad_groupoukeyword_view. O criador de consultas lista todos os recursos disponíveis. - Escolher campos:depois que um recurso é selecionado, a ferramenta mostra todos os campos selecionáveis, incluindo atributos, segmentos e métricas relacionados a esse recurso e aos recursos atribuídos (que podem ser unidos implicitamente). Você pode marcar as caixas para incluir campos na sua cláusula
SELECT. À medida que você faz seleções, a ferramenta gera dinamicamente a string de consulta GAQL correspondente, mostra erros e filtra combinações de campos incompatíveis. - Aplicar filtros:adicione condições de cláusula
WHEREpara filtrar os resultados. O criador ajuda você a escolher campos, operadores e valores, garantindo a sintaxe correta. - Ordenar resultados:especifique as ordens de classificação usando a cláusula
ORDER BY. - Definir limites:adicione uma cláusula
LIMITpara controlar o número de resultados retornados. - Validar:a ferramenta orienta você para combinações de campos válidas e também vincula ao API Explorer para que você possa testar sua consulta com os dados da conta. Há também um validador de consultas separado em que você pode colar e verificar consultas GAQL escritas manualmente.
- Exportar:quando estiver tudo pronto com sua consulta, copie e cole a string GAQL testada e sintaticamente correta nas solicitações do cliente
GoogleAdsService.SearchouSearchStream.
O criador garante que os campos, segmentos e métricas selecionados sejam compatíveis e possam ser usados juntos em uma única consulta, fazendo referência aos metadados da API Google Ads.
Primeiros passos
Há duas maneiras de acessar o criador de consultas: acesse uma página específica nos documentos de referência de relatórios ou explore a página de visão geral do criador de consultas.
Na documentação de referência de relatórios
- Comece com os documentos de referência de relatórios e escolha um recurso específico para começar na lista de todos os recursos. Como alternativa, navegue diretamente até o recurso no painel de navegação à esquerda.
- Clique em Me ajude a criar uma consulta, que leva você ao Criador de consultas para esse recurso específico.
Na página de visão geral do Criador de consultas
Acesse a seção Criador de consultas dos documentos de referência de relatórios e selecione o recurso que você quer analisar.
Integração com outras ferramentas
O Criador de consultas é integrado a outras ferramentas no kit de ferramentas para desenvolvedores da API Google Ads. Você pode usar uma consulta criada no criador de consultas e testá-la no API Explorer ou validá-la com o validador de consultas.
API Explorer
Depois de criar a consulta, clique em Testar no APIs Explorer para abrir a consulta no APIs Explorer. Sua consulta é preenchida automaticamente no corpo da solicitação. Depois, é possível testá-la executando-a nos dados da sua conta. Consulte o API Explorer para mais informações sobre essa ferramenta.
Validador de consultas
Quando você clica em Inserir ou editar uma consulta, o validador de consultas é aberto. Use o validador de consultas para validar a sintaxe da sua consulta. Qualquer consulta criada inteiramente pelo criador de consultas já tem a sintaxe correta. No entanto, se você conhece o recurso que está consultando, o validador de consultas oferece uma maneira rápida de inserir uma consulta e verificar a validade dela. Consulte o Validador de consultas para mais informações sobre essa ferramenta.