Method: availableProjects.list

Liệt kê từng Google Cloud Platform (GCP) Project có thể thêm tài nguyên Firebase vào đó.

Dự án sẽ chỉ được liệt kê nếu:

  • Phương thức gọi có đủ quyền Google IAM để gọi projects.addFirebase.
  • Dự án chưa phải là FirebaseProject.
  • Dự án không nằm trong một Tổ chức có chính sách ngăn việc thêm tài nguyên Firebase.

yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Thông số
pageToken

string

Mã thông báo được trả về từ lệnh gọi trước đó đến availableProjects.list cho biết vị trí cần tiếp tục niêm yết trong tập hợp các Dự án.
pageSize

integer

Số lượng Dự án tối đa cần trả về trong nội dung phản hồi.

Máy chủ có thể trả về ít hơn giá trị này theo quyết định riêng của mình. Nếu bạn không chỉ định giá trị nào (hoặc chỉ định giá trị quá lớn), máy chủ sẽ tự đặt giới hạn.

Giá trị này không được là số âm.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "projectInfo": [
    {
      object (ProjectInfo)
    }
  ],
  "nextPageToken": string
}
Trường
projectInfo[]

object (ProjectInfo)

Danh sách Projects GCP có thể thêm các tài nguyên Firebase vào chúng.
nextPageToken

string

Nếu danh sách kết quả quá lớn nên không thể chứa hết trong một phản hồi, thì hệ thống sẽ trả về một mã thông báo. Nếu chuỗi trống thì phản hồi này là trang kết quả cuối cùng.

Bạn có thể dùng mã thông báo này trong các lệnh gọi tiếp theo tới availableProjects.list để tìm nhóm Dự án tiếp theo.

Mã thông báo trang chỉ tồn tại trong thời gian ngắn và không nên duy trì.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • 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

Để biết thêm thông tin, hãy xem bài viết Tổng quan về việc xác thực.

Thông tin dự án

Nội dung tham chiếu đến Project của Google Cloud Platform (GCP).

Biểu diễn dưới dạng JSON 
{
  "project": string,
  "displayName": string,
  "locationId": string
}
Trường
project

string

Tên tài nguyên của Project GCP mà bạn có thể thêm tài nguyên Firebase vào, theo định dạng:

projects/PROJECT_IDENTIFIER

Tham khảo trường FirebaseProject name để biết thông tin chi tiết về các giá trị PROJECT_IDENTIFIER.
displayName

string

Tên hiển thị do người dùng chỉ định của Project GCP, ví dụ: My App
locationId

string

Mã vị trí tài nguyên GCP mặc định của Dự án. Vị trí này là một trong các vị trí tài nguyên GCP hiện có.

Không phải dự án nào cũng có trường này được điền sẵn. Nếu trường này không được điền thì tức là Dự án chưa có vị trí tài nguyên mặc định trên GCP. Để đặt vị trí tài nguyên GCP mặc định cho một Dự án, hãy gọi defaultLocation.finalize sau khi bạn thêm tài nguyên Firebase vào Dự án.