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 앱이 승인되어 광고를 게재할 수 있습니다.