- HTTP 요청
- 경로 매개변수
- 쿼리 매개변수
- 요청 본문
- 응답 본문
- 승인 범위
- AdUnit
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 예시
- 실습
지정된 AdMob 계정에서 광고 단위를 나열합니다.
HTTP 요청
GET https://admob.googleapis.com/v1/{parent=accounts/*}/adUnits
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 | |
---|---|
parent |
필수 항목입니다. 광고 단위를 나열할 계정의 리소스 이름입니다. 예: accounts/pub-9876543210987654 |
쿼리 매개변수
매개변수 | |
---|---|
pageSize |
반환할 광고 단위의 최대 개수입니다. 지정하지 않거나 0이면 최대 10,000개의 광고 단위가 반환됩니다. 최댓값은 20,000입니다. 20,000을 초과하는 값은 20,000으로 강제 변환됩니다. |
pageToken |
마지막 |
요청 본문
요청 본문은 비어 있어야 합니다.
응답 본문
광고 단위 목록 요청에 대한 응답입니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
JSON 표현 |
---|
{
"adUnits": [
{
object ( |
필드 | |
---|---|
adUnits[] |
요청된 계정의 결과 광고 단위입니다. |
nextPageToken |
비어 있지 않은 경우 요청에 대한 광고 단위가 더 있을 수 있음을 나타냅니다. 이 값은 새 |
승인 범위
다음 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 |
이 광고 단위의 리소스 이름입니다. 형식은 accounts/{publisherId}/adUnits/{ad_unit_id_fragment}입니다. 예: accounts/pub-9876543210987654/adUnits/0123456789 |
adUnitId |
AdMob SDK와 통합하는 데 사용할 수 있는 광고 단위의 외부 공개 ID입니다. 읽기 전용 속성입니다. 예: ca-app-pub-9876543210987654/0123456789 |
appId |
이 광고 단위와 연결된 앱의 외부에 표시되는 ID입니다. 예: ca-app-pub-9876543210987654~0123456789 |
displayName |
AdMob UI에 표시되는 광고 단위의 표시 이름으로, 사용자가 제공합니다. 허용되는 최대 길이는 80자(영문 기준)입니다. |
adFormat |
광고 단위의 AdFormat입니다. 가능한 값은 다음과 같습니다. 'APP_OPEN' - 앱 오프닝 광고 형식: 'BANNER' - 배너 광고 형식. 'BANNER_INTERSTITIAL' - 배너 또는 전면 광고로 사용할 수 있는 기존 형식 이 형식은 더 이상 만들 수 없지만 미디에이션 그룹에서 타겟팅할 수 있습니다. 'INTERSTITIAL' - 전체 화면 광고 지원되는 광고 유형은 'RICH_MEDIA'입니다. 'VIDEO'가 포함됩니다. 'NATIVE' - 네이티브 광고 형식. 'REWARDED' - 사용자가 보상을 받을 수 있도록 조회를 확인하는 콜백이 조회된 광고 지원되는 광고 유형은 'RICH_MEDIA'입니다. (양방향) 및 동영상을 제외할 수 없는 동영상 'REWARDED_INTERSTITIAL' - 보상형 전면 광고 형식 동영상 광고 유형만 지원합니다. https://support.google.com/admob/answer/9884467을 참고하세요. |
adTypes[] |
이 광고 단위에서 지원하는 광고 미디어 유형입니다. 가능한 값은 다음과 같습니다. 'RICH_MEDIA' - 텍스트, 이미지 및 동영상이 아닌 기타 미디어 'VIDEO' - 동영상 미디어 |