Method: projects.list

列出调用者可访问的每个FirebaseProject

返回的元素没有特定的顺序,但当使用pageToken发出其他请求时,它们将是项目的一致视图。

此方法最终与项目突变一致,这意味着新配置的项目和最近对现有项目的修改可能不会反映在项目集中。该列表将仅包括活动项目。

使用projects.get进行一致的读取以及其他项目详细信息。

HTTP请求

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

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

有关详细信息,请参阅身份验证概述