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/v2/advertisers/{advertiserId}/insertionOrders/{insertionOrderId}/targetingTypes/{targetingType}/assignedTargetingOptions
Bắt buộc. Xác định loại lựa chọn 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 yêu cầu. Giá trị phải nằm trong khoảng từ 1 đến 5000. Nếu bạn không chỉ định, giá trị mặc định sẽ là 100. Trả về mã lỗi INVALID_ARGUMENT nếu bạn chỉ định một giá trị không hợp lệ.
pageToken
string
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 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, hệ thống sẽ trả về trang kết quả đầu tiên.
orderBy
string
Trường cần 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, bạn phải thêm hậu tố "description" 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 đã chỉ định.
Cú pháp được hỗ trợ:
Biểu thức lọc được tạo thành từ một hoặc nhiều hạn chế.
Bạn có thể kết hợp các quy tắc hạn chế bằng toán tử logic OR.
Quy định hạn chế có dạng {field} {operator} {value}.
Tất cả các trường phải sử dụng toán tử EQUALS (=).
Các trường được hỗ trợ:
assignedTargetingOptionId
inheritance
Ví dụ:
Tài nguyên AssignedTargetingOption có mã 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"
Độ 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 LIST 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 lựa chọn nhắm mục tiêu được chỉ định.
Danh sách này sẽ không hiển thị nếu trống.
nextPageToken
string
Mã thông báo xác định trang tiếp theo của kết quả. 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 xuất hiện nếu không còn assignedTargetingOptions nào để trả về.
