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 Overview를 참조하세요.

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' - 동영상 미디어입니다.