Method: sellers.adUnits.list

Liệt kê các đơn vị quảng cáo.

  • Ví dụ: GET /v1/sellers/seller111/adUnits
  • Trả về danh sách đơn vị quảng cáo và mã thông báo để truy xuất trang tiếp theo nếu thành công.
  • Trả về mã lỗi PERMISSION_DENIED nếu người dùng không có quyền truy cập vào mã người bán hoặc mã người bán không tồn tại.
  • Trả về mã lỗi INVALID_ARGUMENT nếu người bán cung cấp kích thước trang hoặc mã thông báo trang không hợp lệ.

Yêu cầu HTTP

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/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. Người bán sở hữu tập hợp đơn vị quảng cáo này. Định dạng: người bán/{seller}

Tham số truy vấn

Tham số
pageSize

integer

Số lượng mục tối đa cần trả về. Dịch vụ có thể trả về ít hơn giá trị này. Số đơn vị quảng cáo tối đa được phép là 1.000; các giá trị lớn hơn 1000 sẽ được thay đổi thành 1000. Nếu bạn không chỉ định, hệ thống sẽ trả về tối đa 1.000 đơn vị quảng cáo.
pageToken

string

Giá trị nextPageToken được trả về từ một yêu cầu Danh sách trước đó (nếu có).
filter

string

Bộ lọc danh sách. Hiện hỗ trợ mã nhận dạng bên ngoài và tính năng lọc trạng thái, với cú pháp: "externalId = [EXTERNAL_ID]" và "state = [STATE]". Bạn có thể sử dụng các toán tử logic AND và OR để liên kết bộ lọc. Không thể sử dụng AD_UNIT_STATE_DELETED để hiển thị các đơn vị quảng cáo đã xóa, hãy sử dụng showDeleted để thay thế.
orderBy

string

Thứ tự theo chuỗi được dùng để chỉ định thứ tự sắp xếp của các kết quả. Hiện hỗ trợ sắp xếp theo updateTime, hãy cung cấp "updateTime" để nhận kết quả được sắp xếp theo updateTime theo thứ tự tăng dần hoặc "theo mô tả updateTime" theo thứ tự giảm dần.
showDeleted

boolean

Liệu có trả lại đơn vị quảng cáo bị xoá tạm thời hay không.

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

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:

Thông báo phản hồi cho InventoryService.ListAdUnits.

Biểu diễn dưới dạng JSON 
{
  "adUnits": [
    {
      object (AdUnit)
    }
  ],
  "nextPageToken": string
}
Trường
adUnits[]

object (AdUnit)

Danh sách đơn vị quảng cáo.
nextPageToken

string

Mã thông báo để truy xuất trang kết quả tiếp theo. Truyền giá trị này vào trường pageToken trong lệnh gọi tiếp theo đến phương thức adUnits.list để truy xuất trang kết quả tiếp theo.

Phạm vi cấp phép

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/doubleclickbidmanager

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