> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-steps/seo-research/google-search-console.md).
# Google Search Console
O AirOps permite que você se conecte diretamente à sua conta do Google Search Console para obter dados valiosos de desempenho de pesquisa nos seus fluxos de trabalho, ajudando você a tomar decisões orientadas por dados com o seu conteúdo.
### Como configurar a etapa de integração com o Google Search Console
1. **Adicione a etapa ao seu fluxo de trabalho**:
* Clique no botão "+" para adicionar uma nova etapa
* Selecione "Google Search Console" na seção "Integrações" entre as etapas disponíveis
2. **Autenticação**:
* Selecione uma conexão existente do Google Search Console no menu suspenso ou configure uma nova
3. **Tipo de ação**:
* Escolha entre as seguintes ações disponíveis:
* **Obter visão geral do desempenho das consultas**: Recupera dados de desempenho para consultas de pesquisa que levaram ao seu site
* **Obter visão geral do desempenho da página**: Recupera dados de desempenho para páginas específicas do seu site
* **Obter detalhamento do desempenho por consulta e página**: Fornece métricas detalhadas de desempenho entre consultas e páginas
* **Obter status de indexação da página**: Verifica se um URL específico está indexado pelo Google e quando foi indexado pela última vez
4. **Configurar parâmetros específicos da ação**:
* **Seleção do site**: Escolha qual propriedade do Google Search Console consultar
* **URL**: Para ações específicas de página, insira o URL que você deseja analisar
* **Período**: Para dados de desempenho, selecione o intervalo de tempo entre as opções predefinidas:
* Últimos 7 dias
* Últimos 28 dias
* Últimos 30 dias
* Últimos 60 dias
* Últimos 90 dias
* Últimos 3 meses
* Intervalo de datas personalizado
5. **Os formatos de saída variam de acordo com o tipo de ação**:
* **Desempenho das consultas**: Retorna dados incluindo texto da consulta, cliques, impressões, CTR e posição no seguinte formato JSON
```
{
"queries": [
{
"query": "string", // O texto da consulta de pesquisa
"clicks": number, // Contagem de cliques desta consulta
"impressions": number, // Contagem de impressões desta consulta
"ctr": number, // Taxa de cliques (formato decimal)
"position": number // Posição média nos resultados de pesquisa
}
// Serão retornados vários objetos de consulta
]
}
```
* **Desempenho da página**: Retorna dados sobre páginas específicas, incluindo cliques, impressões e classificação
```
{
"clicks": {
"L7D": number, // Total de cliques nos últimos 7 dias
"L30D": number, // Total de cliques nos últimos 30 dias
"WoW Change": number, // Variação semanal nos cliques (pode ser positiva ou negativa)
"MoM Change": number // Variação mensal nos cliques (pode ser positiva ou negativa)
},
"impressions": {
"L7D": number, // Total de impressões nos últimos 7 dias
"L30D": number, // Total de impressões nos últimos 30 dias
"WoW Change": number, // Variação semanal nas impressões
"MoM Change": number // Variação mensal nas impressões
},
"ctr": {
"L7D": number, // Taxa média de cliques dos últimos 7 dias (expressa como porcentagem)
"L30D": number, // Taxa média de cliques dos últimos 30 dias (expressa como porcentagem)
"WoW Change": number, // Variação semanal na CTR (pontos percentuais)
"MoM Change": number // Variação mensal na CTR (pontos percentuais)
},
"position": {
"L7D": number, // Posição média nos resultados de pesquisa nos últimos 7 dias
"L30D": number, // Posição média nos resultados de pesquisa nos últimos 30 dias
"WoW Change": number, // Variação semanal na posição (variação negativa é melhoria)
"MoM Change": number // Variação mensal na posição (variação negativa é melhoria)
}
}
```
* **Detalhamento por consulta e página**: Mostra como consultas específicas têm desempenho em páginas específicas
```
{
"queries": [ // Matriz de objetos de consulta
{
"query": "string", // O texto específico da consulta de pesquisa que está sendo analisada
"clicks": number, // Total de cliques recebidos desta consulta em todas as páginas
"impressions": number, // Total de impressões desta consulta em todas as páginas
"ctr": number, // Taxa geral de cliques da consulta (expressa como porcentagem)
"position": number, // Posição média nos resultados de pesquisa para esta consulta
"ranking_pages": [ // Matriz de páginas que classificam para esta consulta
{
"url": "string", // URL completa da página classificada
"clicks": number, // Número de cliques que esta página específica recebeu para esta consulta
"impressions": number, // Número de impressões que esta página recebeu para esta consulta
"ctr": number, // Taxa de cliques específica da página (expressa como decimal)
"position": number, // Posição média desta página para esta consulta
"clicks_percent_total": number, // Percentual do total de cliques da consulta que vai para esta página
"impressions_percent_total": number // Percentual do total de impressões da consulta que vai para esta página
}
// Serão retornados vários objetos de página, ordenados por cliques em ordem decrescente
]
},
// Serão retornados vários objetos de consulta, geralmente ordenados por cliques em ordem decrescente
],
"metadata": {
"start_date": "string", // Data em formato ISO que marca o início do período de relatório
"end_date": "string", // Data em formato ISO que marca o fim do período de relatório
"queries": number, // Número total de consultas únicas analisadas neste relatório
"urls": number // Número total de URLs únicas que apareceram nos resultados de pesquisa
}
}
```
* **Status de indexação**: Retorna se uma página está indexada, juntamente com a data do último rastreamento no seguinte formato JSON
```
{
"last_crawled_at": "string", // Carimbo de data/hora do último rastreamento
"indexed": boolean // Se a página está indexada
}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.airops.com/docs/pt/acoes/workflow-concepts/workflow-steps/seo-research/google-search-console.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
