多媒體和Video 360 API v2 將於
2024 年 9 月 3 日停用。請在此之前
遷移至第 3 版,以免服務中斷。
Method: targetingTypes.targetingOptions.list
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
GET https://displayvideo.googleapis.com/v1/targetingTypes/{targetingType}/targetingOptions
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
targetingType |
enum (TargetingType )
必要欄位。要列出的指定目標選項類型。 可接受的值如下:
TARGETING_TYPE_APP_CATEGORY
TARGETING_TYPE_AGE_RANGE
TARGETING_TYPE_GENDER
TARGETING_TYPE_VIDEO_PLAYER_SIZE
TARGETING_TYPE_USER_REWARDED_CONTENT
TARGETING_TYPE_PARENTAL_STATUS
TARGETING_TYPE_CONTENT_INSTREAM_POSITION
TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
TARGETING_TYPE_DEVICE_TYPE
TARGETING_TYPE_BROWSER
TARGETING_TYPE_HOUSEHOLD_INCOME
TARGETING_TYPE_ON_SCREEN_POSITION
TARGETING_TYPE_CARRIER_AND_ISP
TARGETING_TYPE_OPERATING_SYSTEM
TARGETING_TYPE_DEVICE_MAKE_MODEL
TARGETING_TYPE_ENVIRONMENT
TARGETING_TYPE_CATEGORY
TARGETING_TYPE_VIEWABILITY
TARGETING_TYPE_AUTHORIZED_SELLER_STATUS
TARGETING_TYPE_LANGUAGE
TARGETING_TYPE_GEO_REGION
TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
TARGETING_TYPE_EXCHANGE
TARGETING_TYPE_SUB_EXCHANGE
TARGETING_TYPE_NATIVE_CONTENT_POSITION
TARGETING_TYPE_OMID
|
查詢參數
參數 |
advertiserId |
string (int64 format)
必要欄位。這項要求所提出的對象為。
|
pageSize |
integer
要求的頁面大小。必須介於 1 至 200 之間。如果未指定,則預設為 100 。如果指定無效的值,則傳回錯誤代碼 INVALID_ARGUMENT 。
|
pageToken |
string
識別伺服器應傳回之結果頁面的符記。通常這是先前呼叫 targetingOptions.list 方法後傳回的 nextPageToken 值。如未指定,系統會傳回第一頁的結果。
|
orderBy |
string
清單排序依據的欄位。可接受的值為:
預設的排序順序是遞增。如要為欄位指定遞減順序,請在欄位名稱中加入後置字串「desc」。範例:targetingOptionId desc 。
|
filter |
string
允許按指定選項欄位進行篩選。 支援的語法:
- 篩選器運算式由一或多項限制組成。
- 限制可透過
OR 邏輯運算子合併。
- 限制的形式為
{field} {operator} {value} 。
- 所有欄位都必須使用
EQUALS (=) 運算子。
支援的欄位:
carrierAndIspDetails.type
geoRegionDetails.geoRegionType
targetingOptionId
示例:
- 屬於子類型
GEO_REGION_TYPE_COUNTRY 或 GEO_REGION_TYPE_STATE 的所有GEO REGION 指定目標選項:geoRegionDetails.geoRegionType="GEO_REGION_TYPE_COUNTRY" OR
geoRegionDetails.geoRegionType="GEO_REGION_TYPE_STATE"
- 所有屬於子類型
CARRIER_AND_ISP_TYPE_CARRIER 的CARRIER AND ISP 指定目標選項:carrierAndIspDetails.type="CARRIER_AND_ISP_TYPE_CARRIER"
這個欄位的長度不得超過 500 個字元。 詳情請參閱篩選器 LIST 要求指南。
|
回應主體
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
{
"targetingOptions": [
{
object (TargetingOption )
}
],
"nextPageToken": string
} |
欄位 |
targetingOptions[] |
object (TargetingOption )
指定目標選項清單。 如果留空,這份清單將不會顯示。
|
nextPageToken |
string
用於擷取下一頁結果的權杖。在對 targetingOptions.list 方法的後續呼叫中將這個值傳入 pageToken 欄位,即可擷取下一頁的結果。
|
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/display-video
詳情請參閱 OAuth 2.0 總覽。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2023-12-02 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{
"last_modified": "上次更新時間:2023-12-02 (世界標準時間)。",
"state": ""
}