REST Resource: accounts.adUnits
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: Đơn vị quảng cáo
Mô tả một đơn vị quảng cáo AdMob.
Biểu diễn dưới dạng JSON |
{
"name": string,
"adUnitId": string,
"appId": string,
"displayName": string,
"adFormat": string,
"adTypes": [
string
],
"rewardSettings": {
object (RewardSettings )
}
} |
Trường |
name |
string
Tên tài nguyên cho đơn vị quảng cáo này. Định dạng là accounts/{publisherId}/adUnits/{ad_unit_id_fragment} Ví dụ: accounts/pub-9876543210987654/adUnits/0123456789
|
adUnitId |
string
Mã hiển thị bên ngoài của đơn vị quảng cáo có thể được dùng để tích hợp với AdMob SDK. Đây là tài sản chỉ có thể đọc. Ví dụ: ca-app-pub-9876543210987654/0123456789
|
appId |
string
Mã hiển thị bên ngoài của ứng dụng liên kết với đơn vị quảng cáo này. Ví dụ: ca-app-pub-9876543210987654~0123456789
|
displayName |
string
Tên hiển thị của đơn vị quảng cáo như hiển thị trong giao diện người dùng AdMob, do người dùng cung cấp. Độ dài tối đa cho phép là 80 ký tự.
|
adFormat |
string
Định dạng quảng cáo của đơn vị quảng cáo. Các giá trị có thể có như sau: "APP_OPEN" – Định dạng quảng cáo khi mở ứng dụng. "BIỂU NGỮ" – Định dạng quảng cáo biểu ngữ. "BANNER_INTERSTITIAL" - Định dạng cũ có thể được sử dụng làm biểu ngữ hoặc quảng cáo xen kẽ. Bạn không thể tạo định dạng này nữa nhưng có thể nhắm mục tiêu theo nhóm dàn xếp. "XEN KẼ" – Quảng cáo toàn màn hình. Các loại quảng cáo được hỗ trợ là "MULTI_MEDIA" và "VIDEO". "GỐC" – Định dạng quảng cáo gốc. "ĐƯỢC TẶNG THƯỞNG" - Sau khi được xem, quảng cáo sẽ nhận được lệnh gọi lại xác minh lượt xem để có thể trao phần thưởng cho người dùng. Các loại quảng cáo được hỗ trợ là "MULTI_MEDIA" (tương tác) và video trong đó không thể loại trừ video. "REWARDED_INTERSTITIAL" – Định dạng quảng cáo xen kẽ có tặng thưởng. Chỉ hỗ trợ loại quảng cáo dạng video. Hãy xem https://support.google.com/admob/answer/9884467.
|
adTypes[] |
string
Loại phương tiện quảng cáo được đơn vị quảng cáo này hỗ trợ. Có thể sử dụng các giá trị sau: "Đa phương tiện" – Văn bản, hình ảnh và các phương tiện khác không phải video. "VIDEO" – Phương tiện video.
|
rewardSettings |
object (RewardSettings )
Không bắt buộc. Chế độ cài đặt cho đơn vị quảng cáo có tặng thưởng. Bạn chỉ có thể đặt hoặc không đặt chính sách này khi định dạng quảng cáo là "REWARDED".
|
RewardSettings
Chế độ cài đặt cho đơn vị quảng cáo có tặng thưởng.
Biểu diễn dưới dạng JSON |
{
"unitAmount": string,
"unitType": string
} |
Trường |
unitAmount |
string (int64 format)
Số tiền thưởng cho đơn vị quảng cáo này.
|
unitType |
string
Vật phẩm tặng thưởng cho đơn vị quảng cáo này.
|
Phương thức |
|
Tạo một đơn vị quảng cáo trong tài khoản AdMob được chỉ định. |
|
Liệt kê các đơn vị quảng cáo trong tài khoản AdMob được chỉ định. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-21 UTC.
[null,null,["Cập nhật lần gần đây nhất: 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. |"]]