Method: projects.list

列出呼叫端可存取的每個 FirebaseProject

元素不會按特定順序傳回,但使用 pageToken 發出其他要求時,這些元素將會是一致的專案檢視畫面。

此方法最終與專案異動一致,這表示新佈建的專案,以及現有專案的最新修改內容可能不會反映在專案組合中。這份清單只會列出「有效」的專案。

請使用 projects.get 執行一致的讀取作業以及其他專案詳細資料。

HTTP 要求

GET https://firebase.googleapis.com/v1beta1/projects

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
pageToken

string

之前對 projects.list 的呼叫傳回的權杖,用於指出要在專案集中的哪個位置恢復刊登。

pageSize

integer

回應中傳回的專案數量上限。

伺服器自行斟酌後傳回的數量可能會少於這個數量。如未指定任何值 (或指定太大的值),伺服器會設有限制。

此值不能為負數。

showDeleted

boolean

選用設定。控管是否應在回應中傳回 DELETED 狀態的專案。

如未指定,系統只會傳回 ACTIVE 個專案。

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體即會包含具有以下結構的資料:

JSON 表示法
{
  "results": [
    {
      object (FirebaseProject)
    }
  ],
  "nextPageToken": string
}
欄位
results[]

object (FirebaseProject)

呼叫端可存取的專案清單頁面。

nextPageToken

string

如果結果清單過大,無法容納單一回應,系統會傳回符記。如果字串空白,則這個回應是結果的最後一頁。

這個權杖可用於後續對 projects.list 的呼叫,以找出下一組專案。

頁面符記效期短暫,不應保留。

授權範圍

需要下列其中一種 OAuth 範圍:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/cloud-platform.read-only
  • https://www.googleapis.com/auth/firebase
  • https://www.googleapis.com/auth/firebase.readonly

詳情請參閱驗證總覽一文。