REST Resource: accounts.adUnits
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: AdUnit
JSON 표현 |
{
"name": string,
"adUnitId": string,
"appId": string,
"displayName": string,
"adFormat": string,
"adTypes": [
string
],
"rewardSettings": {
object (RewardSettings )
}
} |
필드 |
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' - 동영상 미디어
|
rewardSettings |
object (RewardSettings )
선택사항입니다. 보상형 광고 단위의 설정입니다. adFormat이 'REWARDED'인 경우에만 설정하거나 설정 해제할 수 있습니다.
|
RewardSettings
JSON 표현 |
{
"unitAmount": string,
"unitType": string
} |
필드 |
unitAmount |
string (int64 format)
이 광고 단위에 대한 리워드 금액입니다.
|
unitType |
string
이 광고 단위에 대한 보상을 제공합니다.
|
메서드 |
|
지정된 AdMob 계정에 광고 단위를 만듭니다. |
|
지정된 AdMob 계정에서 광고 단위를 나열합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-21(UTC)
[null,null,["최종 업데이트: 2025-08-21(UTC)"],[[["\u003cp\u003eThe AdUnit resource describes an AdMob ad unit, containing properties like name, ID, format, and reward settings.\u003c/p\u003e\n"],["\u003cp\u003eAdUnits support various ad formats, including banner, interstitial, rewarded, and native, each with specific properties and functionalities.\u003c/p\u003e\n"],["\u003cp\u003eRewardSettings, applicable to rewarded ad units, define the reward amount and type for users upon viewing an ad.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage AdUnits using the AdMob API to create new units and list existing ones under your account.\u003c/p\u003e\n"]]],["The core content details AdUnit and RewardSettings resources, including their JSON representations and fields. AdUnit describes an AdMob ad unit with properties like name, ID, app association, display name, format (e.g., banner, interstitial, rewarded), and supported ad types (e.g., rich media, video). RewardSettings defines settings for rewarded ad units, specifying the reward amount and item. Key methods are to create and list ad units under a given AdMob account.\n"],null,["# REST Resource: accounts.adUnits\n\n- [Resource: AdUnit](#AdUnit)\n - [JSON representation](#AdUnit.SCHEMA_REPRESENTATION)\n- [RewardSettings](#RewardSettings)\n - [JSON representation](#RewardSettings.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: AdUnit\n----------------\n\nDescribes an AdMob ad unit.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"adUnitId\": string, \"appId\": string, \"displayName\": string, \"adFormat\": string, \"adTypes\": [ string ], \"rewardSettings\": { object (/admob/api/reference/rest/v1beta/accounts.adUnits#RewardSettings) } } ``` |\n\n| Fields ||\n|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Resource name for this ad unit. Format is accounts/{publisherId}/adUnits/{ad_unit_id_fragment} Example: accounts/pub-9876543210987654/adUnits/0123456789 |\n| `adUnitId` | `string` The externally visible ID of the ad unit which can be used to integrate with the AdMob SDK. This is a read only property. Example: ca-app-pub-9876543210987654/0123456789 |\n| `appId` | `string` The externally visible ID of the app this ad unit is associated with. Example: ca-app-pub-9876543210987654\\~0123456789 |\n| `displayName` | `string` The display name of the ad unit as shown in the AdMob UI, which is provided by the user. The maximum length allowed is 80 characters. |\n| `adFormat` | `string` AdFormat of the ad unit. Possible values are as follows: \"APP_OPEN\" - App Open ad format. \"BANNER\" - Banner ad format. \"BANNER_INTERSTITIAL\" - Legacy format that can be used as either banner or interstitial. This format can no longer be created but can be targeted by mediation groups. \"INTERSTITIAL\" - A full screen ad. Supported ad types are \"RICH_MEDIA\" and \"VIDEO\". \"NATIVE\" - Native ad format. \"REWARDED\" - An ad that, once viewed, gets a callback verifying the view so that a reward can be given to the user. Supported ad types are \"RICH_MEDIA\" (interactive) and video where video can not be excluded. \"REWARDED_INTERSTITIAL\" - Rewarded Interstitial ad format. Only supports video ad type. See \u003chttps://support.google.com/admob/answer/9884467\u003e. |\n| `adTypes[]` | `string` Ad media type supported by this ad unit. Possible values as follows: \"RICH_MEDIA\" - Text, image, and other non-video media. \"VIDEO\" - Video media. |\n| `rewardSettings` | `object (`[RewardSettings](/admob/api/reference/rest/v1beta/accounts.adUnits#RewardSettings)`)` Optional. Settings for a rewarded ad unit. This can be set or unset only when the adFormat is \"REWARDED\". |\n\nRewardSettings\n--------------\n\nSettings for a rewarded ad unit.\n\n| JSON representation |\n|------------------------------------------------------|\n| ``` { \"unitAmount\": string, \"unitType\": string } ``` |\n\n| Fields ||\n|--------------|---------------------------------------------------------------------------------------------------------------------|\n| `unitAmount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Reward amount for this ad unit. |\n| `unitType` | `string` Reward item for this ad unit. |\n\n| Methods ------- ||\n|------------------------------------------------------------------------|-------------------------------------------------------|\n| ### [create](/admob/api/reference/rest/v1beta/accounts.adUnits/create) | Creates an ad unit under the specified AdMob account. |\n| ### [list](/admob/api/reference/rest/v1beta/accounts.adUnits/list) | List the ad units under the specified AdMob account. |"]]