> 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/fr/actions/workflow-concepts/workflow-steps/seo-research/google-search-console.md).

# Google Search Console

<figure><img src="https://344527547-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>Choisissez une action Google Search Console.</p></figcaption></figure>

AirOps vous permet de vous connecter directement à votre compte Google Search Console afin d’obtenir des données précieuses sur les performances de recherche dans vos workflows, vous aidant ainsi à prendre des décisions fondées sur les données pour votre contenu.

### Comment configurer l’étape d’intégration Google Search Console

1. **Ajoutez l’étape à votre workflow**:
   * Cliquez sur le bouton "+" pour ajouter une nouvelle étape
   * Sélectionnez « Google Search Console » dans la section « Intégrations » parmi les étapes disponibles
2. **Authentification**:
   * Sélectionnez une connexion Google Search Console existante dans le menu déroulant, ou créez-en une nouvelle
3. **Type d'action**:
   * Choisissez parmi les actions disponibles suivantes :
     * **Obtenir l’aperçu des performances des requêtes**: Récupère les données de performance des requêtes de recherche qui ont mené à votre site
     * **Obtenir l’aperçu des performances des pages**: Récupère les données de performance pour des pages spécifiques de votre site
     * **Obtenir la répartition des performances requête-page**: Fournit des indicateurs détaillés de performance entre les requêtes et les pages
     * **Obtenir l’état d’indexation de la page**: Vérifie si une URL spécifique est indexée par Google et quand elle a été indexée pour la dernière fois
4. **Configurez les paramètres spécifiques à l’action**:
   * **Sélection du site**: Choisissez la propriété Google Search Console à interroger
   * **URL**: Pour les actions spécifiques à une page, saisissez l’URL que vous souhaitez analyser
   * **Période**: Pour les données de performance, sélectionnez la période parmi les options prédéfinies :
     * 7 derniers jours
     * 28 derniers jours
     * 30 derniers jours
     * 60 derniers jours
     * 90 derniers jours
     * 3 derniers mois
     * Plage de dates personnalisée
5. **Les formats de sortie varient selon le type d’action**:
   * **Performances des requêtes**: Renvoie des données comprenant le texte de la requête, les clics, les impressions, le CTR et la position dans le format JSON suivant

```
{
  "queries": [
    {
      "query": "string",  // Le texte de la requête de recherche
      "clicks": number,   // Nombre de clics provenant de cette requête
      "impressions": number,  // Nombre d’impressions pour cette requête
      "ctr": number,      // Taux de clics (format décimal)
      "position": number  // Position moyenne dans les résultats de recherche
    }
    // Plusieurs objets de requête seront renvoyés
  ]
}
```

* **Performance des pages**: Renvoie des données sur des pages spécifiques, y compris les clics, les impressions et le classement

```
{
  "clicks": {
    "L7D": number,       // Total des clics au cours des 7 derniers jours
    "L30D": number,      // Total des clics au cours des 30 derniers jours
    "WoW Change": number, // Variation des clics d’une semaine à l’autre (peut être positive ou négative)
    "MoM Change": number  // Variation des clics d’un mois à l’autre (peut être positive ou négative)
  },
  "impressions": {
    "L7D": number,       // Total des impressions au cours des 7 derniers jours
    "L30D": number,      // Total des impressions au cours des 30 derniers jours
    "WoW Change": number, // Variation des impressions d’une semaine à l’autre
    "MoM Change": number  // Variation des impressions d’un mois à l’autre
  },
  "ctr": {
    "L7D": number,       // Taux de clics moyen sur les 7 derniers jours (exprimé en pourcentage)
    "L30D": number,      // Taux de clics moyen sur les 30 derniers jours (exprimé en pourcentage)
    "WoW Change": number, // Variation du CTR d’une semaine à l’autre (points de pourcentage)
    "MoM Change": number  // Variation du CTR d’un mois à l’autre (points de pourcentage)
  },
  "position": {
    "L7D": number,       // Position moyenne dans les résultats de recherche sur les 7 derniers jours
    "L30D": number,      // Position moyenne dans les résultats de recherche sur les 30 derniers jours
    "WoW Change": number, // Variation de la position d’une semaine à l’autre (une baisse est une amélioration)
    "MoM Change": number  // Variation de la position d’un mois à l’autre (une baisse est une amélioration)
  }
}
```

* **Répartition requête-page**: Montre comment des requêtes spécifiques performent pour des pages spécifiques

```
{
  "queries": [  // Tableau d’objets de requête
    {
      "query": "string",     // Le texte de la requête de recherche spécifique analysée
      "clicks": number,      // Nombre total de clics reçus pour cette requête sur toutes les pages
      "impressions": number, // Nombre total d’impressions pour cette requête sur toutes les pages
      "ctr": number,         // Taux de clics global pour la requête (exprimé en pourcentage)
      "position": number,    // Position moyenne dans les résultats de recherche pour cette requête
      
      "ranking_pages": [     // Tableau des pages qui se classent pour cette requête
        {
          "url": "string",   // URL complète de la page classée
          "clicks": number,  // Nombre de clics que cette page spécifique a reçus pour cette requête
          "impressions": number, // Nombre d’impressions que cette page a reçues pour cette requête
          "ctr": number,     // Taux de clics spécifique à la page (exprimé en décimal)
          "position": number, // Position moyenne de cette page pour cette requête
          "clicks_percent_total": number, // Pourcentage du total des clics de la requête allant à cette page
          "impressions_percent_total": number // Pourcentage du total des impressions de la requête allant à cette page
        }
        // Plusieurs objets de page seront renvoyés, triés par clics par ordre décroissant
      ]
    },
    // Plusieurs objets de requête seront renvoyés, généralement triés par clics par ordre décroissant
  ],
  
  "metadata": {
    "start_date": "string", // Date au format ISO marquant le début de la période de rapport
    "end_date": "string",   // Date au format ISO marquant la fin de la période de rapport
    "queries": number,      // Nombre total de requêtes uniques analysées dans ce rapport
    "urls": number          // Nombre total d’URL uniques apparues dans les résultats de recherche
  }
}
```

* **État d’indexation**: Renvoie si une page est indexée, ainsi que la date de la dernière exploration dans le format JSON suivant

```
{
  "last_crawled_at": "string", // Horodatage de la dernière exploration
  "indexed": boolean           // Indique si la page est indexée
}
```


---

# 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/fr/actions/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.
