Method: projects.searchApps

지정된 FirebaseProject에 사용 가능한 모든 앱을 나열합니다.

이는 편의 메서드입니다. 일반적으로 앱과의 상호작용은 플랫폼별 서비스를 사용해야 하며 다만 일부 도구 사용 사례의 경우, 알려진 모든 앱의 요약(예: 앱 선택기 인터페이스)이 필요합니다.

HTTP 요청

GET https://firebase.googleapis.com/v1beta1/{parent=projects/*}:searchApps

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

경로 매개변수

매개변수
parent

string

앱을 나열할 상위 FirebaseProject이며 형식은 다음과 같습니다.

projects/PROJECT_IDENTIFIER

PROJECT_IDENTIFIER 값에 대한 자세한 내용은 FirebaseProject name 필드를 참조하세요.

쿼리 매개변수

매개변수
pageToken

string

앱 집합 내에서 목록을 다시 시작할 위치를 나타내는 projects.searchApps에 대한 이전 호출에서 반환된 토큰입니다.
pageSize

integer

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

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

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

string

Google의 AIP-160 표준과 호환되는 쿼리 문자열입니다.

쿼리에 다음 필드 중 하나를 사용합니다.

이 쿼리는 있습니다. 실제로 반환된 리소스 객체의 일부가 아닌 필드이지만 특정 값으로 미리 채워진 것처럼 쿼리할 수 있습니다.

  • sha1_hash 또는 sha1Hashes: 이 필드는 AndroidApp로 등록된 모든 SHA-1 인증서 지문 목록으로 채워진 반복 string 필드로 간주됩니다. 앱이 AndroidApp이 아니면 이 목록은 비어 있습니다.
  • sha256_hash 또는 sha256Hashes: 이 필드는 AndroidApp로 등록된 모든 SHA-256 인증서 지문 목록으로 채워진 반복 string 필드로 간주됩니다. 앱이 AndroidApp이 아니면 이 목록은 비어 있습니다.
  • appStoreId: 이 필드는 IosApp에 등록된 Apple App Store ID로 채워진 단일 string 필드로 간주됩니다. 앱이 IosApp이 아닌 경우 이 필드는 비어 있습니다.
  • teamId: 이 필드는 IosApp에 등록된 Apple 팀 ID로 채워진 단일 string 필드로 간주됩니다. 앱이 IosApp이 아닌 경우 이 필드는 비어 있습니다.
showDeleted

boolean

DELETED 상태의 앱을 반환해야 하는지 여부를 제어합니다.

지정하지 않으면 ACTIVE개의 앱만 반환됩니다.

요청 본문

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

응답 본문

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

JSON 표현 
{
  "apps": [
    {
      object (FirebaseAppInfo)
    }
  ],
  "nextPageToken": string
}
필드
apps[]

object (FirebaseAppInfo)

projects.searchApps 호출 결과의 한 페이지입니다.
nextPageToken

string

결과 목록이 너무 많아서 단일 응답에 맞지 않으면 토큰이 반환됩니다.

이 토큰은 다음 앱 그룹을 찾기 위해 projects.searchApps에 대한 후속 호출에서 사용할 수 있습니다.

페이지 토큰은 수명이 짧기 때문에 유지해서는 안 됩니다.

승인 범위

다음 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

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

FirebaseAppInfo

앱에 대한 개략적인 요약입니다.

JSON 표현 
{
  "name": string,
  "displayName": string,
  "platform": enum (AppPlatform),
  "appId": string,
  "namespace": string,
  "apiKeyId": string,
  "state": enum (State)
}
필드
name

string

Firebase 앱의 리소스 이름으로서 형식은 다음과 같습니다.

projects/PROJECT_ID/iosApps/APP_ID

또는

projects/PROJECT_ID/androidApps/APP_ID

또는

projects/PROJECT_ID/webApps/APP_ID
displayName

string

Firebase 앱의 사용자 지정 표시 이름입니다.
platform

enum (AppPlatform)

Firebase 앱의 플랫폼입니다.
appId

string

출력 전용입니다. 변경할 수 없습니다. WebApp의 전역적으로 고유한 Firebase 할당 식별자입니다.

데이터 형식이 지정되지 않았으므로 이 ID는 불투명한 토큰으로 처리되어야 합니다.
namespace

string

출력 전용입니다. 변경할 수 없습니다. 앱의 플랫폼별 식별자입니다.

참고: 대부분의 사용 사례에서는 앱을 참조하는 데 사용되는 표준 전역 고유 식별자인 appId를 사용합니다.

이 문자열은 각 플랫폼의 네이티브 식별자(AndroidApp의 경우 packageName, IosApp의 경우 bundleId, WebApp의 경우 webId)에서 파생됩니다. 플랫폼의 발전에 따라 네이티브 식별자 형식이 변경될 수 있으므로 콘텐츠는 불투명으로 처리해야 합니다. 이 문자열은 FirebaseProject 및 연결된 앱 내에서만 고유합니다.
apiKeyId

string

앱과 연결된 Firebase API 키의 전역적으로 고유한 Google 할당 식별자 (UID)입니다.

이 값은 API 키의 keyString가 아닌 API 키의 UID입니다. keyString는 앱의 구성 아티팩트 (AndroidApp | IosApp | WebApp)에서 찾을 수 있는 값입니다.

앱 생성 요청에 apiKeyId가 설정되어 있지 않으면 (AndroidApp | IosApp | WebApp) Firebase에서 자동으로 apiKeyId를 앱에 연결합니다. 이 자동 연결 키는 유효한 기존 키이거나, 유효한 키가 없는 경우 새 키가 프로비저닝됩니다.
state

enum (State)

출력 전용입니다. 앱의 수명 주기 상태입니다.

AppPlatform

Firebase 앱과 연결할 수 있는 플랫폼입니다.

열거형
PLATFORM_UNSPECIFIED 알 수 없는 상태입니다. 설정되지 않은 값을 구별하는 데만 사용됩니다.
IOS Firebase 앱은 iOS와 연결됩니다.
ANDROID Firebase 앱은 Android와 연결됩니다.
WEB Firebase 앱은 웹과 연결되어 있습니다.