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 概述。