> 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

<figure><img src="https://31915162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-1ed49106073317360f4ea5b6d23c5c81d3f0a52e%2Fgsc-step-01-actions.png?alt=media" alt="Google Search Console Integration step with the Action dropdown listing the query and page performance actions and Get Page Indexing Status"><figcaption><p>Escolha uma ação do Google Search Console.</p></figcaption></figure>

A 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 o passo de integração do Google Search Console

1. **Adicione o passo ao seu fluxo de trabalho**:
   * Clique no botão "+" para adicionar um novo passo
   * Selecione "Google Search Console" na seção "Integrações" entre os passos 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 da página da consulta**: Fornece métricas detalhadas de desempenho entre consultas e páginas
     * **Obter status de indexação da página**: Verifica se uma URL específica está indexada pelo Google e quando foi indexada pela última vez
4. **Configure 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 a 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 da consulta**: Retorna dados incluindo o 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 para esta consulta
      "ctr": number,      // Taxa de cliques (formato decimal)
      "position": number  // Posição média nos resultados de pesquisa
    }
    // Vários objetos de consulta serão retornados
  ]
}
```

* **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 semana a semana nos cliques (pode ser positiva ou negativa)
    "MoM Change": number  // Variação mês a mês 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 semana a semana nas impressões
    "MoM Change": number  // Variação mês a mês nas impressões
  },
  "ctr": {
    "L7D": number,       // Taxa média de cliques nos últimos 7 dias (expressa em percentual)
    "L30D": number,      // Taxa média de cliques nos últimos 30 dias (expressa em percentual)
    "WoW Change": number, // Variação semana a semana na CTR (pontos percentuais)
    "MoM Change": number  // Variação mês a mês 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 semana a semana na posição (variação negativa é uma melhoria)
    "MoM Change": number  // Variação mês a mês na posição (variação negativa é uma melhoria)
  }
}
```

* **Detalhamento da página da consulta**: Mostra como consultas específicas se comportam para páginas específicas

```
{
  "queries": [  // Array de objetos de consulta
    {
      "query": "string",     // O texto específico da consulta de pesquisa que está sendo analisado
      "clicks": number,      // Total de cliques recebidos desta consulta em todas as páginas
      "impressions": number, // Total de impressões para esta consulta em todas as páginas
      "ctr": number,         // Taxa geral de cliques da consulta (expressa em percentual)
      "position": number,    // Posição média nos resultados de pesquisa para esta consulta
      
      "ranking_pages": [     // Array de páginas que ranqueiam para esta consulta
        {
          "url": "string",   // URL completa da página ranqueada
          "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 em 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
        }
        // Vários objetos de página serão retornados, ordenados por cliques em ordem decrescente
      ]
    },
    // Vários objetos de consulta serão retornados, normalmente ordenados por cliques em ordem decrescente
  ],
  
  "{
    "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=<question>&goal=<user_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.
