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ê các đơn vị quảng cáo. Ví dụ: accounts/pub-9876543210987654

Tham số truy vấn

Thông số
pageSize

integer

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

string

Giá trị được trả về bởi ListAdUnitsResponse gần nhất; giá trị này 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)

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

string

Nếu giá trị này không trống, thì điều đó có nghĩa là có thể có nhiều đơn vị quảng cáo hơn cho yêu cầu này; khi đó, bạn phải chuyển giá trị này vào trong một 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 OAuth 2.0 Overview.