Lundi 31 janvier 2022
Nous lançons aujourd'hui la nouvelle API d'inspection d'URL de la Google Search Console, qui vous permet de bénéficier d'un accès programmatique aux données au niveau de l'URL des propriétés que vous gérez dans la Search Console.
Les API de la Search Console permettent d'accéder à des données en dehors de la Search Console, par le biais d'applications et de produits externes. Les développeurs et les outils de SEO ont déjà recours aux API pour créer des solutions personnalisées afin d'afficher, d'ajouter ou de supprimer des propriétés et des sitemaps, mais aussi pour exécuter des requêtes avancées sur les données de performances de la recherche.
Grâce à la nouvelle API d'inspection d'URL, nous pouvons proposer aux développeurs un nouvel outil de débogage et d'optimisation de leurs pages. Vous pouvez demander à obtenir les données de la Search Console sur la version indexée d'une URL. L'API renverra les informations indexées actuellement disponibles dans l'outil d'inspection d'URL.
Utiliser la nouvelle API
Pour savoir comment utiliser la nouvelle API, consultez la documentation pour les développeurs d'API. Les paramètres de requête incluent l'URL à inspecter et la propriété définie dans la Search Console.
La réponse inclut des résultats d'analyse contenant des informations issues de la Search Console, y compris l'état d'indexation, les pages AMP, les résultats enrichis et l'ergonomie mobile. Pour en savoir plus, consultez la liste des paramètres et l'explication des résultats de l'URL indexée.
À l'issue de l'appel d'API, vous recevrez une réponse contenant tous les résultats pertinents ou un message d'erreur si la requête a échoué. Si un résultat d'analyse spécifique ne figure pas dans la réponse, cela signifie que l'analyse n'était pas disponible pour l'URL inspectée. Voici un exemple de réponse de l'API :
{
"inspectionResult": {
"inspectionResultLink": "https://search.google.com/search-console/inspect?resource_id=https://developers.google.com/search/&id=odaUL5Dqq3q8n0EicQzawg&utm_medium=link",
"indexStatusResult": {
"verdict": "PASS",
"coverageState": "Indexed, not submitted in sitemap",
"robotsTxtState": "ALLOWED",
"indexingState": "INDEXING_ALLOWED",
"lastCrawlTime": "2022-01-31T08:39:51Z",
"pageFetchState": "SUCCESSFUL",
"googleCanonical": "https://developers.google.com/search/help/site-appearance-faq",
"userCanonical": "https://developers.google.com/search/help/site-appearance-faq",
"referringUrls": [
"https://developers.google.com/search/updates",
"https://developers.google.com/search/help/crawling-index-faq"
],
"crawledAs": "MOBILE"
},
"mobileUsabilityResult": {
"verdict": "PASS"
},
"richResultsResult": {
"verdict": "PASS",
"detectedItems": [
{
"richResultType": "Breadcrumbs",
"items": [
{
"name": "Unnamed item"
}
]
},
{
"richResultType": "FAQ",
"items": [
{
"name": "Unnamed item"
}
]
}
]
}
}
}
Cas d'utilisation possibles
Lors de la conception de cette nouvelle API, nous avons demandé à divers référenceurs et éditeurs comment ils comptaient l'utiliser et exploiter ces données pour concevoir leurs solutions. Voici quelques cas d'utilisation intéressants :
- Les agences et les outils de SEO peuvent surveiller en permanence les pages importantes et proposer des options de débogage sur une seule page. Par exemple, il est possible de vérifier s'il existe des différences entre les pages canoniques sélectionnées par Google et celles déclarées par l'utilisateur, ou de corriger les problèmes de données structurées à partir d'un groupe de pages.
- Les développeurs de CMS et de plug-ins peuvent ajouter des insights au niveau d'une page ou d'un modèle, ainsi que des vérifications continues des pages actuelles. Par exemple, il est possible de surveiller l'historique des modifications apportées aux pages clés afin de diagnostiquer les problèmes et de hiérarchiser les correctifs.
Limites d'utilisation
Vous trouverez une description plus détaillée des limites d'utilisation des API de la Search Console dans la documentation destinée aux développeurs. Le quota de l'API d'inspection d'URL est appliqué par propriété de site Web Search Console (appels interrogeant le même site) :
- 2 000 requêtes par jour
- 600 requêtes par minute
Commentaires
Grâce aux données de la recherche Google, nous sommes convaincus que cette nouvelle API offrira à l'écosystème de nouvelles capacités d'innovation. Nous sommes toujours ravis de découvrir les solutions conçues par les développeurs et les référenceurs à l'aide des API de la Search Console.
Si vous avez des questions ou des commentaires, n'hésitez pas à nous contacter sur Twitter ou dans la communauté Search Central.