{ "resources": { "platforms": { "methods": { "list": { "id": "versionhistory.platforms.list", "path": "v1/{+parent}/platforms", "flatPath": "v1/{v1Id}/platforms", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. The product, which owns this collection of platforms. Format: {product}", "pattern": "^[^/]+$", "location": "path", "required": true, "type": "string" }, "pageSize": { "description": "Optional. Optional limit on the number of channels to include in the response. If unspecified, the server will pick an appropriate default.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Optional. A page token, received from a previous `ListChannels` call. Provide this to retrieve the subsequent page.", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "ListPlatformsResponse" }, "description": "Returns list of platforms that are available for a given product. The resource \"product\" has no resource name in its name." } }, "resources": { "channels": { "methods": { "list": { "id": "versionhistory.platforms.channels.list", "path": "v1/{+parent}/channels", "flatPath": "v1/{v1Id}/platforms/{platformsId}/channels", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. The platform, which owns this collection of channels. Format: {product}/platforms/{platform}", "pattern": "^[^/]+/platforms/[^/]+$", "location": "path", "required": true, "type": "string" }, "pageSize": { "description": "Optional. Optional limit on the number of channels to include in the response. If unspecified, the server will pick an appropriate default.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Optional. A page token, received from a previous `ListChannels` call. Provide this to retrieve the subsequent page.", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "ListChannelsResponse" }, "description": "Returns list of channels that are available for a given platform." } }, "resources": { "versions": { "methods": { "list": { "id": "versionhistory.platforms.channels.versions.list", "path": "v1/{+parent}/versions", "flatPath": "v1/{v1Id}/platforms/{platformsId}/channels/{channelsId}/versions", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. The channel, which owns this collection of versions. Format: {product}/platforms/{platform}/channels/{channel}", "pattern": "^[^/]+/platforms/[^/]+/channels/[^/]+$", "location": "path", "required": true, "type": "string" }, "pageSize": { "description": "Optional. Optional limit on the number of versions to include in the response. If unspecified, the server will pick an appropriate default.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Optional. A page token, received from a previous `ListVersions` call. Provide this to retrieve the subsequent page.", "location": "query", "type": "string" }, "orderBy": { "description": "Optional. Ordering string. Valid order_by strings are \"version\", \"name\", \"platform\", and \"channel\". Optionally, you can append \" desc\" or \" asc\" to specify the sorting order. Multiple order_by strings can be used in a comma separated list. Ordering by channel will sort by distance from the stable channel (not alphabetically). A list of channels sorted in this order is: stable, beta, dev, canary, and canary_asan. Sorting by name may cause unexpected behaviour as it is a naive string sort. For example, 1.0.0.8 will be before 1.0.0.10 in descending order. If order_by is not specified the response will be sorted by version in descending order. Ex) \"...?order_by=version asc\" Ex) \"...?order_by=platform desc, channel, version\"", "location": "query", "type": "string" }, "filter": { "description": "Optional. Filter string. Format is a comma separated list of All comma separated filter clauses are conjoined with a logical \"and\". Valid field_names are \"version\", \"name\", \"platform\", and \"channel\". Valid operators are \"\u003c\", \"\u003c=\", \"=\", \"\u003e=\", and \"\u003e\". Channel comparison is done by distance from stable. Ex) stable \u003c beta, beta \u003c dev, canary \u003c canary_asan. Version comparison is done numerically. If version is not entirely written, the version will be appended with 0 in missing fields. Ex) version \u003e 80 becoms version \u003e 80.0.0.0 Name and platform are filtered by string comparison. Ex) \"...?filter=channel\u003c=beta, version \u003e= 80 Ex) \"...?filter=version \u003e 80, version \u003c 81", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "ListVersionsResponse" }, "description": "Returns list of version for the given platform/channel." } }, "resources": { "releases": { "methods": { "list": { "id": "versionhistory.platforms.channels.versions.releases.list", "path": "v1/{+parent}/releases", "flatPath": "v1/{v1Id}/platforms/{platformsId}/channels/{channelsId}/versions/{versionsId}/releases", "httpMethod": "GET", "parameters": { "parent": { "description": "Required. The version, which owns this collection of releases. Format: {product}/platforms/{platform}/channels/{channel}/versions/{version}", "pattern": "^[^/]+/platforms/[^/]+/channels/[^/]+/versions/[^/]+$", "location": "path", "required": true, "type": "string" }, "pageSize": { "description": "Optional. Optional limit on the number of releases to include in the response. If unspecified, the server will pick an appropriate default.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Optional. A page token, received from a previous `ListReleases` call. Provide this to retrieve the subsequent page.", "location": "query", "type": "string" }, "orderBy": { "description": "Optional. Ordering string. Valid order_by strings are \"version\", \"name\", \"starttime\", \"endtime\", \"platform\", \"channel\", and \"fraction\". Optionally, you can append \"desc\" or \"asc\" to specify the sorting order. Multiple order_by strings can be used in a comma separated list. Ordering by channel will sort by distance from the stable channel (not alphabetically). A list of channels sorted in this order is: stable, beta, dev, canary, and canary_asan. Sorting by name may cause unexpected behaviour as it is a naive string sort. For example, 1.0.0.8 will be before 1.0.0.10 in descending order. If order_by is not specified the response will be sorted by starttime in descending order. Ex) \"...?order_by=starttime asc\" Ex) \"...?order_by=platform desc, channel, startime desc\"", "location": "query", "type": "string" }, "filter": { "description": "Optional. Filter string. Format is a comma separated list of All comma separated filter clauses are conjoined with a logical \"and\". Valid field_names are \"version\", \"name\", \"platform\", \"channel\", \"fraction\" \"starttime\", and \"endtime\". Valid operators are \"\u003c\", \"\u003c=\", \"=\", \"\u003e=\", and \"\u003e\". Channel comparison is done by distance from stable. must be a valid channel when filtering by channel. Ex) stable \u003c beta, beta \u003c dev, canary \u003c canary_asan. Version comparison is done numerically. Ex) 1.0.0.8 \u003c 1.0.0.10. If version is not entirely written, the version will be appended with 0 for the missing fields. Ex) version \u003e 80 becoms version \u003e 80.0.0.0 When filtering by starttime or endtime, string must be in RFC 3339 date string format. Name and platform are filtered by string comparison. Ex) \"...?filter=channel\u003c=beta, version \u003e= 80 Ex) \"...?filter=version \u003e 80, version \u003c 81 Ex) \"...?filter=starttime\u003e2020-01-01T00:00:00Z", "location": "query", "type": "string" } }, "parameterOrder": [ "parent" ], "response": { "$ref": "ListReleasesResponse" }, "description": "Returns list of releases of the given version." } } } } } } } } } }, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "title": "versionhistory.googleapis.com API", "name": "versionhistory", "protocol": "rest", "baseUrl": "https://versionhistory.googleapis.com/", "servicePath": "", "ownerName": "Google", "fullyEncodeReservedExpansion": true, "kind": "discovery#restDescription", "revision": "20240331", "discoveryVersion": "v1", "documentationLink": "https://developers.chrome.com/versionhistory", "rootUrl": "https://versionhistory.googleapis.com/", "basePath": "", "version": "v1", "id": "versionhistory:v1", "schemas": { "ListPlatformsResponse": { "id": "ListPlatformsResponse", "description": "Response message for ListPlatforms.", "type": "object", "properties": { "platforms": { "description": "The list of platforms.", "type": "array", "items": { "$ref": "Platform" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "Platform": { "id": "Platform", "description": "Each Platform is owned by a Product and owns a collection of channels. Available platforms are listed in Platform enum below. Not all Channels are available for every Platform (e.g. CANARY does not exist for LINUX).", "type": "object", "properties": { "name": { "description": "Platform name. Format is \"{product}/platforms/{platform}\"", "type": "string" }, "platformType": { "description": "Type of platform.", "type": "string", "enumDescriptions": [ "", "Chrome Desktop for Windows (32-bit).", "Chrome Desktop for Windows (x86_64).", "Chrome Desktop for macOS (x86_64).", "Chrome Desktop for Linux.", "Chrome for Android.", "WebView for Android.", "Chrome for iOS.", "", "Chrome for macOS (ARM64).", "ChromeOS Lacros (x86_64).", "ChromeOS Lacros (ARM).", "ChromeOS.", "ChromeOS Lacros (ARM64).", "Chrome for Fuchsia.", "Chrome Desktop for Windows (ARM64)." ], "enum": [ "PLATFORM_TYPE_UNSPECIFIED", "WIN", "WIN64", "MAC", "LINUX", "ANDROID", "WEBVIEW", "IOS", "ALL", "MAC_ARM64", "LACROS", "LACROS_ARM32", "CHROMEOS", "LACROS_ARM64", "FUCHSIA", "WIN_ARM64" ] } } }, "ListChannelsResponse": { "id": "ListChannelsResponse", "description": "Response message for ListChannels.", "type": "object", "properties": { "channels": { "description": "The list of channels.", "type": "array", "items": { "$ref": "Channel" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "Channel": { "id": "Channel", "description": "Each Channel is owned by a Platform and owns a collection of versions. Possible Channels are listed in the Channel enum below. Not all Channels are available for every Platform (e.g. CANARY does not exist for LINUX).", "type": "object", "properties": { "name": { "description": "Channel name. Format is \"{product}/platforms/{platform}/channels/{channel}\"", "type": "string" }, "channelType": { "description": "Type of channel.", "type": "string", "enumDescriptions": [ "", "The Stable channel.", "The Beta channel.", "The Dev channel.", "The Canary channel.", "The Canary channel for Chrome, with DCHECK/ASAN enabled.", "", "The Extended Stable channel for Chrome.", "The Long-term support channel for ChromeOS.", "The Long-term support candidate channel for ChromeOS." ], "enum": [ "CHANNEL_TYPE_UNSPECIFIED", "STABLE", "BETA", "DEV", "CANARY", "CANARY_ASAN", "ALL", "EXTENDED", "LTS", "LTC" ] } } }, "ListVersionsResponse": { "id": "ListVersionsResponse", "description": "Response message for ListVersions.", "type": "object", "properties": { "versions": { "description": "The list of versions.", "type": "array", "items": { "$ref": "Version" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "Version": { "id": "Version", "description": "Each Version is owned by a Channel. A Version only displays the Version number (e.g. 84.0.4147.38). A Version owns a collection of releases.", "type": "object", "properties": { "name": { "description": "Version name. Format is \"{product}/platforms/{platform}/channels/{channel}/versions/{version}\" e.g. \"chrome/platforms/win/channels/beta/versions/84.0.4147.38\"", "type": "string" }, "version": { "description": "String containing just the version number. e.g. \"84.0.4147.38\"", "type": "string" } } }, "ListReleasesResponse": { "id": "ListReleasesResponse", "description": "Response message for ListReleases.", "type": "object", "properties": { "releases": { "description": "The list of releases.", "type": "array", "items": { "$ref": "Release" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "Release": { "id": "Release", "description": "A Release is owned by a Version. A Release contains information about the release(s) of its parent version. This includes when the release began and ended, as well as what percentage it was released at. If the version is released again, or if the serving percentage changes, it will create another release under the version.", "type": "object", "properties": { "name": { "description": "Release name. Format is \"{product}/platforms/{platform}/channels/{channel}/versions/{version}/releases/{release}\"", "type": "string" }, "serving": { "description": "Timestamp interval of when the release was live. If end_time is unspecified, the release is currently live.", "$ref": "Interval" }, "fraction": { "description": "Rollout fraction. This fraction indicates the fraction of people that should receive this version in this release. If the fraction is not specified in ReleaseManager, the API will assume fraction is 1.", "type": "number", "format": "double" }, "version": { "description": "String containing just the version number. e.g. \"84.0.4147.38\"", "type": "string" }, "fractionGroup": { "description": "Rollout fraction group. Only fractions with the same fraction_group are statistically comparable: there may be non-fractional differences between different fraction groups.", "type": "string", "format": "int64" } } }, "Interval": { "id": "Interval", "description": "Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.", "type": "object", "properties": { "startTime": { "description": "Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.", "type": "string", "format": "google-datetime" }, "endTime": { "description": "Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.", "type": "string", "format": "google-datetime" } } } }, "batchPath": "batch", "ownerDomain": "google.com", "canonicalName": "Version History", "mtlsRootUrl": "https://versionhistory.mtls.googleapis.com/", "version_module": true, "parameters": { "access_token": { "type": "string", "description": "OAuth access token.", "location": "query" }, "alt": { "type": "string", "description": "Data format for response.", "default": "json", "enum": [ "json", "media", "proto" ], "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "location": "query" }, "callback": { "type": "string", "description": "JSONP", "location": "query" }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" }, "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" }, "oauth_token": { "type": "string", "description": "OAuth 2.0 token for the current user.", "location": "query" }, "prettyPrint": { "type": "boolean", "description": "Returns response with indentations and line breaks.", "default": "true", "location": "query" }, "quotaUser": { "type": "string", "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.", "location": "query" }, "upload_protocol": { "type": "string", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query" }, "uploadType": { "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query" }, "$.xgafv": { "type": "string", "description": "V1 error format.", "enum": [ "1", "2" ], "enumDescriptions": [ "v1 error format", "v2 error format" ], "location": "query" } }, "description": "Version History API - Prod" }