chore: update docs/dyn , add static discovery files to discovery_cache/documents (#1111)
This PR was generated using Autosynth. :rainbow:
Synth log will be available here:
https://source.cloud.google.com/results/invocations/78f53313-0c78-4a29-8841-f031665a4c6a/targets
- [ ] To automatically regenerate this PR, check this box.
Source-Link: https://github.com/googleapis/synthtool/commit/c2de32114ec484aa708d32012d1fa8d75232daf5
diff --git a/googleapiclient/discovery_cache/documents/pagespeedonline.v5.json b/googleapiclient/discovery_cache/documents/pagespeedonline.v5.json
new file mode 100644
index 0000000..2d16678
--- /dev/null
+++ b/googleapiclient/discovery_cache/documents/pagespeedonline.v5.json
@@ -0,0 +1,750 @@
+{
+ "servicePath": "",
+ "title": "PageSpeed Insights API",
+ "schemas": {
+ "LighthouseAuditResultV5": {
+ "properties": {
+ "description": {
+ "type": "string",
+ "description": "The description of the audit."
+ },
+ "id": {
+ "description": "The audit's id.",
+ "type": "string"
+ },
+ "details": {
+ "type": "object",
+ "description": "Freeform details section of the audit.",
+ "additionalProperties": {
+ "description": "Properties of the object.",
+ "type": "any"
+ }
+ },
+ "numericValue": {
+ "format": "double",
+ "description": "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.",
+ "type": "number"
+ },
+ "warnings": {
+ "type": "any",
+ "description": "Possible warnings that occurred in the audit, can be null."
+ },
+ "title": {
+ "type": "string",
+ "description": "The human readable title."
+ },
+ "errorMessage": {
+ "type": "string",
+ "description": "An error message from a thrown error inside the audit."
+ },
+ "scoreDisplayMode": {
+ "description": "The enumerated score display mode.",
+ "type": "string"
+ },
+ "displayValue": {
+ "type": "string",
+ "description": "The value that should be displayed on the UI for this audit."
+ },
+ "score": {
+ "type": "any",
+ "description": "The score of the audit, can be null."
+ },
+ "explanation": {
+ "description": "An explanation of the errors in the audit.",
+ "type": "string"
+ }
+ },
+ "id": "LighthouseAuditResultV5",
+ "type": "object",
+ "description": "An audit's result object in a Lighthouse result."
+ },
+ "PagespeedApiLoadingExperienceV5": {
+ "type": "object",
+ "description": "The CrUX loading experience object that contains CrUX data breakdowns.",
+ "properties": {
+ "origin_fallback": {
+ "type": "boolean",
+ "description": "True if the result is an origin fallback from a page, false otherwise."
+ },
+ "id": {
+ "description": "The url, pattern or origin which the metrics are on.",
+ "type": "string"
+ },
+ "metrics": {
+ "description": "The map of .",
+ "type": "object",
+ "additionalProperties": {
+ "$ref": "UserPageLoadMetricV5"
+ }
+ },
+ "initial_url": {
+ "description": "The requested URL, which may differ from the resolved \"id\".",
+ "type": "string"
+ },
+ "overall_category": {
+ "description": "The human readable speed \"category\" of the id.",
+ "type": "string"
+ }
+ },
+ "id": "PagespeedApiLoadingExperienceV5"
+ },
+ "UserPageLoadMetricV5": {
+ "properties": {
+ "formFactor": {
+ "type": "string",
+ "description": "Identifies the form factor of the metric being collected."
+ },
+ "metricId": {
+ "type": "string",
+ "description": "Identifies the type of the metric."
+ },
+ "distributions": {
+ "type": "array",
+ "description": "Metric distributions. Proportions should sum up to 1.",
+ "items": {
+ "$ref": "Bucket"
+ }
+ },
+ "category": {
+ "type": "string",
+ "description": "The category of the specific time metric."
+ },
+ "percentile": {
+ "description": "We use this field to store certain percentile value for this metric. For v4, this field contains pc50. For v5, this field contains pc90.",
+ "format": "int32",
+ "type": "integer"
+ },
+ "median": {
+ "type": "integer",
+ "format": "int32",
+ "description": "The median number of the metric, in millisecond."
+ }
+ },
+ "id": "UserPageLoadMetricV5",
+ "description": "A CrUX metric object for a single metric and form factor.",
+ "type": "object"
+ },
+ "AuditRefs": {
+ "id": "AuditRefs",
+ "description": "A light reference to an audit by id, used to group and weight audits in a given category.",
+ "type": "object",
+ "properties": {
+ "group": {
+ "type": "string",
+ "description": "The category group that the audit belongs to (optional)."
+ },
+ "id": {
+ "description": "The audit ref id.",
+ "type": "string"
+ },
+ "weight": {
+ "description": "The weight this audit's score has on the overall category score.",
+ "format": "double",
+ "type": "number"
+ }
+ }
+ },
+ "PagespeedApiPagespeedResponseV5": {
+ "description": "The Pagespeed API response object.",
+ "id": "PagespeedApiPagespeedResponseV5",
+ "type": "object",
+ "properties": {
+ "lighthouseResult": {
+ "$ref": "LighthouseResultV5",
+ "description": "Lighthouse response for the audit url as an object."
+ },
+ "loadingExperience": {
+ "description": "Metrics of end users' page loading experience.",
+ "$ref": "PagespeedApiLoadingExperienceV5"
+ },
+ "kind": {
+ "type": "string",
+ "description": "Kind of result."
+ },
+ "id": {
+ "type": "string",
+ "description": "Canonicalized and final URL for the document, after following page redirects (if any)."
+ },
+ "originLoadingExperience": {
+ "$ref": "PagespeedApiLoadingExperienceV5",
+ "description": "Metrics of the aggregated page loading experience of the origin"
+ },
+ "version": {
+ "$ref": "PagespeedVersion",
+ "description": "The version of PageSpeed used to generate these results."
+ },
+ "captchaResult": {
+ "type": "string",
+ "description": "The captcha verify result"
+ },
+ "analysisUTCTimestamp": {
+ "description": "The UTC timestamp of this analysis.",
+ "type": "string"
+ }
+ }
+ },
+ "ConfigSettings": {
+ "description": "Message containing the configuration settings for the Lighthouse run.",
+ "type": "object",
+ "properties": {
+ "emulatedFormFactor": {
+ "type": "string",
+ "description": "The form factor the emulation should use."
+ },
+ "onlyCategories": {
+ "type": "any",
+ "description": "List of categories of audits the run should conduct."
+ },
+ "locale": {
+ "type": "string",
+ "description": "The locale setting."
+ },
+ "channel": {
+ "description": "How Lighthouse was run, e.g. from the Chrome extension or from the npm module.",
+ "type": "string"
+ }
+ },
+ "id": "ConfigSettings"
+ },
+ "LighthouseCategoryV5": {
+ "properties": {
+ "id": {
+ "description": "The string identifier of the category.",
+ "type": "string"
+ },
+ "auditRefs": {
+ "type": "array",
+ "items": {
+ "$ref": "AuditRefs"
+ },
+ "description": "An array of references to all the audit members of this category."
+ },
+ "manualDescription": {
+ "type": "string",
+ "description": "A description for the manual audits in the category."
+ },
+ "score": {
+ "type": "any",
+ "description": "The overall score of the category, the weighted average of all its audits. (The category's score, can be null.)"
+ },
+ "title": {
+ "description": "The human-friendly name of the category.",
+ "type": "string"
+ },
+ "description": {
+ "description": "A more detailed description of the category and its importance.",
+ "type": "string"
+ }
+ },
+ "description": "A Lighthouse category.",
+ "id": "LighthouseCategoryV5",
+ "type": "object"
+ },
+ "RuntimeError": {
+ "properties": {
+ "code": {
+ "description": "The enumerated Lighthouse Error code.",
+ "type": "string"
+ },
+ "message": {
+ "type": "string",
+ "description": "A human readable message explaining the error code."
+ }
+ },
+ "id": "RuntimeError",
+ "description": "Message containing a runtime error config.",
+ "type": "object"
+ },
+ "PagespeedVersion": {
+ "id": "PagespeedVersion",
+ "description": "The Pagespeed Version object.",
+ "properties": {
+ "minor": {
+ "type": "string",
+ "description": "The minor version number of PageSpeed used to generate these results."
+ },
+ "major": {
+ "type": "string",
+ "description": "The major version number of PageSpeed used to generate these results."
+ }
+ },
+ "type": "object"
+ },
+ "StackPack": {
+ "properties": {
+ "descriptions": {
+ "type": "object",
+ "additionalProperties": {
+ "type": "string"
+ },
+ "description": "The stack pack advice strings."
+ },
+ "title": {
+ "type": "string",
+ "description": "The stack pack title."
+ },
+ "iconDataURL": {
+ "type": "string",
+ "description": "The stack pack icon data uri."
+ },
+ "id": {
+ "description": "The stack pack id.",
+ "type": "string"
+ }
+ },
+ "description": "Message containing Stack Pack information.",
+ "type": "object",
+ "id": "StackPack"
+ },
+ "RendererFormattedStrings": {
+ "properties": {
+ "opportunitySavingsColumnLabel": {
+ "type": "string",
+ "description": "The heading for the estimated page load savings of opportunity audits."
+ },
+ "manualAuditsGroupTitle": {
+ "description": "The heading shown above a list of audits that were not computerd in the run.",
+ "type": "string"
+ },
+ "labDataTitle": {
+ "description": "The title of the lab data performance category.",
+ "type": "string"
+ },
+ "errorLabel": {
+ "type": "string",
+ "description": "The label shown next to an audit or metric that has had an error."
+ },
+ "auditGroupExpandTooltip": {
+ "type": "string",
+ "description": "The tooltip text on an expandable chevron icon."
+ },
+ "crcLongestDurationLabel": {
+ "type": "string",
+ "description": "The label for values shown in the summary of critical request chains."
+ },
+ "passedAuditsGroupTitle": {
+ "description": "The heading that is shown above a list of audits that are passing.",
+ "type": "string"
+ },
+ "toplevelWarningsMessage": {
+ "description": "The label shown preceding important warnings that may have invalidated an entire report.",
+ "type": "string"
+ },
+ "scorescaleLabel": {
+ "type": "string",
+ "description": "The label that explains the score gauges scale (0-49, 50-89, 90-100)."
+ },
+ "notApplicableAuditsGroupTitle": {
+ "description": "The heading shown above a list of audits that do not apply to a page.",
+ "type": "string"
+ },
+ "varianceDisclaimer": {
+ "type": "string",
+ "description": "The disclaimer shown below a performance metric value."
+ },
+ "lsPerformanceCategoryDescription": {
+ "description": "The disclaimer shown under performance explaning that the network can vary.",
+ "type": "string"
+ },
+ "errorMissingAuditInfo": {
+ "description": "The error string shown next to an erroring audit.",
+ "type": "string"
+ },
+ "crcInitialNavigation": {
+ "description": "The label for the initial request in a critical request chain.",
+ "type": "string"
+ },
+ "warningHeader": {
+ "description": "The label shown above a bulleted list of warnings.",
+ "type": "string"
+ },
+ "opportunityResourceColumnLabel": {
+ "description": "The heading for the estimated page load savings opportunity of an audit.",
+ "type": "string"
+ }
+ },
+ "description": "Message holding the formatted strings used in the renderer.",
+ "id": "RendererFormattedStrings",
+ "type": "object"
+ },
+ "CategoryGroupV5": {
+ "properties": {
+ "title": {
+ "description": "The human readable title of the group",
+ "type": "string"
+ },
+ "description": {
+ "description": "The description of what the category is grouping",
+ "type": "string"
+ }
+ },
+ "description": "Message containing a category",
+ "id": "CategoryGroupV5",
+ "type": "object"
+ },
+ "Environment": {
+ "properties": {
+ "hostUserAgent": {
+ "type": "string",
+ "description": "The user agent string of the version of Chrome used."
+ },
+ "networkUserAgent": {
+ "type": "string",
+ "description": "The user agent string that was sent over the network."
+ },
+ "benchmarkIndex": {
+ "description": "The benchmark index number that indicates rough device class.",
+ "format": "double",
+ "type": "number"
+ }
+ },
+ "type": "object",
+ "description": "Message containing environment configuration for a Lighthouse run.",
+ "id": "Environment"
+ },
+ "LighthouseResultV5": {
+ "description": "The Lighthouse result object.",
+ "id": "LighthouseResultV5",
+ "properties": {
+ "requestedUrl": {
+ "type": "string",
+ "description": "The original requested url."
+ },
+ "environment": {
+ "$ref": "Environment",
+ "description": "Environment settings that were used when making this LHR."
+ },
+ "configSettings": {
+ "$ref": "ConfigSettings",
+ "description": "The configuration settings for this LHR."
+ },
+ "userAgent": {
+ "description": "The user agent that was used to run this LHR.",
+ "type": "string"
+ },
+ "lighthouseVersion": {
+ "type": "string",
+ "description": "The lighthouse version that was used to generate this LHR."
+ },
+ "i18n": {
+ "$ref": "I18n",
+ "description": "The internationalization strings that are required to render the LHR."
+ },
+ "finalUrl": {
+ "type": "string",
+ "description": "The final resolved url that was audited."
+ },
+ "audits": {
+ "type": "object",
+ "additionalProperties": {
+ "$ref": "LighthouseAuditResultV5"
+ },
+ "description": "Map of audits in the LHR."
+ },
+ "runtimeError": {
+ "$ref": "RuntimeError",
+ "description": "A top-level error message that, if present, indicates a serious enough problem that this Lighthouse result may need to be discarded."
+ },
+ "stackPacks": {
+ "description": "The Stack Pack advice strings.",
+ "items": {
+ "$ref": "StackPack"
+ },
+ "type": "array"
+ },
+ "runWarnings": {
+ "items": {
+ "type": "any"
+ },
+ "type": "array",
+ "description": "List of all run warnings in the LHR. Will always output to at least `[]`."
+ },
+ "categoryGroups": {
+ "additionalProperties": {
+ "$ref": "CategoryGroupV5"
+ },
+ "type": "object",
+ "description": "Map of category groups in the LHR."
+ },
+ "fetchTime": {
+ "description": "The time that this run was fetched.",
+ "type": "string"
+ },
+ "categories": {
+ "description": "Map of categories in the LHR.",
+ "$ref": "Categories"
+ },
+ "timing": {
+ "$ref": "Timing",
+ "description": "Timing information for this LHR."
+ }
+ },
+ "type": "object"
+ },
+ "Timing": {
+ "description": "Message containing the performance timing data for the Lighthouse run.",
+ "id": "Timing",
+ "properties": {
+ "total": {
+ "format": "double",
+ "description": "The total duration of Lighthouse's run.",
+ "type": "number"
+ }
+ },
+ "type": "object"
+ },
+ "Bucket": {
+ "properties": {
+ "max": {
+ "description": "Upper bound for a bucket's range.",
+ "format": "int32",
+ "type": "integer"
+ },
+ "min": {
+ "description": "Lower bound for a bucket's range.",
+ "format": "int32",
+ "type": "integer"
+ },
+ "proportion": {
+ "type": "number",
+ "description": "The proportion of data in this bucket.",
+ "format": "double"
+ }
+ },
+ "type": "object",
+ "id": "Bucket",
+ "description": "A proportion of data in the total distribution, bucketed by a min/max percentage. Each bucket's range is bounded by min \u003c= x \u003c max, In millisecond."
+ },
+ "Categories": {
+ "id": "Categories",
+ "description": "The categories in a Lighthouse run.",
+ "properties": {
+ "accessibility": {
+ "$ref": "LighthouseCategoryV5",
+ "description": "The accessibility category, containing all accessibility related audits."
+ },
+ "performance": {
+ "$ref": "LighthouseCategoryV5",
+ "description": "The performance category, containing all performance related audits."
+ },
+ "best-practices": {
+ "$ref": "LighthouseCategoryV5",
+ "description": "The best practices category, containing all best practices related audits."
+ },
+ "seo": {
+ "$ref": "LighthouseCategoryV5",
+ "description": "The Search-Engine-Optimization (SEO) category, containing all seo related audits."
+ },
+ "pwa": {
+ "description": "The Progressive-Web-App (PWA) category, containing all pwa related audits.",
+ "$ref": "LighthouseCategoryV5"
+ }
+ },
+ "type": "object"
+ },
+ "I18n": {
+ "description": "Message containing the i18n data for the LHR - Version 1.",
+ "id": "I18n",
+ "type": "object",
+ "properties": {
+ "rendererFormattedStrings": {
+ "description": "Internationalized strings that are formatted to the locale in configSettings.",
+ "$ref": "RendererFormattedStrings"
+ }
+ }
+ }
+ },
+ "ownerDomain": "google.com",
+ "resources": {
+ "pagespeedapi": {
+ "methods": {
+ "runpagespeed": {
+ "id": "pagespeedonline.pagespeedapi.runpagespeed",
+ "description": "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.",
+ "response": {
+ "$ref": "PagespeedApiPagespeedResponseV5"
+ },
+ "path": "pagespeedonline/v5/runPagespeed",
+ "flatPath": "pagespeedonline/v5/runPagespeed",
+ "parameterOrder": [],
+ "httpMethod": "GET",
+ "scopes": [
+ "openid"
+ ],
+ "parameters": {
+ "utm_source": {
+ "description": "Campaign source for analytics.",
+ "type": "string",
+ "location": "query"
+ },
+ "captchaToken": {
+ "description": "The captcha token passed when filling out a captcha.",
+ "type": "string",
+ "location": "query"
+ },
+ "url": {
+ "location": "query",
+ "type": "string",
+ "description": "Required. The URL to fetch and analyze"
+ },
+ "category": {
+ "type": "string",
+ "enum": [
+ "CATEGORY_UNSPECIFIED",
+ "ACCESSIBILITY",
+ "BEST_PRACTICES",
+ "PERFORMANCE",
+ "PWA",
+ "SEO"
+ ],
+ "location": "query",
+ "repeated": true,
+ "enumDescriptions": [
+ "Default UNDEFINED category.",
+ "Accessibility (a11y), category pertaining to a website's capacity to be accessible to all users.",
+ "Best Practices, category pertaining to a website's conformance to web best practice.",
+ "Performance, category pertaining to a website's performance.",
+ "Progressive Web App (PWA), category pertaining to a website's ability to be run as a PWA.",
+ "Search Engine Optimization (SEO), category pertaining to a website's ability to be indexed by search engines."
+ ],
+ "description": "A Lighthouse category to run; if none are given, only Performance category will be run"
+ },
+ "strategy": {
+ "description": "The analysis strategy (desktop or mobile) to use, and desktop is the default",
+ "enum": [
+ "STRATEGY_UNSPECIFIED",
+ "DESKTOP",
+ "MOBILE"
+ ],
+ "enumDescriptions": [
+ "UNDEFINED.",
+ "Fetch and analyze the URL for desktop browsers.",
+ "Fetch and analyze the URL for mobile devices."
+ ],
+ "location": "query",
+ "type": "string"
+ },
+ "locale": {
+ "location": "query",
+ "description": "The locale used to localize formatted results",
+ "type": "string"
+ },
+ "utm_campaign": {
+ "description": "Campaign name for analytics.",
+ "location": "query",
+ "type": "string"
+ }
+ }
+ }
+ }
+ }
+ },
+ "canonicalName": "Pagespeed Insights",
+ "discoveryVersion": "v1",
+ "name": "pagespeedonline",
+ "version_module": true,
+ "fullyEncodeReservedExpansion": true,
+ "documentationLink": "https://developers.google.com/speed/docs/insights/v5/about",
+ "id": "pagespeedonline:v5",
+ "baseUrl": "https://pagespeedonline.googleapis.com/",
+ "icons": {
+ "x16": "http://www.google.com/images/icons/product/search-16.gif",
+ "x32": "http://www.google.com/images/icons/product/search-32.gif"
+ },
+ "ownerName": "Google",
+ "version": "v5",
+ "description": "The PageSpeed Insights API lets you analyze the performance of your website with a simple API. It offers tailored suggestions for how you can optimize your site, and lets you easily integrate PageSpeed Insights analysis into your development tools and workflow. ",
+ "batchPath": "batch",
+ "auth": {
+ "oauth2": {
+ "scopes": {
+ "openid": {
+ "description": "Associate you with your personal info on Google"
+ }
+ }
+ }
+ },
+ "rootUrl": "https://pagespeedonline.googleapis.com/",
+ "parameters": {
+ "fields": {
+ "location": "query",
+ "type": "string",
+ "description": "Selector specifying which fields to include in a partial response."
+ },
+ "callback": {
+ "type": "string",
+ "location": "query",
+ "description": "JSONP"
+ },
+ "$.xgafv": {
+ "enumDescriptions": [
+ "v1 error format",
+ "v2 error format"
+ ],
+ "type": "string",
+ "enum": [
+ "1",
+ "2"
+ ],
+ "description": "V1 error format.",
+ "location": "query"
+ },
+ "quotaUser": {
+ "location": "query",
+ "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
+ "type": "string"
+ },
+ "prettyPrint": {
+ "location": "query",
+ "description": "Returns response with indentations and line breaks.",
+ "default": "true",
+ "type": "boolean"
+ },
+ "uploadType": {
+ "location": "query",
+ "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
+ "type": "string"
+ },
+ "oauth_token": {
+ "description": "OAuth 2.0 token for the current user.",
+ "type": "string",
+ "location": "query"
+ },
+ "access_token": {
+ "description": "OAuth access token.",
+ "location": "query",
+ "type": "string"
+ },
+ "key": {
+ "type": "string",
+ "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
+ "location": "query"
+ },
+ "alt": {
+ "enumDescriptions": [
+ "Responses with Content-Type of application/json",
+ "Media download with context-dependent Content-Type",
+ "Responses with Content-Type of application/x-protobuf"
+ ],
+ "type": "string",
+ "default": "json",
+ "enum": [
+ "json",
+ "media",
+ "proto"
+ ],
+ "location": "query",
+ "description": "Data format for response."
+ },
+ "upload_protocol": {
+ "location": "query",
+ "type": "string",
+ "description": "Upload protocol for media (e.g. \"raw\", \"multipart\")."
+ }
+ },
+ "revision": "20200813",
+ "kind": "discovery#restDescription",
+ "protocol": "rest",
+ "mtlsRootUrl": "https://pagespeedonline.mtls.googleapis.com/",
+ "basePath": ""
+}