You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

570 rivejä
20 KiB

  1. {
  2. "basePath": "/pagespeedonline/v5/",
  3. "baseUrl": "https://www.googleapis.com/pagespeedonline/v5/",
  4. "batchPath": "batch/pagespeedonline/v5",
  5. "description": "Analyzes the performance of a web page and provides tailored suggestions to make that page faster.",
  6. "discoveryVersion": "v1",
  7. "documentationLink": "https://developers.google.com/speed/docs/insights/v5/get-started",
  8. "etag": "\"J3WqvAcMk4eQjJXvfSI4Yr8VouA/NtoJIO0Mp0BYbtnKoGvOvVKCYHs\"",
  9. "icons": {
  10. "x16": "https://www.google.com/images/icons/product/pagespeed-16.png",
  11. "x32": "https://www.google.com/images/icons/product/pagespeed-32.png"
  12. },
  13. "id": "pagespeedonline:v5",
  14. "kind": "discovery#restDescription",
  15. "name": "pagespeedonline",
  16. "ownerDomain": "google.com",
  17. "ownerName": "Google",
  18. "parameters": {
  19. "alt": {
  20. "default": "json",
  21. "description": "Data format for the response.",
  22. "enum": [
  23. "json"
  24. ],
  25. "enumDescriptions": [
  26. "Responses with Content-Type of application/json"
  27. ],
  28. "location": "query",
  29. "type": "string"
  30. },
  31. "fields": {
  32. "description": "Selector specifying which fields to include in a partial response.",
  33. "location": "query",
  34. "type": "string"
  35. },
  36. "key": {
  37. "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.",
  38. "location": "query",
  39. "type": "string"
  40. },
  41. "oauth_token": {
  42. "description": "OAuth 2.0 token for the current user.",
  43. "location": "query",
  44. "type": "string"
  45. },
  46. "prettyPrint": {
  47. "default": "true",
  48. "description": "Returns response with indentations and line breaks.",
  49. "location": "query",
  50. "type": "boolean"
  51. },
  52. "quotaUser": {
  53. "description": "An opaque string that represents a user for quota purposes. Must not exceed 40 characters.",
  54. "location": "query",
  55. "type": "string"
  56. },
  57. "userIp": {
  58. "description": "Deprecated. Please use quotaUser instead.",
  59. "location": "query",
  60. "type": "string"
  61. }
  62. },
  63. "protocol": "rest",
  64. "resources": {
  65. "pagespeedapi": {
  66. "methods": {
  67. "runpagespeed": {
  68. "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.",
  69. "httpMethod": "GET",
  70. "id": "pagespeedonline.pagespeedapi.runpagespeed",
  71. "parameterOrder": [
  72. "url"
  73. ],
  74. "parameters": {
  75. "category": {
  76. "description": "A Lighthouse category to run; if none are given, only Performance category will be run",
  77. "enum": [
  78. "accessibility",
  79. "best-practices",
  80. "performance",
  81. "pwa",
  82. "seo"
  83. ],
  84. "enumDescriptions": [
  85. "",
  86. "",
  87. "",
  88. "",
  89. ""
  90. ],
  91. "location": "query",
  92. "repeated": true,
  93. "type": "string"
  94. },
  95. "locale": {
  96. "description": "The locale used to localize formatted results",
  97. "location": "query",
  98. "pattern": "[a-zA-Z]+((_|-)[a-zA-Z]+)?",
  99. "type": "string"
  100. },
  101. "strategy": {
  102. "description": "The analysis strategy (desktop or mobile) to use, and desktop is the default",
  103. "enum": [
  104. "desktop",
  105. "mobile"
  106. ],
  107. "enumDescriptions": [
  108. "Fetch and analyze the URL for desktop browsers",
  109. "Fetch and analyze the URL for mobile devices"
  110. ],
  111. "location": "query",
  112. "type": "string"
  113. },
  114. "url": {
  115. "description": "The URL to fetch and analyze",
  116. "location": "query",
  117. "pattern": "(?i)http(s)?://.*",
  118. "required": true,
  119. "type": "string"
  120. },
  121. "utm_campaign": {
  122. "description": "Campaign name for analytics.",
  123. "location": "query",
  124. "type": "string"
  125. },
  126. "utm_source": {
  127. "description": "Campaign source for analytics.",
  128. "location": "query",
  129. "type": "string"
  130. }
  131. },
  132. "path": "runPagespeed",
  133. "response": {
  134. "$ref": "PagespeedApiPagespeedResponseV5"
  135. }
  136. }
  137. }
  138. }
  139. },
  140. "revision": "20181127",
  141. "rootUrl": "https://www.googleapis.com/",
  142. "schemas": {
  143. "GoogleprotobufValue": {
  144. "id": "GoogleprotobufValue",
  145. "type": "any"
  146. },
  147. "LighthouseAuditResultV5": {
  148. "id": "LighthouseAuditResultV5",
  149. "properties": {
  150. "description": {
  151. "description": "The description of the audit.",
  152. "type": "string"
  153. },
  154. "details": {
  155. "additionalProperties": {
  156. "type": "any"
  157. },
  158. "description": "Freeform details section of the audit.",
  159. "type": "object"
  160. },
  161. "displayValue": {
  162. "description": "The value that should be displayed on the UI for this audit.",
  163. "type": "string"
  164. },
  165. "errorMessage": {
  166. "description": "An error message from a thrown error inside the audit.",
  167. "type": "string"
  168. },
  169. "explanation": {
  170. "description": "An explanation of the errors in the audit.",
  171. "type": "string"
  172. },
  173. "id": {
  174. "description": "The audit's id.",
  175. "type": "string"
  176. },
  177. "score": {
  178. "type": "any"
  179. },
  180. "scoreDisplayMode": {
  181. "description": "The enumerated score display mode.",
  182. "type": "string"
  183. },
  184. "title": {
  185. "description": "The human readable title.",
  186. "type": "string"
  187. },
  188. "warnings": {
  189. "type": "any"
  190. }
  191. },
  192. "type": "object"
  193. },
  194. "LighthouseCategoryV5": {
  195. "id": "LighthouseCategoryV5",
  196. "properties": {
  197. "auditRefs": {
  198. "description": "An array of references to all the audit members of this category.",
  199. "items": {
  200. "properties": {
  201. "group": {
  202. "description": "The category group that the audit belongs to (optional).",
  203. "type": "string"
  204. },
  205. "id": {
  206. "description": "The audit ref id.",
  207. "type": "string"
  208. },
  209. "weight": {
  210. "description": "The weight this audit's score has on the overall category score.",
  211. "format": "double",
  212. "type": "number"
  213. }
  214. },
  215. "type": "object"
  216. },
  217. "type": "array"
  218. },
  219. "description": {
  220. "description": "A more detailed description of the category and its importance.",
  221. "type": "string"
  222. },
  223. "id": {
  224. "description": "The string identifier of the category.",
  225. "type": "string"
  226. },
  227. "manualDescription": {
  228. "description": "A description for the manual audits in the category.",
  229. "type": "string"
  230. },
  231. "score": {
  232. "type": "any"
  233. },
  234. "title": {
  235. "description": "The human-friendly name of the category.",
  236. "type": "string"
  237. }
  238. },
  239. "type": "object"
  240. },
  241. "LighthouseResultV5": {
  242. "id": "LighthouseResultV5",
  243. "properties": {
  244. "audits": {
  245. "additionalProperties": {
  246. "$ref": "LighthouseAuditResultV5",
  247. "description": "An audit that was performed in this run. Keyed by audit id."
  248. },
  249. "description": "Map of audits in the LHR.",
  250. "type": "object"
  251. },
  252. "categories": {
  253. "description": "Map of categories in the LHR.",
  254. "properties": {
  255. "accessibility": {
  256. "$ref": "LighthouseCategoryV5",
  257. "description": "The accessibility category, containing all accessibility related audits."
  258. },
  259. "best-practices": {
  260. "$ref": "LighthouseCategoryV5",
  261. "description": "The best practices category, containing all web best practice related audits."
  262. },
  263. "performance": {
  264. "$ref": "LighthouseCategoryV5",
  265. "description": "The performance category, containing all performance related audits."
  266. },
  267. "pwa": {
  268. "$ref": "LighthouseCategoryV5",
  269. "description": "The Progressive-Web-App (PWA) category, containing all pwa related audits."
  270. },
  271. "seo": {
  272. "$ref": "LighthouseCategoryV5",
  273. "description": "The Search-Engine-Optimization (SEO) category, containing all seo related audits."
  274. }
  275. },
  276. "type": "object"
  277. },
  278. "categoryGroups": {
  279. "additionalProperties": {
  280. "description": "A grouping contained in a category that groups similar audits together.",
  281. "properties": {
  282. "description": {
  283. "description": "An optional human readable description of the category group.",
  284. "type": "string"
  285. },
  286. "title": {
  287. "description": "The title of the category group.",
  288. "type": "string"
  289. }
  290. },
  291. "type": "object"
  292. },
  293. "description": "Map of category groups in the LHR.",
  294. "type": "object"
  295. },
  296. "configSettings": {
  297. "description": "The configuration settings for this LHR.",
  298. "properties": {
  299. "emulatedFormFactor": {
  300. "description": "The form factor the emulation should use.",
  301. "type": "string"
  302. },
  303. "locale": {
  304. "description": "The locale setting.",
  305. "type": "string"
  306. },
  307. "onlyCategories": {
  308. "type": "any"
  309. }
  310. },
  311. "type": "object"
  312. },
  313. "environment": {
  314. "description": "Environment settings that were used when making this LHR.",
  315. "properties": {
  316. "benchmarkIndex": {
  317. "description": "The benchmark index number that indicates rough device class.",
  318. "format": "double",
  319. "type": "number"
  320. },
  321. "hostUserAgent": {
  322. "description": "The user agent string of the version of Chrome used.",
  323. "type": "string"
  324. },
  325. "networkUserAgent": {
  326. "description": "The user agent string that was sent over the network.",
  327. "type": "string"
  328. }
  329. },
  330. "type": "object"
  331. },
  332. "fetchTime": {
  333. "description": "The time that this run was fetched.",
  334. "type": "string"
  335. },
  336. "finalUrl": {
  337. "description": "The final resolved url that was audited.",
  338. "type": "string"
  339. },
  340. "i18n": {
  341. "description": "The internationalization strings that are required to render the LHR.",
  342. "properties": {
  343. "rendererFormattedStrings": {
  344. "description": "Internationalized strings that are formatted to the locale in configSettings.",
  345. "properties": {
  346. "auditGroupExpandTooltip": {
  347. "description": "The tooltip text on an expandable chevron icon.",
  348. "type": "string"
  349. },
  350. "crcInitialNavigation": {
  351. "description": "The label for the initial request in a critical request chain.",
  352. "type": "string"
  353. },
  354. "crcLongestDurationLabel": {
  355. "description": "The label for values shown in the summary of critical request chains.",
  356. "type": "string"
  357. },
  358. "errorLabel": {
  359. "description": "The label shown next to an audit or metric that has had an error.",
  360. "type": "string"
  361. },
  362. "errorMissingAuditInfo": {
  363. "description": "The error string shown next to an erroring audit.",
  364. "type": "string"
  365. },
  366. "labDataTitle": {
  367. "description": "The title of the lab data performance category.",
  368. "type": "string"
  369. },
  370. "lsPerformanceCategoryDescription": {
  371. "description": "The disclaimer shown under performance explaning that the network can vary.",
  372. "type": "string"
  373. },
  374. "manualAuditsGroupTitle": {
  375. "description": "The heading shown above a list of audits that were not computerd in the run.",
  376. "type": "string"
  377. },
  378. "notApplicableAuditsGroupTitle": {
  379. "description": "The heading shown above a list of audits that do not apply to a page.",
  380. "type": "string"
  381. },
  382. "opportunityResourceColumnLabel": {
  383. "description": "The heading for the estimated page load savings opportunity of an audit.",
  384. "type": "string"
  385. },
  386. "opportunitySavingsColumnLabel": {
  387. "description": "The heading for the estimated page load savings of opportunity audits.",
  388. "type": "string"
  389. },
  390. "passedAuditsGroupTitle": {
  391. "description": "The heading that is shown above a list of audits that are passing.",
  392. "type": "string"
  393. },
  394. "scorescaleLabel": {
  395. "description": "The label that explains the score gauges scale (0-49, 50-89, 90-100).",
  396. "type": "string"
  397. },
  398. "toplevelWarningsMessage": {
  399. "description": "The label shown preceding important warnings that may have invalidated an entire report.",
  400. "type": "string"
  401. },
  402. "varianceDisclaimer": {
  403. "description": "The disclaimer shown below a performance metric value.",
  404. "type": "string"
  405. },
  406. "warningHeader": {
  407. "description": "The label shown above a bulleted list of warnings.",
  408. "type": "string"
  409. }
  410. },
  411. "type": "object"
  412. }
  413. },
  414. "type": "object"
  415. },
  416. "lighthouseVersion": {
  417. "description": "The lighthouse version that was used to generate this LHR.",
  418. "type": "string"
  419. },
  420. "requestedUrl": {
  421. "description": "The original requested url.",
  422. "type": "string"
  423. },
  424. "runWarnings": {
  425. "description": "List of all run warnings in the LHR. Will always output to at least `[]`.",
  426. "items": {
  427. "type": "any"
  428. },
  429. "type": "array"
  430. },
  431. "runtimeError": {
  432. "description": "A top-level error message that, if present, indicates a serious enough problem that this Lighthouse result may need to be discarded.",
  433. "properties": {
  434. "code": {
  435. "description": "The enumerated Lighthouse Error code.",
  436. "type": "string"
  437. },
  438. "message": {
  439. "description": "A human readable message explaining the error code.",
  440. "type": "string"
  441. }
  442. },
  443. "type": "object"
  444. },
  445. "timing": {
  446. "description": "Timing information for this LHR.",
  447. "properties": {
  448. "total": {
  449. "description": "The total duration of Lighthouse's run.",
  450. "format": "double",
  451. "type": "number"
  452. }
  453. },
  454. "type": "object"
  455. },
  456. "userAgent": {
  457. "description": "The user agent that was used to run this LHR.",
  458. "type": "string"
  459. }
  460. },
  461. "type": "object"
  462. },
  463. "PagespeedApiLoadingExperienceV5": {
  464. "id": "PagespeedApiLoadingExperienceV5",
  465. "properties": {
  466. "id": {
  467. "description": "The url, pattern or origin which the metrics are on.",
  468. "type": "string"
  469. },
  470. "initial_url": {
  471. "type": "string"
  472. },
  473. "metrics": {
  474. "additionalProperties": {
  475. "description": "The type of the metric.",
  476. "properties": {
  477. "category": {
  478. "type": "string"
  479. },
  480. "distributions": {
  481. "items": {
  482. "properties": {
  483. "max": {
  484. "format": "int32",
  485. "type": "integer"
  486. },
  487. "min": {
  488. "format": "int32",
  489. "type": "integer"
  490. },
  491. "proportion": {
  492. "format": "double",
  493. "type": "number"
  494. }
  495. },
  496. "type": "object"
  497. },
  498. "type": "array"
  499. },
  500. "percentile": {
  501. "format": "int32",
  502. "type": "integer"
  503. }
  504. },
  505. "type": "object"
  506. },
  507. "type": "object"
  508. },
  509. "overall_category": {
  510. "type": "string"
  511. }
  512. },
  513. "type": "object"
  514. },
  515. "PagespeedApiPagespeedResponseV5": {
  516. "id": "PagespeedApiPagespeedResponseV5",
  517. "properties": {
  518. "analysisUTCTimestamp": {
  519. "description": "The UTC timestamp of this analysis.",
  520. "type": "string"
  521. },
  522. "captchaResult": {
  523. "description": "The captcha verify result",
  524. "type": "string"
  525. },
  526. "id": {
  527. "description": "Canonicalized and final URL for the document, after following page redirects (if any).",
  528. "type": "string"
  529. },
  530. "kind": {
  531. "default": "pagespeedonline#result",
  532. "description": "Kind of result.",
  533. "type": "string"
  534. },
  535. "lighthouseResult": {
  536. "$ref": "LighthouseResultV5",
  537. "description": "Lighthouse response for the audit url as an object."
  538. },
  539. "loadingExperience": {
  540. "$ref": "PagespeedApiLoadingExperienceV5",
  541. "description": "Metrics of end users' page loading experience."
  542. },
  543. "originLoadingExperience": {
  544. "$ref": "PagespeedApiLoadingExperienceV5",
  545. "description": "Metrics of the aggregated page loading experience of the origin"
  546. },
  547. "version": {
  548. "description": "The version of PageSpeed used to generate these results.",
  549. "properties": {
  550. "major": {
  551. "description": "The major version number of PageSpeed used to generate these results.",
  552. "format": "int32",
  553. "type": "integer"
  554. },
  555. "minor": {
  556. "description": "The minor version number of PageSpeed used to generate these results.",
  557. "format": "int32",
  558. "type": "integer"
  559. }
  560. },
  561. "type": "object"
  562. }
  563. },
  564. "type": "object"
  565. }
  566. },
  567. "servicePath": "pagespeedonline/v5/",
  568. "title": "PageSpeed Insights API",
  569. "version": "v5"
  570. }