Method: projects.apps.releases.list

列出版本。默认情况下，按 createTime 降序排序。

HTTP 请求

GET https://firebaseappdistribution.googleapis.com/v1/{parent=projects/*/apps/*}/releases

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。应用资源的名称，是发布资源的父级。

格式：projects/{projectNumber}/apps/{appId}

必须对拥有指定资源 parent 的 Firebase 项目具有以下 IAM 权限才能进行授权：

  • firebaseappdistro.releases.list

查询参数

参数
pageSize

integer

要返回的最大版本数。服务返回的值可能小于此值。有效范围为 [1-100]；如果未指定 (0)，则最多返回 25 个版本。大于 100 的值会被强制转换为 100。
pageToken

string

从之前的 releases.list 调用接收的页面令牌。利用其进行后续页面检索。

进行分页时，提供给 releases.list 的所有其他参数必须与提供页面令牌的调用匹配。
orderBy

string

用于对版本排序的字段。

支持的字段：

  • createTime

要为字段指定降序，请附加“desc”后缀，例如 createTime desc。

如果未设置此参数，则版本按 createTime 降序排序。
filter

string

用于过滤响应中列出的版本的表达式。如需详细了解过滤功能，请参阅 Google 的 AIP-160 标准。

支持的字段：

  • releaseNotes.text 支持 =（可以在字符串的开头或结尾包含通配符 (*)）
  • createTime 支持 <、<=、> 和 >=，并要求使用 RFC-3339 格式的字符串

示例：

  • createTime <= "2021-09-08T00:00:00+04:00"
  • releaseNotes.text="fixes" AND createTime >= "2021-09-08T00:00:00.0Z"
  • releaseNotes.text="*v1.0.0-rc*"

请求正文

请求正文必须为空。

响应正文

如果成功，响应正文将包含结构如下的数据：

releases.list 的响应消息。

JSON 表示法 
{
  "releases": [
    {
      object (Release)
    }
  ],
  "nextPageToken": string
}
字段
releases[]

object (Release)

发行作品
nextPageToken

string

一个短期令牌，可作为 pageToken 发送以检索下一页。如果省略此字段，则不存在后续页面。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅 OAuth 2.0 概览。