Method: accounts.adUnits.list

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/v1beta/{parent=accounts/*}/adUnits

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
parent

string

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

Tham số
pageSize

integer

Số đơn vị quảng cáo tối đa cần trả về. Nếu bạn không chỉ định hoặc đặt giá trị là 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; nếu trên 20.000 thì bị buộc thành 20.000.
pageToken

string

Giá trị được ListAdUnitsResponse gần đây nhất trả về; cho biết đây là phần tiếp theo của lệnh gọi adUnits.list trước đó và hệ thống sẽ trả về trang dữ liệu tiếp theo.

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 (AdUnit)
    }
  ],
  "nextPageToken": string
}
Trường
adUnits[]

object (AdUnit)

Đơn vị quảng cáo thu được cho tài khoản được yêu cầu.
nextPageToken

string

Nếu không trống, điều này cho biết rằng có thể có nhiều đơn vị quảng cáo hơn cho yêu cầu; giá trị này phải được truyền trong ListAdUnitsRequest mới.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/admob.monetization
  • https://www.googleapis.com/auth/admob.readonly

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.