Method: accounts.adUnits.list

지정된 AdMob 계정에서 광고 단위를 나열합니다.

HTTP 요청

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

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

경로 매개변수

매개변수
parent

string

필수 항목입니다. 광고 단위를 나열할 계정의 리소스 이름입니다. 예: accounts/pub-9876543210987654

쿼리 매개변수

매개변수
pageSize

integer

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

pageToken

string

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

요청 본문

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

응답 본문

광고 단위 목록 요청에 대한 응답입니다.

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

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

object (AdUnit)

요청된 계정의 결과 광고 단위입니다.

nextPageToken

string

비어 있지 않은 경우 요청에 대한 광고 단위가 더 있을 수 있음을 나타냅니다. 이 값은 새 ListAdUnitsRequest로 전달되어야 합니다.

승인 범위

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

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

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

AdUnit

AdMob 광고 단위를 설명합니다.

JSON 표현
{
  "name": string,
  "adUnitId": string,
  "appId": string,
  "displayName": string,
  "adFormat": string,
  "adTypes": [
    string
  ]
}
필드
name

string

이 광고 단위의 리소스 이름입니다. 형식은 accounts/{publisherId}/adUnits/{ad_unit_id_fragment}입니다. 예: accounts/pub-9876543210987654/adUnits/0123456789

adUnitId

string

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

appId

string

이 광고 단위와 연결된 앱의 외부에 표시되는 ID입니다. 예: ca-app-pub-9876543210987654~0123456789

displayName

string

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

adFormat

string

광고 단위의 AdFormat입니다. 가능한 값은 다음과 같습니다.

'APP_OPEN' - 앱 오프닝 광고 형식: 'BANNER' - 배너 광고 형식. 'BANNER_INTERSTITIAL' - 배너 또는 전면 광고로 사용할 수 있는 기존 형식 이 형식은 더 이상 만들 수 없지만 미디에이션 그룹에서 타겟팅할 수 있습니다. 'INTERSTITIAL' - 전체 화면 광고 지원되는 광고 유형은 'RICH_MEDIA'입니다. 'VIDEO'가 포함됩니다. 'NATIVE' - 네이티브 광고 형식. 'REWARDED' - 사용자가 보상을 받을 수 있도록 조회를 확인하는 콜백이 조회된 광고 지원되는 광고 유형은 'RICH_MEDIA'입니다. (양방향) 및 동영상을 제외할 수 없는 동영상 'REWARDED_INTERSTITIAL' - 보상형 전면 광고 형식 동영상 광고 유형만 지원합니다. https://support.google.com/admob/answer/9884467을 참고하세요.

adTypes[]

string

이 광고 단위에서 지원하는 광고 미디어 유형입니다. 가능한 값은 다음과 같습니다.

'RICH_MEDIA' - 텍스트, 이미지 및 동영상이 아닌 기타 미디어 'VIDEO' - 동영상 미디어