콘솔로 이동

메소드: availableProjects.list

Firebase 리소스를 추가할 수 있는 Google Cloud Platform(GCP) Projects 목록을 반환합니다.

GCP Project는 다음과 같은 경우에만 반환됩니다.

  1. 호출자는 projects.addFirebase를 호출할 수 있는 충분한 Google IAM 권한이 있습니다.

  2. GCP Project는 아직 FirebaseProject에 속하지 않습니다.

  3. GCP Project는 Firebase 리소스가 추가되는 것을 방지하는 정책이 있는 조직에 속해 있지 않습니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

쿼리 매개변수

매개변수
pageToken

string

availableProjects.list에 대한 이전 호출에서 반환된 토큰으로 GCP Projects 집합 내에서 목록을 다시 시작할 위치를 나타냅니다.

pageSize

number

응답에서 반환할 GCP Projects의 최대 개수입니다.

서버는 자체 재량에 따라 이보다 더 적은 수의 GCP 프로젝트를 반환할 수 있습니다. 값을 지정하지 않을 경우(또는 너무 큰 값을 지정할 경우), 서버는 자체 한도를 적용합니다.

이 값은 음수일 수 없습니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현

{
  "projectInfo": [
    {
      object(ProjectInfo)
    }
  ],
  "nextPageToken": string
}
필드
projectInfo[]

object(ProjectInfo)

Firebase 리소스를 추가할 수 있는 GCP Projects 목록입니다.

nextPageToken

string

결과 목록이 너무 많아서 단일 응답에 맞지 않으면 토큰이 반환됩니다. 문자열이 비어 있다면 이 응답은 결과의 마지막 페이지에 해당됩니다.

이 토큰은 다음 GCP Projects 그룹을 찾기 위해 availableProjects.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

자세한 내용은 인증 개요를 참조하세요.

ProjectInfo

Google Cloud Platform(GCP) Project에 대한 참조입니다.

JSON 표현

{
  "project": string,
  "displayName": string,
  "locationId": string
}
필드
project

string

Firebase 리소스를 추가할 수 있는 GCP Project의 리소스 이름입니다. 예를 들면 다음과 같습니다.

projects/my-project-123

displayName

string

GCP Project의 사용자 지정 표시 이름입니다. 예를 들면 다음과 같습니다.

My App

locationId

string

다른 Firebase 리소스(예: Cloud Firestore)의 기본 리소스 위치입니다.
모든 프로젝트에서 이 필드가 채워지는 것은 아닙니다. 필드가 채워지지 않으면 프로젝트에 연결된 지역이 아직 없다는 의미입니다. 따라서 projects.addFirebase에 대한 호출은 이 경우에 위치를 제공해야 합니다.
예를 확인하려면 https://cloud.google.com/appengine/docs/locations를 참조하세요.

사용해 보기