> 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
AirOps vous permet de vous connecter directement à votre compte Google Search Console pour obtenir des données précieuses sur les performances de recherche dans vos workflows, vous aidant à prendre des décisions fondées sur les données pour votre contenu.
### Comment configurer l'étape d'intégration de 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 configurez-en une nouvelle
3. **Type d’action**:
* Choisissez parmi les actions disponibles suivantes :
* **Obtenir un 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 un 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 métriques de performance détaillées 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. **Configurer les paramètres spécifiques à l'action**:
* **Sélection du site**: Choisissez quelle 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 incluant 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 d'une semaine à l'autre des clics (peut être positive ou négative)
"MoM Change": number // Variation d'un mois à l'autre des clics (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 d'une semaine à l'autre des impressions
"MoM Change": number // Variation d'un mois à l'autre des impressions
},
"ctr": {
"L7D": number, // Taux de clics moyen des 7 derniers jours (exprimé en pourcentage)
"L30D": number, // Taux de clics moyen des 30 derniers jours (exprimé en pourcentage)
"WoW Change": number, // Variation d'une semaine à l'autre du CTR (points de pourcentage)
"MoM Change": number // Variation d'un mois à l'autre du CTR (points de pourcentage)
},
"position": {
"L7D": number, // Position moyenne dans les résultats de recherche pour les 7 derniers jours
"L30D": number, // Position moyenne dans les résultats de recherche pour les 30 derniers jours
"WoW Change": number, // Variation d'une semaine à l'autre de la position (une variation négative est une amélioration)
"MoM Change": number // Variation d'un mois à l'autre de la position (une variation négative 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 de cette requête sur l'ensemble des pages
"impressions": number, // Nombre total d'impressions pour cette requête sur l'ensemble des 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 classées pour cette requête
{
"url": "string", // URL complète de la page classée
"clicks": number, // Nombre de clics reçus par cette page spécifique pour cette requête
"impressions": number, // Nombre d'impressions reçues par cette page 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 reporting
"end_date": "string", // Date au format ISO marquant la fin de la période de reporting
"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 du dernier crawl dans le format JSON suivant
```
{
"last_crawled_at": "string", // Horodatage du dernier crawl
"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=&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.
