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 總覽。