Method: accounts.apps.list

지정된 AdMob 계정 아래에 앱을 나열합니다.

HTTP 요청

GET https://admob.googleapis.com/v1/{parent=accounts/*}/apps

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 앱을 나열할 계정의 리소스 이름입니다. 예: accounts/pub-9876543210987654

쿼리 매개변수

매개변수
pageSize

integer

반환할 앱의 최대 개수입니다. 지정하지 않거나 0이면 최대 10,000개의 앱이 반환됩니다. 최댓값은 20,000입니다. 20,000을 초과하는 값은 20,000으로 강제 변환됩니다.

pageToken

string

마지막 ListAppsResponse에서 반환된 값입니다. 는 이전 apps.list 호출의 연속이며 시스템에서 데이터의 다음 페이지를 반환해야 함을 나타냅니다.

요청 본문

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

응답 본문

앱 목록 요청에 대한 응답입니다.

성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.

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

object (App)

요청된 계정의 결과 앱입니다.

nextPageToken

string

비어 있지 않은 경우 요청을 위한 앱이 더 있을 수 있음을 나타냅니다. 이 값은 새 ListAppsRequest로 전달되어야 합니다.

승인 범위

다음 OAuth 범위가 필요합니다.

  • https://www.googleapis.com/auth/admob.readonly

자세한 내용은 OAuth 2.0 개요를 참고하세요.

특정 플랫폼 (예: Android 또는 iOS)용 AdMob 앱을 설명합니다.

JSON 표현
{
  "name": string,
  "appId": string,
  "platform": string,
  "manualAppInfo": {
    object (ManualAppInfo)
  },
  "linkedAppInfo": {
    object (LinkedAppInfo)
  },
  "appApprovalState": enum (AppApprovalState)
}
필드
name

string

이 앱의 리소스 이름입니다. 형식은 accounts/{publisherId}/apps/{app_id_fragment}입니다. 예: accounts/pub-9876543210987654/apps/0123456789

appId

string

AdMob SDK와 통합하는 데 사용할 수 있는 앱의 외부 공개 ID입니다. 읽기 전용 속성입니다. 예: ca-app-pub-9876543210987654~0123456789

platform

string

앱의 플랫폼을 설명합니다. 'iOS'로 제한 'ANDROID'가 포함됩니다.

manualAppInfo

object (ManualAppInfo)

앱 스토어에 연결되지 않은 앱에 관한 정보입니다.

앱이 연결된 후에도 이 정보를 검색할 수 있습니다. 생성 시 앱 이름을 제공하지 않으면 자리표시자 이름이 사용됩니다.

linkedAppInfo

object (LinkedAppInfo)

변경할 수 없습니다. 앱 스토어에 연결된 앱에 관한 정보입니다.

이 필드는 앱이 앱 스토어에 연결된 경우에만 표시됩니다.

appApprovalState

enum (AppApprovalState)

출력 전용입니다. 앱의 승인 상태입니다. 이 필드는 읽기 전용입니다.

ManualAppInfo

앱 스토어 (예: Google Play, App Store)와 연결되지 않은 수동 앱에 제공된 정보입니다.

JSON 표현
{
  "displayName": string
}
필드
displayName

string

AdMob UI에 표시되는 앱의 표시 이름으로, 사용자가 제공합니다. 허용되는 최대 길이는 80자(영문 기준)입니다.

LinkedAppInfo

앱이 앱 스토어에 연결된 경우 앱 스토어의 정보입니다.

JSON 표현
{
  "appStoreId": string,
  "displayName": string
}
필드
appStoreId

string

앱의 앱 스토어 ID 앱이 앱 스토어에 연결된 경우에만 표시됩니다.

앱이 Google Play 스토어에 추가되는 경우 앱의 애플리케이션 ID가 됩니다. 예: 'com.example.myapp' https://developer.android.com/studio/build/application-id를 참고하세요.

앱이 Apple App Store에 추가된 경우 앱 스토어 ID가 됩니다. 예: '105169111'

앱 스토어 ID 설정은 되돌릴 수 없는 작업으로 간주됩니다. 앱을 연결하고 나면 연결 해제할 수 없습니다.

displayName

string

출력 전용입니다. 앱 스토어에 표시되는 앱의 표시 이름입니다. 출력 전용 필드이며 스토어에서 앱을 찾을 수 없는 경우 비어 있을 수 있습니다.

AppApprovalState

모바일 앱의 앱 승인 상태입니다.

열거형
APP_APPROVAL_STATE_UNSPECIFIED 설정되지 않은 필드의 기본값입니다. 사용하지 마세요.
ACTION_REQUIRED 승인을 받으려면 앱에 추가적인 사용자 작업이 필요합니다. 자세한 내용 및 다음 단계는 https://support.google.com/admob/answer/10564477을 참조하세요.
IN_REVIEW 앱이 검토 대기 중입니다.
APPROVED 앱이 승인되어 광고를 게재할 수 있습니다.