docs: update docs (#916)
* fix: re-run script
* test: fix noxfile
diff --git a/docs/dyn/pagespeedonline_v5.pagespeedapi.html b/docs/dyn/pagespeedonline_v5.pagespeedapi.html
index 9df8bfe..2f125f8 100644
--- a/docs/dyn/pagespeedonline_v5.pagespeedapi.html
+++ b/docs/dyn/pagespeedonline_v5.pagespeedapi.html
@@ -75,25 +75,25 @@
<h1><a href="pagespeedonline_v5.html">PageSpeed Insights API</a> . <a href="pagespeedonline_v5.pagespeedapi.html">pagespeedapi</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
- <code><a href="#runpagespeed">runpagespeed(locale=None, url=None, utm_campaign=None, captchaToken=None, strategy=None, category=None, utm_source=None, x__xgafv=None)</a></code></p>
+ <code><a href="#runpagespeed">runpagespeed(utm_source=None, category=None, locale=None, url=None, utm_campaign=None, captchaToken=None, strategy=None, x__xgafv=None)</a></code></p>
<p class="firstline">Runs PageSpeed analysis on the page at the specified URL, and returns</p>
<h3>Method Details</h3>
<div class="method">
- <code class="details" id="runpagespeed">runpagespeed(locale=None, url=None, utm_campaign=None, captchaToken=None, strategy=None, category=None, utm_source=None, x__xgafv=None)</code>
+ <code class="details" id="runpagespeed">runpagespeed(utm_source=None, category=None, locale=None, url=None, utm_campaign=None, captchaToken=None, strategy=None, x__xgafv=None)</code>
<pre>Runs PageSpeed analysis on the page at the specified URL, and returns
PageSpeed scores, a list of suggestions to make that page faster, and other
information.
Args:
+ utm_source: string, Campaign source for analytics.
+ category: string, A Lighthouse category to run; if none are given, only Performance category
+will be run (repeated)
locale: string, The locale used to localize formatted results
url: string, The URL to fetch and analyze
utm_campaign: string, Campaign name for analytics.
captchaToken: string, The captcha token passed when filling out a captcha.
strategy: string, The analysis strategy (desktop or mobile) to use, and desktop is the
default
- category: string, A Lighthouse category to run; if none are given, only Performance category
-will be run (repeated)
- utm_source: string, Campaign source for analytics.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -103,101 +103,48 @@
An object of the form:
{ # The Pagespeed API response object.
- "lighthouseResult": { # The Lighthouse result object. # Lighthouse response for the audit url as an object.
- "lighthouseVersion": "A String", # The lighthouse version that was used to generate this LHR.
- "categories": { # The categories in a Lighthouse run. # Map of categories in the LHR.
- "seo": { # A Lighthouse category. # The Search-Engine-Optimization (SEO) category, containing all seo related
- # audits.
- "id": "A String", # The string identifier of the category.
- "manualDescription": "A String", # A description for the manual audits in the category.
- "title": "A String", # The human-friendly name of the category.
- "description": "A String", # A more detailed description of the category and its importance.
- "auditRefs": [ # An array of references to all the audit members of this category.
- { # A light reference to an audit by id, used to group and weight audits in a
- # given category.
- "weight": 3.14, # The weight this audit's score has on the overall category score.
- "id": "A String", # The audit ref id.
- "group": "A String", # The category group that the audit belongs to (optional).
+ "version": { # The Pagespeed Version object. # The version of PageSpeed used to generate these results.
+ "major": "A String", # The major version number of PageSpeed used to generate these results.
+ "minor": "A String", # The minor version number of PageSpeed used to generate these results.
+ },
+ "id": "A String", # Canonicalized and final URL for the document, after following page
+ # redirects (if any).
+ "originLoadingExperience": { # The CrUX loading experience object that contains CrUX data breakdowns. # Metrics of the aggregated page loading experience of the origin
+ "initial_url": "A String", # The requested URL, which may differ from the resolved "id".
+ "id": "A String", # The url, pattern or origin which the metrics are on.
+ "metrics": { # The map of <metrics, data>.
+ "a_key": { # A CrUX metric object for a single metric and form factor.
+ "distributions": [ # Metric distributions. Proportions should sum up to 1.
+ { # A proportion of data in the total distribution, bucketed by a min/max
+ # percentage. Each bucket's range is bounded by min <= x < max, In
+ # millisecond.
+ "proportion": 3.14, # The proportion of data in this bucket.
+ "min": 42, # Lower bound for a bucket's range.
+ "max": 42, # Upper bound for a bucket's range.
},
],
- "score": "", # The overall score of the category, the weighted average of all its audits.
- # (The category's score, can be null.)
- },
- "performance": { # A Lighthouse category. # The performance category, containing all performance related audits.
- "id": "A String", # The string identifier of the category.
- "manualDescription": "A String", # A description for the manual audits in the category.
- "title": "A String", # The human-friendly name of the category.
- "description": "A String", # A more detailed description of the category and its importance.
- "auditRefs": [ # An array of references to all the audit members of this category.
- { # A light reference to an audit by id, used to group and weight audits in a
- # given category.
- "weight": 3.14, # The weight this audit's score has on the overall category score.
- "id": "A String", # The audit ref id.
- "group": "A String", # The category group that the audit belongs to (optional).
- },
- ],
- "score": "", # The overall score of the category, the weighted average of all its audits.
- # (The category's score, can be null.)
- },
- "best-practices": { # A Lighthouse category. # The best practices category, containing all best practices related
- # audits.
- "id": "A String", # The string identifier of the category.
- "manualDescription": "A String", # A description for the manual audits in the category.
- "title": "A String", # The human-friendly name of the category.
- "description": "A String", # A more detailed description of the category and its importance.
- "auditRefs": [ # An array of references to all the audit members of this category.
- { # A light reference to an audit by id, used to group and weight audits in a
- # given category.
- "weight": 3.14, # The weight this audit's score has on the overall category score.
- "id": "A String", # The audit ref id.
- "group": "A String", # The category group that the audit belongs to (optional).
- },
- ],
- "score": "", # The overall score of the category, the weighted average of all its audits.
- # (The category's score, can be null.)
- },
- "pwa": { # A Lighthouse category. # The Progressive-Web-App (PWA) category, containing all pwa related
- # audits.
- "id": "A String", # The string identifier of the category.
- "manualDescription": "A String", # A description for the manual audits in the category.
- "title": "A String", # The human-friendly name of the category.
- "description": "A String", # A more detailed description of the category and its importance.
- "auditRefs": [ # An array of references to all the audit members of this category.
- { # A light reference to an audit by id, used to group and weight audits in a
- # given category.
- "weight": 3.14, # The weight this audit's score has on the overall category score.
- "id": "A String", # The audit ref id.
- "group": "A String", # The category group that the audit belongs to (optional).
- },
- ],
- "score": "", # The overall score of the category, the weighted average of all its audits.
- # (The category's score, can be null.)
- },
- "accessibility": { # A Lighthouse category. # The accessibility category, containing all accessibility related audits.
- "id": "A String", # The string identifier of the category.
- "manualDescription": "A String", # A description for the manual audits in the category.
- "title": "A String", # The human-friendly name of the category.
- "description": "A String", # A more detailed description of the category and its importance.
- "auditRefs": [ # An array of references to all the audit members of this category.
- { # A light reference to an audit by id, used to group and weight audits in a
- # given category.
- "weight": 3.14, # The weight this audit's score has on the overall category score.
- "id": "A String", # The audit ref id.
- "group": "A String", # The category group that the audit belongs to (optional).
- },
- ],
- "score": "", # The overall score of the category, the weighted average of all its audits.
- # (The category's score, can be null.)
+ "metricId": "A String", # Identifies the type of the metric.
+ "formFactor": "A String", # Identifies the form factor of the metric being collected.
+ "median": 42, # The median number of the metric, in millisecond.
+ "percentile": 42, # We use this field to store certain percentile value for this metric.
+ # For v4, this field contains pc50.
+ # For v5, this field contains pc90.
+ "category": "A String", # The category of the specific time metric.
},
},
+ "overall_category": "A String", # The human readable speed "category" of the id.
+ },
+ "kind": "A String", # Kind of result.
+ "captchaResult": "A String", # The captcha verify result
+ "lighthouseResult": { # The Lighthouse result object. # Lighthouse response for the audit url as an object.
"stackPacks": [ # The Stack Pack advice strings.
{ # Message containing Stack Pack information.
- "iconDataURL": "A String", # The stack pack icon data uri.
- "id": "A String", # The stack pack id.
"title": "A String", # The stack pack title.
"descriptions": { # The stack pack advice strings.
"a_key": "A String",
},
+ "iconDataURL": "A String", # The stack pack icon data uri.
+ "id": "A String", # The stack pack id.
},
],
"categoryGroups": { # Map of category groups in the LHR.
@@ -208,18 +155,18 @@
},
"runtimeError": { # Message containing a runtime error config. # A top-level error message that, if present, indicates a serious enough
# problem that this Lighthouse result may need to be discarded.
- "message": "A String", # A human readable message explaining the error code.
"code": "A String", # The enumerated Lighthouse Error code.
+ "message": "A String", # A human readable message explaining the error code.
},
"fetchTime": "A String", # The time that this run was fetched.
"requestedUrl": "A String", # The original requested url.
"userAgent": "A String", # The user agent that was used to run this LHR.
"configSettings": { # Message containing the configuration settings for the Lighthouse run. # The configuration settings for this LHR.
+ "onlyCategories": "", # List of categories of audits the run should conduct.
+ "emulatedFormFactor": "A String", # The form factor the emulation should use.
"locale": "A String", # The locale setting.
"channel": "A String", # How Lighthouse was run, e.g. from the Chrome extension or from the npm
# module.
- "onlyCategories": "", # List of categories of audits the run should conduct.
- "emulatedFormFactor": "A String", # The form factor the emulation should use.
},
"timing": { # Message containing the performance timing data for the Lighthouse run. # Timing information for this LHR.
"total": 3.14, # The total duration of Lighthouse's run.
@@ -235,58 +182,141 @@
"details": { # Freeform details section of the audit.
"a_key": "", # Properties of the object.
},
- "errorMessage": "A String", # An error message from a thrown error inside the audit.
"score": "", # The score of the audit, can be null.
+ "errorMessage": "A String", # An error message from a thrown error inside the audit.
"displayValue": "A String", # The value that should be displayed on the UI for this audit.
+ "id": "A String", # The audit's id.
"numericValue": 3.14, # A numeric value that has a meaning specific to the audit, e.g. the number
# of nodes in the DOM or the timestamp of a specific load event. More
# information can be found in the audit details, if present.
- "id": "A String", # The audit's id.
"title": "A String", # The human readable title.
"description": "A String", # The description of the audit.
},
},
"environment": { # Message containing environment configuration for a Lighthouse run. # Environment settings that were used when making this LHR.
+ "networkUserAgent": "A String", # The user agent string that was sent over the network.
"benchmarkIndex": 3.14, # The benchmark index number that indicates rough device class.
"hostUserAgent": "A String", # The user agent string of the version of Chrome used.
- "networkUserAgent": "A String", # The user agent string that was sent over the network.
},
"finalUrl": "A String", # The final resolved url that was audited.
"i18n": { # Message containing the i18n data for the LHR - Version 1. # The internationalization strings that are required to render the LHR.
"rendererFormattedStrings": { # Message holding the formatted strings used in the renderer. # Internationalized strings that are formatted to the locale in
# configSettings.
- "errorLabel": "A String", # The label shown next to an audit or metric that has had an error.
- "labDataTitle": "A String", # The title of the lab data performance category.
- "notApplicableAuditsGroupTitle": "A String", # The heading shown above a list of audits that do not apply to a page.
- "passedAuditsGroupTitle": "A String", # The heading that is shown above a list of audits that are passing.
- "auditGroupExpandTooltip": "A String", # The tooltip text on an expandable chevron icon.
"errorMissingAuditInfo": "A String", # The error string shown next to an erroring audit.
- "toplevelWarningsMessage": "A String", # The label shown preceding important warnings that may have invalidated
- # an entire report.
"opportunityResourceColumnLabel": "A String", # The heading for the estimated page load savings opportunity of an
# audit.
+ "toplevelWarningsMessage": "A String", # The label shown preceding important warnings that may have invalidated
+ # an entire report.
"varianceDisclaimer": "A String", # The disclaimer shown below a performance metric value.
"opportunitySavingsColumnLabel": "A String", # The heading for the estimated page load savings of opportunity audits.
"crcInitialNavigation": "A String", # The label for the initial request in a critical request chain.
"warningHeader": "A String", # The label shown above a bulleted list of warnings.
"crcLongestDurationLabel": "A String", # The label for values shown in the summary of critical request chains.
- "scorescaleLabel": "A String", # The label that explains the score gauges scale (0-49, 50-89, 90-100).
"manualAuditsGroupTitle": "A String", # The heading shown above a list of audits that were not computerd in the
# run.
+ "scorescaleLabel": "A String", # The label that explains the score gauges scale (0-49, 50-89, 90-100).
"lsPerformanceCategoryDescription": "A String", # The disclaimer shown under performance explaning that the network can
# vary.
+ "errorLabel": "A String", # The label shown next to an audit or metric that has had an error.
+ "notApplicableAuditsGroupTitle": "A String", # The heading shown above a list of audits that do not apply to a page.
+ "labDataTitle": "A String", # The title of the lab data performance category.
+ "passedAuditsGroupTitle": "A String", # The heading that is shown above a list of audits that are passing.
+ "auditGroupExpandTooltip": "A String", # The tooltip text on an expandable chevron icon.
+ },
+ },
+ "lighthouseVersion": "A String", # The lighthouse version that was used to generate this LHR.
+ "categories": { # The categories in a Lighthouse run. # Map of categories in the LHR.
+ "best-practices": { # A Lighthouse category. # The best practices category, containing all best practices related
+ # audits.
+ "score": "", # The overall score of the category, the weighted average of all its audits.
+ # (The category's score, can be null.)
+ "id": "A String", # The string identifier of the category.
+ "manualDescription": "A String", # A description for the manual audits in the category.
+ "title": "A String", # The human-friendly name of the category.
+ "description": "A String", # A more detailed description of the category and its importance.
+ "auditRefs": [ # An array of references to all the audit members of this category.
+ { # A light reference to an audit by id, used to group and weight audits in a
+ # given category.
+ "weight": 3.14, # The weight this audit's score has on the overall category score.
+ "id": "A String", # The audit ref id.
+ "group": "A String", # The category group that the audit belongs to (optional).
+ },
+ ],
+ },
+ "pwa": { # A Lighthouse category. # The Progressive-Web-App (PWA) category, containing all pwa related
+ # audits.
+ "score": "", # The overall score of the category, the weighted average of all its audits.
+ # (The category's score, can be null.)
+ "id": "A String", # The string identifier of the category.
+ "manualDescription": "A String", # A description for the manual audits in the category.
+ "title": "A String", # The human-friendly name of the category.
+ "description": "A String", # A more detailed description of the category and its importance.
+ "auditRefs": [ # An array of references to all the audit members of this category.
+ { # A light reference to an audit by id, used to group and weight audits in a
+ # given category.
+ "weight": 3.14, # The weight this audit's score has on the overall category score.
+ "id": "A String", # The audit ref id.
+ "group": "A String", # The category group that the audit belongs to (optional).
+ },
+ ],
+ },
+ "accessibility": { # A Lighthouse category. # The accessibility category, containing all accessibility related audits.
+ "score": "", # The overall score of the category, the weighted average of all its audits.
+ # (The category's score, can be null.)
+ "id": "A String", # The string identifier of the category.
+ "manualDescription": "A String", # A description for the manual audits in the category.
+ "title": "A String", # The human-friendly name of the category.
+ "description": "A String", # A more detailed description of the category and its importance.
+ "auditRefs": [ # An array of references to all the audit members of this category.
+ { # A light reference to an audit by id, used to group and weight audits in a
+ # given category.
+ "weight": 3.14, # The weight this audit's score has on the overall category score.
+ "id": "A String", # The audit ref id.
+ "group": "A String", # The category group that the audit belongs to (optional).
+ },
+ ],
+ },
+ "seo": { # A Lighthouse category. # The Search-Engine-Optimization (SEO) category, containing all seo related
+ # audits.
+ "score": "", # The overall score of the category, the weighted average of all its audits.
+ # (The category's score, can be null.)
+ "id": "A String", # The string identifier of the category.
+ "manualDescription": "A String", # A description for the manual audits in the category.
+ "title": "A String", # The human-friendly name of the category.
+ "description": "A String", # A more detailed description of the category and its importance.
+ "auditRefs": [ # An array of references to all the audit members of this category.
+ { # A light reference to an audit by id, used to group and weight audits in a
+ # given category.
+ "weight": 3.14, # The weight this audit's score has on the overall category score.
+ "id": "A String", # The audit ref id.
+ "group": "A String", # The category group that the audit belongs to (optional).
+ },
+ ],
+ },
+ "performance": { # A Lighthouse category. # The performance category, containing all performance related audits.
+ "score": "", # The overall score of the category, the weighted average of all its audits.
+ # (The category's score, can be null.)
+ "id": "A String", # The string identifier of the category.
+ "manualDescription": "A String", # A description for the manual audits in the category.
+ "title": "A String", # The human-friendly name of the category.
+ "description": "A String", # A more detailed description of the category and its importance.
+ "auditRefs": [ # An array of references to all the audit members of this category.
+ { # A light reference to an audit by id, used to group and weight audits in a
+ # given category.
+ "weight": 3.14, # The weight this audit's score has on the overall category score.
+ "id": "A String", # The audit ref id.
+ "group": "A String", # The category group that the audit belongs to (optional).
+ },
+ ],
},
},
},
"analysisUTCTimestamp": "A String", # The UTC timestamp of this analysis.
"loadingExperience": { # The CrUX loading experience object that contains CrUX data breakdowns. # Metrics of end users' page loading experience.
+ "initial_url": "A String", # The requested URL, which may differ from the resolved "id".
+ "id": "A String", # The url, pattern or origin which the metrics are on.
"metrics": { # The map of <metrics, data>.
"a_key": { # A CrUX metric object for a single metric and form factor.
- "median": 42, # The median number of the metric, in millisecond.
- "percentile": 42, # We use this field to store certain percentile value for this metric.
- # For v4, this field contains pc50.
- # For v5, this field contains pc90.
- "category": "A String", # The category of the specific time metric.
"distributions": [ # Metric distributions. Proportions should sum up to 1.
{ # A proportion of data in the total distribution, bucketed by a min/max
# percentage. Each bucket's range is bounded by min <= x < max, In
@@ -298,45 +328,15 @@
],
"metricId": "A String", # Identifies the type of the metric.
"formFactor": "A String", # Identifies the form factor of the metric being collected.
- },
- },
- "overall_category": "A String", # The human readable speed "category" of the id.
- "initial_url": "A String", # The requested URL, which may differ from the resolved "id".
- "id": "A String", # The url, pattern or origin which the metrics are on.
- },
- "version": { # The Pagespeed Version object. # The version of PageSpeed used to generate these results.
- "major": "A String", # The major version number of PageSpeed used to generate these results.
- "minor": "A String", # The minor version number of PageSpeed used to generate these results.
- },
- "id": "A String", # Canonicalized and final URL for the document, after following page
- # redirects (if any).
- "originLoadingExperience": { # The CrUX loading experience object that contains CrUX data breakdowns. # Metrics of the aggregated page loading experience of the origin
- "metrics": { # The map of <metrics, data>.
- "a_key": { # A CrUX metric object for a single metric and form factor.
"median": 42, # The median number of the metric, in millisecond.
"percentile": 42, # We use this field to store certain percentile value for this metric.
# For v4, this field contains pc50.
# For v5, this field contains pc90.
"category": "A String", # The category of the specific time metric.
- "distributions": [ # Metric distributions. Proportions should sum up to 1.
- { # A proportion of data in the total distribution, bucketed by a min/max
- # percentage. Each bucket's range is bounded by min <= x < max, In
- # millisecond.
- "proportion": 3.14, # The proportion of data in this bucket.
- "min": 42, # Lower bound for a bucket's range.
- "max": 42, # Upper bound for a bucket's range.
- },
- ],
- "metricId": "A String", # Identifies the type of the metric.
- "formFactor": "A String", # Identifies the form factor of the metric being collected.
},
},
"overall_category": "A String", # The human readable speed "category" of the id.
- "initial_url": "A String", # The requested URL, which may differ from the resolved "id".
- "id": "A String", # The url, pattern or origin which the metrics are on.
},
- "kind": "A String", # Kind of result.
- "captchaResult": "A String", # The captcha verify result
}</pre>
</div>