Hiển thị và Video 360 API phiên bản 2 sẽ ngừng hoạt động từ ngày 3 tháng 9 năm 2024. Hãy chuyển sang phiên bản 3 trước thời điểm đó để tránh bị gián đoạn dịch vụ.
Liệt kê các lựa chọn nhắm mục tiêu được chỉ định cho một đơn đặt hàng quảng cáo.
Yêu cầu HTTP
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}/targetingTypes/{targetingType}/assignedTargetingOptions
Bắt buộc. Xác định loại tiêu chí nhắm mục tiêu được chỉ định để liệt kê.
Các loại nhắm mục tiêu được hỗ trợ bao gồm:
TARGETING_TYPE_AGE_RANGE
TARGETING_TYPE_APP
TARGETING_TYPE_APP_CATEGORY
TARGETING_TYPE_AUDIENCE_GROUP
TARGETING_TYPE_AUDIO_CONTENT_TYPE
TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
TARGETING_TYPE_BROWSER
TARGETING_TYPE_BUSINESS_CHAIN
TARGETING_TYPE_CARRIER_AND_ISP
TARGETING_TYPE_CATEGORY
TARGETING_TYPE_CHANNEL
TARGETING_TYPE_CONTENT_DURATION
TARGETING_TYPE_CONTENT_GENRE
TARGETING_TYPE_CONTENT_INSTREAM_POSITION
TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
TARGETING_TYPE_CONTENT_STREAM_TYPE
TARGETING_TYPE_DAY_AND_TIME
TARGETING_TYPE_DEVICE_MAKE_MODEL
TARGETING_TYPE_DEVICE_TYPE
TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
TARGETING_TYPE_ENVIRONMENT
TARGETING_TYPE_EXCHANGE
TARGETING_TYPE_GENDER
TARGETING_TYPE_GEO_REGION
TARGETING_TYPE_HOUSEHOLD_INCOME
TARGETING_TYPE_INVENTORY_SOURCE
TARGETING_TYPE_INVENTORY_SOURCE_GROUP
TARGETING_TYPE_KEYWORD
TARGETING_TYPE_LANGUAGE
TARGETING_TYPE_NATIVE_CONTENT_POSITION
TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
TARGETING_TYPE_OMID
TARGETING_TYPE_ON_SCREEN_POSITION
TARGETING_TYPE_OPERATING_SYSTEM
TARGETING_TYPE_PARENTAL_STATUS
TARGETING_TYPE_POI
TARGETING_TYPE_PROXIMITY_LOCATION_LIST
TARGETING_TYPE_REGIONAL_LOCATION_LIST
TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
TARGETING_TYPE_SUB_EXCHANGE
TARGETING_TYPE_THIRD_PARTY_VERIFIER
TARGETING_TYPE_URL
TARGETING_TYPE_USER_REWARDED_CONTENT
TARGETING_TYPE_VIDEO_PLAYER_SIZE
TARGETING_TYPE_VIEWABILITY
Tham số truy vấn
Tham số
pageSize
integer
Kích thước trang được yêu cầu. Phải trong khoảng từ 1 đến 5000. Nếu bạn không chỉ định, thì chế độ mặc định sẽ là 100. Trả về mã lỗi INVALID_ARGUMENT nếu chỉ định một giá trị không hợp lệ.
pageToken
string
Mã thông báo xác định một trang kết quả mà máy chủ sẽ trả về. Thông thường, đây là giá trị của nextPageToken được trả về từ lệnh gọi trước đó đến phương thức assignedTargetingOptions.list. Nếu không được chỉ định, trang kết quả đầu tiên sẽ được trả về.
orderBy
string
Trường mà bạn sẽ dùng để sắp xếp danh sách. Các giá trị được chấp nhận là:
assignedTargetingOptionId (mặc định)
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, hãy thêm hậu tố "desc" phải được thêm vào tên trường. Ví dụ: assignedTargetingOptionId desc
filter
string
Cho phép lọc theo các trường tuỳ chọn nhắm mục tiêu được chỉ định.
Cú pháp được hỗ trợ:
Biểu thức bộ lọc được tạo thành từ một hoặc nhiều giới hạn.
Các quy tắc hạn chế có thể được kết hợp bởi toán tử logic OR.
Hạn chế có dạng {field} {operator} {value}.
Tất cả các trường đều phải sử dụng toán tử EQUALS (=).
Các trường được hỗ trợ:
assignedTargetingOptionId
inheritance
Ví dụ:
Các tài nguyên AssignedTargetingOption có mã nhận dạng 1 hoặc 2: assignedTargetingOptionId="1" OR assignedTargetingOptionId="2"
Tài nguyên AssignedTargetingOption có trạng thái kế thừa là NOT_INHERITED hoặc INHERITED_FROM_PARTNER: inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER"
Trường này không được dài quá 500 ký tự.
Hãy tham khảo hướng dẫn về bộ lọc LIST yêu cầu của chúng tôi để biết thêm thông tin.
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:
Danh sách các tuỳ chọn nhắm mục tiêu được chỉ định.
Danh sách này sẽ không có nếu trống.
nextPageToken
string
Mã thông báo xác định trang kết quả tiếp theo. Giá trị này phải được chỉ định là pageToken trong ListInsertionOrderAssignedTargetingOptionsRequest tiếp theo để tìm nạp trang kết quả tiếp theo. Mã thông báo này sẽ không có nếu không còn assignedTargetingOptions để trả về.