Liệt kê những nhà quảng cáo mà người dùng hiện tại có thể truy cập.
Thứ tự này được xác định bằng tham số orderBy
.
Bắt buộc phải có một partnerId
. Không hỗ trợ danh sách nhiều đối tác.
Yêu cầu HTTP
GET https://displayvideo.googleapis.com/v3/advertisers
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
Các tham số | |
---|---|
partnerId |
Bắt buộc. Mã của đối tác chứa tất cả các nhà quảng cáo được tìm nạp. Hệ thống chỉ hỗ trợ liệt kê các nhà quảng cáo cho một đối tác tại một thời điểm. |
pageSize |
Kích thước trang được yêu cầu. Phải nằm trong khoảng từ |
pageToken |
Mã thông báo xác định trang kết quả mà máy chủ sẽ trả về. Thông thường, đây là giá trị của |
orderBy |
Trường cần sắp xếp danh sách. Các giá trị được chấp nhận là:
Thứ tự sắp xếp mặc định là tăng dần. Để chỉ định thứ tự giảm dần cho một trường, bạn phải thêm hậu tố "description" vào tên trường. Ví dụ: |
filter |
Cho phép lọc theo các trường của nhà quảng cáo. Cú pháp được hỗ trợ:
Các trường được hỗ trợ:
Ví dụ:
Độ dài của trường này không được vượt quá 500 ký tự. Hãy tham khảo hướng dẫn về yêu cầu lọ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
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 |
---|
{
"advertisers": [
{
object ( |
Các trường | |
---|---|
advertisers[] |
Danh sách các nhà quảng cáo. Danh sách này sẽ không có nếu trống. |
nextPageToken |
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 |
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/display-video
Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.