Method: projects.apps.releases.list

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

HTTP请求

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

URL 使用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 概述