Liệt kê các nguồn khoảng không 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
. Nếu bạn không chỉ định filter
của entityStatus
, thì những nguồn khoảng không quảng cáo có trạng thái thực thể ENTITY_STATUS_ARCHIVED
sẽ không được đưa vào kết quả.
Yêu cầu HTTP
GET https://displayvideo.googleapis.com/v2/inventorySources
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số truy vấn
Tham số | |
---|---|
pageSize |
Kích thước trang yêu cầu. Giá trị 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 trường nguồn của khoảng không 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 |
Tham số kết hợp accessor . Bắt buộc. Xác định thực thể DV360 mà yêu cầu đang được thực hiện. Yêu cầu LIST sẽ chỉ trả về các thực thể nguồn khoảng không quảng cáo mà thực thể DV360 có thể truy cập được trong accessor . accessor chỉ có thể là một trong những trạng thái sau: |
|
partnerId |
Mã của đối tác có quyền truy cập vào nguồn khoảng không quảng cáo. |
advertiserId |
Mã nhận dạng của nhà quảng cáo có quyền truy cập vào nguồn khoảng không quảng cáo. |
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 |
---|
{
"inventorySources": [
{
object ( |
Trường | |
---|---|
inventorySources[] |
Danh sách nguồn khoảng không quảng cáo. Danh sách này sẽ không hiển thị nếu trống. |
nextPageToken |
Mã thông báo để truy xuất trang tiếp theo của kết quả. 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.