- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- AdUnit
- Ví dụ
- Hãy làm thử!
Liệt kê các đơn vị quảng cáo trong tài khoản AdMob được chỉ định.
Yêu cầu HTTP
GET https://admob.googleapis.com/v1/{parent=accounts/*}/adUnits
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Các tham số | |
---|---|
parent |
Bắt buộc. Tên tài nguyên của tài khoản để liệt kê đơn vị quảng cáo. Ví dụ: accounts/pub-9876543210987654 |
Tham số truy vấn
Các tham số | |
---|---|
pageSize |
Số lượng đơn vị quảng cáo tối đa cần trả về. Nếu không chỉ định hoặc 0, thì hệ thống sẽ trả về tối đa 10.000 đơn vị quảng cáo. Giá trị tối đa là 20.000; các giá trị trên 20.000 sẽ bị buộc thành 20.000. |
pageToken |
Giá trị được |
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Phản hồi cho yêu cầu danh sách đơn vị quảng cáo.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"adUnits": [
{
object ( |
Các trường | |
---|---|
adUnits[] |
Đơn vị quảng cáo thu được cho tài khoản được yêu cầu. |
nextPageToken |
Nếu giá trị này không trống, hãy cho biết rằng có thể có nhiều đơn vị quảng cáo hơn cho yêu cầu này; giá trị này phải được chuyển vào một |
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/admob.readonly
Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.
AdUnit
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 ] } |
Các trường | |
---|---|
name |
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 |
Mã hiển thị bên ngoài của đơn vị quảng cáo, có thể dùng để tích hợp với AdMob SDK. Đây là thuộc tính chỉ đọc. Ví dụ: ca-app-pub-9876543210987654/0123456789 |
appId |
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 |
Tên hiển thị của đơn vị quảng cáo như 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 |
Đị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. "BANNER" – Đị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ác nhóm dàn xếp có thể nhắm mục tiêu định dạng này. "interSTITIAL" – 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". "NATIVE" – Định dạng quảng cáo gốc. "TẶNG THƯỞNG" – Quảng cáo mà sau khi được xem sẽ nhận được lệnh gọi lại xác minh lượt xem để có thể tặng 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 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. Xem https://support.google.com/admob/answer/9884467. |
adTypes[] |
Loại phương tiện quảng cáo được đơn vị quảng cáo này hỗ trợ. Các giá trị có thể có như sau: "MULTI_MEDIA" - Văn bản, hình ảnh và các nội dung đa phương tiện khác không phải video. "VIDEO" – Nội dung nghe nhìn video. |