Exécute l'analyse PageSpeed sur la page à l'URL spécifiée, renvoie les résultats PageSpeed, affiche une liste de suggestions pour accélérer le chargement de la page, ainsi que d'autres informations. Essayer maintenant
Requête
Requête HTTP
GET https://www.googleapis.com/pagespeedonline/v4/runPagespeed
Paramètres
Nom du paramètre | Valeur | Description |
---|---|---|
Paramètres de requête requis | ||
url |
string |
URL à extraire et à analyser |
Paramètres de requête facultatifs | ||
filter_third_party_resources |
boolean |
Indique si les ressources tierces doivent être filtrées avant l'analyse PageSpeed Insights.
(Par défaut : false )
|
locale |
string |
Paramètres régionaux utilisés pour localiser les résultats mis en forme. |
rule |
string |
Une règle PageSpeed à exécuter ; si aucune n'est indiquée, toutes les règles sont exécutées. |
screenshot |
boolean |
Indique si les données binaires contenant une capture d'écran doivent être incluses (par défaut: false )
|
snapshots |
boolean |
Indique si les données binaires contenant des instantanés doivent être incluses (par défaut: false )
|
strategy |
string |
Stratégie d'analyse (ordinateur ou mobile) à utiliser, ordinateur utilisé par défaut
Valeurs acceptées :
|
utm_campaign |
string |
Nom de la campagne à des fins d'analyse. |
utm_source |
string |
Source de la campagne pour les données analytiques. |
Corps de la requête
Ne spécifiez pas de corps de requête pour cette méthode.
Réponse
Si la requête aboutit, cette méthode renvoie un corps de réponse présentant la structure suivante :
{ "captchaResult": string, "kind": "pagespeedonline#result", "id": string, "responseCode": integer, "title": string, "ruleGroups": { (key): { "score": integer, "pass": boolean } }, "loadingExperience": { "id": string, "metrics": { (key): { "median": integer, "distributions": [ { "min": integer, "max": integer, "proportion": double } ], "category": string } }, "overall_category": string, "initial_url": string }, "pageStats": { "numberResources": integer, "numberHosts": integer, "totalRequestBytes": long, "numberStaticResources": integer, "htmlResponseBytes": long, "textResponseBytes": long, "overTheWireResponseBytes": long, "cssResponseBytes": long, "imageResponseBytes": long, "javascriptResponseBytes": long, "flashResponseBytes": long, "otherResponseBytes": long, "numberJsResources": integer, "numberCssResources": integer, "numberRobotedResources": integer, "numberTransientFetchFailureResources": integer, "numTotalRoundTrips": integer, "numRenderBlockingRoundTrips": integer, "robotedUrls": [ string ], "transientFetchFailureUrls": [ string ], "cms": string }, "formattedResults": { "locale": string, "ruleResults": { (key): { "localizedRuleName": string, "ruleImpact": double, "beta": boolean, "groups": [ string ], "summary": { "format": string, "args": [ { "type": string, "key": string, "value": string, "rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ], "secondary_rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ] } ] }, "urlBlocks": [ { "header": { "format": string, "args": [ { "type": string, "key": string, "value": string, "rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ], "secondary_rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ] } ] }, "urls": [ { "result": { "format": string, "args": [ { "type": string, "key": string, "value": string, "rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ], "secondary_rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ] } ] }, "details": [ { "format": string, "args": [ { "type": string, "key": string, "value": string, "rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ], "secondary_rects": [ { "left": integer, "top": integer, "width": integer, "height": integer } ] } ] } ] } ] } ] } } }, "version": { "major": integer, "minor": integer }, "invalidRules": [ string ], "screenshot": { "key": string, "mime_type": string, "data": bytes, "width": integer, "height": integer, "page_rect": { "left": integer, "top": integer, "width": integer, "height": integer } }, "snapshots": [ { "key": string, "mime_type": string, "data": bytes, "width": integer, "height": integer, "page_rect": { "left": integer, "top": integer, "width": integer, "height": integer } } ] }
Nom de propriété | Valeur | Description | Remarques |
---|---|---|---|
captchaResult |
string |
Résultat de validation du captcha
Les valeurs possibles sont :
|
|
kind |
string |
Type de résultat. | |
id |
string |
URL finale canonique et canonique du document, après les redirections de page suivantes (le cas échéant). | |
responseCode |
integer |
Code de réponse pour le document. 200 indique un chargement de page normal. 4xx/5xx indique une erreur. | |
title |
string |
Titre de la page, tel qu'il apparaît dans la barre de titre du navigateur. | |
ruleGroups |
object |
Un mappage avec une entrée pour chaque groupe de règles dans ces résultats. | |
ruleGroups.(key) |
object |
Nom de ce groupe de règles : "SPEED", "USABILITY" ou "SAFE" (SÉCURITÉ). | |
ruleGroups.(key).score |
integer |
Score (0 à 100) pour ce groupe de règles, qui indique dans quelle mesure une page pourrait être meilleure dans cette catégorie (par exemple, quelle est la vitesse, le niveau d'utilisation ou le niveau de sécurité le plus élevé). Un score élevé indique qu’il y a peu de marge de progression, tandis qu’un score faible indique une marge d’amélioration supplémentaire. | |
ruleGroups.(key).pass |
boolean |
||
loadingExperience |
object |
Métriques sur l'expérience des utilisateurs finaux lors du chargement des pages. | |
loadingExperience.id |
string |
URL, format ou origine sur lesquels se trouvent les métriques. | |
loadingExperience.metrics |
object |
||
loadingExperience.metrics.(key) |
object |
Type de métrique. | |
loadingExperience.metrics.(key).median |
integer |
||
loadingExperience.metrics.(key).distributions[] |
list |
||
loadingExperience.metrics.(key).distributions[].min |
integer |
||
loadingExperience.metrics.(key).distributions[].max |
integer |
||
loadingExperience.metrics.(key).distributions[].proportion |
double |
||
pageStats |
object |
Statistiques récapitulatives de la page, telles que le nombre d'octets JavaScript ou HTML, etc. | |
pageStats.numberResources |
integer |
Nombre de ressources HTTP chargées par la page. | |
pageStats.numberHosts |
integer |
Nombre d'hôtes uniques référencés par la page. | |
pageStats.totalRequestBytes |
long |
Taille totale de tous les octets de requête envoyés par la page. | |
pageStats.numberStaticResources |
integer |
Nombre de ressources statiques (c'est-à-dire pouvant être mises en cache) sur la page. | |
pageStats.htmlResponseBytes |
long |
Nombre d'octets de réponse non compressés pour le document HTML principal et tous les iFrames de la page. | |
pageStats.textResponseBytes |
long |
Nombre d'octets de réponse non compressés pour les ressources textuelles non couvertes par d'autres statistiques (ressources non HTML, non JavaScript, non CSS) sur la page. | |
pageStats.overTheWireResponseBytes |
long |
Nombre d'octets Over The Wire. utilise la stratégie de compression gzip par défaut comme estimation. | |
pageStats.cssResponseBytes |
long |
Nombre d'octets de réponse non compressés pour les ressources CSS de la page. | |
pageStats.imageResponseBytes |
long |
Nombre d'octets de réponse pour les ressources d'image sur la page. | |
pageStats.javascriptResponseBytes |
long |
Nombre d'octets de réponse non compressés pour les ressources JS sur la page. | |
pageStats.flashResponseBytes |
long |
Nombre d'octets de réponse pour les ressources Flash sur la page. | |
pageStats.otherResponseBytes |
long |
Nombre d'octets de réponse pour les autres ressources de la page. | |
pageStats.numberJsResources |
integer |
Nombre de ressources JavaScript référencées par la page. | |
pageStats.numberCssResources |
integer |
Nombre de ressources CSS référencées par la page. | |
pageStats.numberRobotedResources |
integer |
Nombre de ressources robotisées. | |
pageStats.numberTransientFetchFailureResources |
integer |
Nombre de ressources ayant échoué temporairement. | |
pageStats.numTotalRoundTrips |
integer |
Les allers-retours nécessaires pour charger la page entière | |
pageStats.numRenderBlockingRoundTrips |
integer |
Aller-retours nécessaires pour charger les ressources qui bloquent le rendu | |
pageStats.robotedUrls[] |
list |
Liste des URL robotisées. | |
pageStats.transientFetchFailureUrls[] |
list |
Liste des URL d'échec de récupération temporaires. | |
pageStats.cms |
string |
Système de gestion de contenu (CMS) utilisé pour la page
Valeurs acceptées :
|
|
formattedResults |
object |
Résultats localisés de PageSpeed Contient une entrée rulesResults pour chaque règle PageSpeed instanciée et exécutée par le serveur. | |
formattedResults.locale |
string |
Paramètres régionaux de formattedResults, par exemple "en_US". | |
formattedResults.ruleResults |
object |
Dictionnaire des résultats des règles mises en forme, avec une entrée pour chaque règle PageSpeed Instanciée et exécutée par le serveur. | |
formattedResults.ruleResults.(key) |
object |
Identifiant de type énumération pour cette règle. Par exemple, "EnableKeepAlive" ou "preventCssImport". Non localisé. | |
formattedResults.ruleResults.(key).localizedRuleName |
string |
Nom localisé de la règle, destiné à être présenté à un utilisateur. | |
formattedResults.ruleResults.(key).ruleImpact |
double |
L'impact (valeur à virgule flottante illimitée) de l'application des suggestions pour cette règle sur l'accélération de la page. L'impact est comparable entre les règles afin d'identifier les suggestions de règles qui auraient un impact plus ou moins élevé sur le chargement plus rapide d'une page. Par exemple, si l'activation de la compression permet d'économiser 1 Mo, alors que l'optimisation des images permet d'économiser 500 Ko, la règle d'activation de la compression aurait un impact deux fois supérieur à celui de la règle d'optimisation des images, toutes choses égales par ailleurs. | |
formattedResults.ruleResults.(key).beta |
boolean |
Indique si cette règle est en version bêta. Les règles en version bêta sont de nouvelles règles en cours de test et n'ont aucune incidence sur le score global. | |
formattedResults.ruleResults.(key).groups[] |
list |
Liste des groupes de règles auxquels cette règle appartient. Chaque entrée de la liste est associée à l'une des valeurs suivantes : "SPEED", "USABILITY" ou "SAFE" (SÉCURITÉ). | |
formattedResults.ruleResults.(key).summary |
nested object |
Brève description de la règle, indiquant de manière générale ce qu'il faut faire pour s'y conformer et les avantages qu'elle peut en retirer. | |
formattedResults.ruleResults.(key).summary.format |
string |
Chaîne de format localisée avec des espaces réservés , où "FOO" est la clé de l'argument dont la valeur doit être substituée. Pour les arguments HYPERLINK, la chaîne de format contiendra à la place et pour l'argument avec la clé "FOO". | |
formattedResults.ruleResults.(key).summary.args[] |
list |
Liste des arguments de la chaîne de format. | |
formattedResults.ruleResults.(key).summary.args[].type |
string |
Type d'argument. Indiquez URL, STRING_LITERAL, INT_LITERAL, BYTES, DURATION, VERBATIM_STRING, PERCENTAGE, HYPERLINK ou SNAPSHOT_RECT.
Valeurs acceptées :
|
|
formattedResults.ruleResults.(key).summary.args[].key |
string |
Clé d'espace réservé pour cet argument, sous forme de chaîne. | |
formattedResults.ruleResults.(key).summary.args[].value |
string |
Valeur d'argument sous forme de chaîne localisée. | |
formattedResults.ruleResults.(key).summary.args[].rects[] |
list |
Rectangles d'écran auxquels il est fait référence, dont les dimensions sont mesurées en pixels CSS. Cette fonction n'est utilisée que pour les arguments SNAPSHOT_RECT. Si cet argument est absent pour un argument SNAPSHOT_RECT, cela signifie que cet argument fait référence à l'intégralité de l'instantané. | |
formattedResults.ruleResults.(key).summary.args[].rects[].left |
integer |
||
formattedResults.ruleResults.(key).summary.args[].rects[].top |
integer |
||
formattedResults.ruleResults.(key).summary.args[].rects[].width |
integer |
||
formattedResults.ruleResults.(key).summary.args[].rects[].height |
integer |
||
formattedResults.ruleResults.(key).summary.args[].secondary_rects[] |
list |
Rectangles d'écran secondaires indiqués, dont les dimensions sont mesurées en pixels CSS. Cette fonction n'est utilisée que pour les arguments SNAPSHOT_RECT. | |
formattedResults.ruleResults.(key).summary.args[].secondary_rects[].left |
integer |
||
formattedResults.ruleResults.(key).summary.args[].secondary_rects[].top |
integer |
||
formattedResults.ruleResults.(key).summary.args[].secondary_rects[].width |
integer |
||
formattedResults.ruleResults.(key).summary.args[].secondary_rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[] |
list |
Liste de blocs d'URL. Chaque bloc peut contenir un en-tête et une liste d'URL. Chaque URL peut inclure des informations supplémentaires. | |
formattedResults.ruleResults.(key).urlBlocks[].header |
nested object |
Titre à afficher avec la liste des URL. | |
formattedResults.ruleResults.(key).urlBlocks[].header.format |
string |
Chaîne de format localisée avec des espaces réservés , où "FOO" est la clé de l'argument dont la valeur doit être substituée. Pour les arguments HYPERLINK, la chaîne de format contiendra à la place et pour l'argument avec la clé "FOO". | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[] |
list |
Liste des arguments de la chaîne de format. | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[].type |
string |
Type d'argument. Indiquez URL, STRING_LITERAL, INT_LITERAL, BYTES, DURATION, VERBATIM_STRING, PERCENTAGE, HYPERLINK ou SNAPSHOT_RECT.
Valeurs acceptées :
|
|
formattedResults.ruleResults.(key).urlBlocks[].header.args[].key |
string |
Clé d'espace réservé pour cet argument, sous forme de chaîne. | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[].value |
string |
Valeur d'argument sous forme de chaîne localisée. | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[].rects[] |
list |
Rectangles d'écran auxquels il est fait référence, dont les dimensions sont mesurées en pixels CSS. Cette fonction n'est utilisée que pour les arguments SNAPSHOT_RECT. Si cet argument est absent pour un argument SNAPSHOT_RECT, cela signifie que cet argument fait référence à l'intégralité de l'instantané. | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[].rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].secondary_rects[] |
list |
Rectangles d'écran secondaires indiqués, dont les dimensions sont mesurées en pixels CSS. Cette fonction n'est utilisée que pour les arguments SNAPSHOT_RECT. | |
formattedResults.ruleResults.(key).urlBlocks[].header.args[].secondary_rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].secondary_rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].secondary_rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].header.args[].secondary_rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[] |
list |
Liste d'entrées qui fournissent des informations sur les URL dans le bloc d'URL. Facultatif. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result |
nested object |
Chaîne de format fournissant des informations sur l'URL et une liste d'arguments pour cette chaîne de format. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.format |
string |
Chaîne de format localisée avec des espaces réservés , où "FOO" est la clé de l'argument dont la valeur doit être substituée. Pour les arguments HYPERLINK, la chaîne de format contiendra à la place et pour l'argument avec la clé "FOO". | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[] |
list |
Liste des arguments de la chaîne de format. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].type |
string |
Type d'argument. Indiquez URL, STRING_LITERAL, INT_LITERAL, BYTES, DURATION, VERBATIM_STRING, PERCENTAGE, HYPERLINK ou SNAPSHOT_RECT.
Valeurs acceptées :
|
|
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].key |
string |
Clé d'espace réservé pour cet argument, sous forme de chaîne. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].value |
string |
Valeur d'argument sous forme de chaîne localisée. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].rects[] |
list |
Rectangles d'écran auxquels il est fait référence, dont les dimensions sont mesurées en pixels CSS. Cette fonction n'est utilisée que pour les arguments SNAPSHOT_RECT. Si cet argument est absent pour un argument SNAPSHOT_RECT, cela signifie que cet argument fait référence à l'intégralité de l'instantané. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].secondary_rects[] |
list |
Rectangles d'écran secondaires indiqués, dont les dimensions sont mesurées en pixels CSS. Cette fonction n'est utilisée que pour les arguments SNAPSHOT_RECT. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].secondary_rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].secondary_rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].secondary_rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].result.args[].secondary_rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[] |
list |
Liste d'entrées qui fournissent des détails supplémentaires sur une seule URL. Facultatif. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].format |
string |
Chaîne de format localisée avec des espaces réservés , où "FOO" est la clé de l'argument dont la valeur doit être substituée. Pour les arguments HYPERLINK, la chaîne de format contiendra à la place et pour l'argument avec la clé "FOO". | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[] |
list |
Liste des arguments de la chaîne de format. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].type |
string |
Type d'argument. Indiquez URL, STRING_LITERAL, INT_LITERAL, BYTES, DURATION, VERBATIM_STRING, PERCENTAGE, HYPERLINK ou SNAPSHOT_RECT.
Valeurs acceptées :
|
|
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].key |
string |
Clé d'espace réservé pour cet argument, sous forme de chaîne. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].value |
string |
Valeur d'argument sous forme de chaîne localisée. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].rects[] |
list |
Rectangles d'écran auxquels il est fait référence, dont les dimensions sont mesurées en pixels CSS. Cette fonction n'est utilisée que pour les arguments SNAPSHOT_RECT. Si cet argument est absent pour un argument SNAPSHOT_RECT, cela signifie que cet argument fait référence à l'intégralité de l'instantané. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].rects[].height |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].secondary_rects[] |
list |
Rectangles d'écran secondaires indiqués, dont les dimensions sont mesurées en pixels CSS. Cette fonction n'est utilisée que pour les arguments SNAPSHOT_RECT. | |
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].secondary_rects[].left |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].secondary_rects[].top |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].secondary_rects[].width |
integer |
||
formattedResults.ruleResults.(key).urlBlocks[].urls[].details[].args[].secondary_rects[].height |
integer |
||
version |
object |
Version de PageSpeed utilisée pour générer ces résultats. | |
version.major |
integer |
Numéro de version majeure de PageSpeed utilisé pour générer ces résultats. | |
version.minor |
integer |
Numéro de version mineure de PageSpeed utilisé pour générer ces résultats. | |
invalidRules[] |
list |
Liste des règles spécifiées dans la requête, mais que le serveur n'a pas su instancier. | |
screenshot |
nested object |
Capture d'écran de la page analysée, encodée au format Base64. | |
screenshot.key |
string |
Clé de chaîne unique, le cas échéant, identifiant cette image. | |
screenshot.mime_type |
string |
Type MIME des données d'image (par exemple, "image/jpeg"). | |
screenshot.data |
bytes |
Données d'image encodées en base64. | |
screenshot.width |
integer |
Largeur de la capture d'écran en pixels. | |
screenshot.height |
integer |
Hauteur de la capture d'écran en pixels. | |
screenshot.page_rect |
object |
||
screenshot.page_rect.left |
integer |
||
screenshot.page_rect.top |
integer |
||
screenshot.page_rect.width |
integer |
||
screenshot.page_rect.height |
integer |
||
snapshots[] |
list |
Captures d'écran supplémentaires de la page encodées en base64, dans différents états d'affichage partiel. | |
snapshots[].key |
string |
Clé de chaîne unique, le cas échéant, identifiant cette image. | |
snapshots[].mime_type |
string |
Type MIME des données d'image (par exemple, "image/jpeg"). | |
snapshots[].data |
bytes |
Données d'image encodées en base64. | |
snapshots[].width |
integer |
Largeur de la capture d'écran en pixels. | |
snapshots[].height |
integer |
Hauteur de la capture d'écran en pixels. | |
snapshots[].page_rect |
object |
||
snapshots[].page_rect.left |
integer |
||
snapshots[].page_rect.top |
integer |
||
snapshots[].page_rect.width |
integer |
||
snapshots[].page_rect.height |
integer |
||
loadingExperience.metrics.(key).category |
string |
Valeurs acceptées :
|
|
loadingExperience.overall_category |
string |
Valeurs acceptées :
|
|
loadingExperience.initial_url |
string |
Essayer
Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.