歡迎加入
Google 廣告與評估社群 伺服器的官方 Display & Video 360 API 和結構化資料檔案 Discord 頻道,一起討論產品並交流心得。
Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
Method: advertisers.lineItems.bulkListLineItemAssignedTargetingOptions
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
多媒體和Video 360 API 第 1 版已淘汰。
HTTP 要求
GET https://displayvideo.googleapis.com/v1/advertisers/{advertiserId}/lineItems/{lineItemId}:bulkListLineItemAssignedTargetingOptions
這個網址使用 gRPC 轉碼 語法。
路徑參數
參數
advertiserId
string (int64 format)
必要欄位。委刊項所屬的廣告主 ID。
lineItemId
string (int64 format)
必要欄位。要列出所指派指定目標選項的委刊項 ID。
查詢參數
參數
pageSize
integer
要求的頁面大小。大小必須是介於 1 至 5000 之間的整數。如果未指定,則預設值為 5000。如果指定的值無效,則傳回錯誤代碼 INVALID_ARGUMENT。
pageToken
string
可讓用戶端擷取下一頁結果的憑證。一般而言,這是從先前呼叫 lineItems.bulkListLineItemAssignedTargetingOptions 方法傳回的 nextPageToken 值。如果未指定,系統將傳回第一頁的結果。
orderBy
string
清單排序依據的欄位。可接受的值為:
預設的排序順序是遞增。如要為欄位指定遞減順序,請在後方加上「desc」即可加入欄位名稱。範例:targetingType desc。
filter
string
可依指派的指定目標選項欄位篩選資料。
支援的語法:
篩選器運算式由一或多個限制組成。
限制可用邏輯運算子 OR 合併。
限制的形式為 {field} {operator} {value}。
所有欄位都必須使用 EQUALS (=) 運算子。
支援的欄位:
targetingType
inheritance
範例:
AssignedTargetingOption 個指定類型為 TARGETING_TYPE_PROXIMITY_LOCATION_LIST 或 TARGETING_TYPE_CHANNEL 的資源:targetingType="TARGETING_TYPE_PROXIMITY_LOCATION_LIST" OR
targetingType="TARGETING_TYPE_CHANNEL"
AssignedTargetingOption 項資源繼承狀態為 NOT_INHERITED 或 INHERITED_FROM_PARTNER:inheritance="NOT_INHERITED" OR inheritance="INHERITED_FROM_PARTNER"
這個欄位的長度不得超過 500 個半形字元。
詳情請參閱篩選器 LIST 要求 指南。
回應主體
如果成功,回應主體即會包含具有以下結構的資料:
欄位
assignedTargetingOptions[]
object (AssignedTargetingOption )
指派的指定目標選項清單。
如果留空,這份清單就不會顯示。
nextPageToken
string
用於識別下一頁結果的符記。您必須在後續的 BulkListLineItemAssignedTargetingOptionsRequest 中將這個值指定為 pageToken ,以擷取下一頁的結果。如果沒有要傳回的 assignedTargetingOptions ,則會缺少這個權杖。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/display-video
詳情請參閱 OAuth 2.0 總覽 。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權 ,程式碼範例則為阿帕契 2.0 授權 。詳情請參閱《Google Developers 網站政策 》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[],["This API endpoint retrieves a list of assigned targeting options for a specific line item within an advertiser's account. Key actions include sending a `GET` request to the specified URL, using `advertiserId` and `lineItemId` as path parameters. Optional query parameters like `pageSize`, `pageToken`, `orderBy`, and `filter` can be used to customize the results. The API returns a list of `assignedTargetingOptions` and a `nextPageToken` for paginating through results, requiring the `display-video` authorization scope.\n"]]