自
2025 年 9 月 8 日起，每個新委刊項都必須聲明是否會放送歐盟政治廣告。如果透過 Display & Video 360 API 和 SDF 上傳的檔案未提供聲明，系統就會失敗。如要進一步瞭解如何更新整合服務以進行這項聲明，請參閱
淘汰項目頁面。
Method: advertisers.lineItems.bulkEditAssignedTargetingOptions
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkEditAssignedTargetingOptions
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 |
advertiserId |
string (int64 format)
必要欄位。委刊項所屬廣告主的 ID。
|
要求主體
要求主體的資料會採用以下結構：
| 欄位 |
lineItemIds[] |
string (int64 format)
必要欄位。指定目標更新對象的委刊項 ID。
|
deleteRequests[] |
object (DeleteAssignedTargetingOptionsRequest)
要以批次刪除的指定目標選項，以 DeleteAssignedTargetingOptionsRequest 的清單形式指定。 支援的指定類型包括：
TARGETING_TYPE_AGE_RANGETARGETING_TYPE_APPTARGETING_TYPE_APP_CATEGORYTARGETING_TYPE_AUDIENCE_GROUPTARGETING_TYPE_AUDIO_CONTENT_TYPETARGETING_TYPE_AUTHORIZED_SELLER_STATUSTARGETING_TYPE_BROWSERTARGETING_TYPE_BUSINESS_CHAINTARGETING_TYPE_CARRIER_AND_ISPTARGETING_TYPE_CATEGORYTARGETING_TYPE_CHANNELTARGETING_TYPE_CONTENT_DURATIONTARGETING_TYPE_CONTENT_GENRETARGETING_TYPE_CONTENT_INSTREAM_POSITIONTARGETING_TYPE_CONTENT_OUTSTREAM_POSITIONTARGETING_TYPE_CONTENT_STREAM_TYPETARGETING_TYPE_DAY_AND_TIMETARGETING_TYPE_DEVICE_MAKE_MODELTARGETING_TYPE_DEVICE_TYPETARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSIONTARGETING_TYPE_ENVIRONMENTTARGETING_TYPE_EXCHANGETARGETING_TYPE_GENDERTARGETING_TYPE_GEO_REGIONTARGETING_TYPE_HOUSEHOLD_INCOMETARGETING_TYPE_INVENTORY_SOURCETARGETING_TYPE_INVENTORY_SOURCE_GROUPTARGETING_TYPE_KEYWORDTARGETING_TYPE_LANGUAGETARGETING_TYPE_NATIVE_CONTENT_POSITIONTARGETING_TYPE_NEGATIVE_KEYWORD_LISTTARGETING_TYPE_OMIDTARGETING_TYPE_ON_SCREEN_POSITIONTARGETING_TYPE_OPERATING_SYSTEMTARGETING_TYPE_PARENTAL_STATUSTARGETING_TYPE_POITARGETING_TYPE_PROXIMITY_LOCATION_LISTTARGETING_TYPE_REGIONAL_LOCATION_LISTTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSIONTARGETING_TYPE_SUB_EXCHANGETARGETING_TYPE_THIRD_PARTY_VERIFIERTARGETING_TYPE_URLTARGETING_TYPE_USER_REWARDED_CONTENTTARGETING_TYPE_VIDEO_PLAYER_SIZETARGETING_TYPE_VIEWABILITY
|
createRequests[] |
object (CreateAssignedTargetingOptionsRequest)
要以批次建立的指定目標選項，以 CreateAssignedTargetingOptionsRequest 的清單形式指定。 支援的指定類型包括：
TARGETING_TYPE_AGE_RANGETARGETING_TYPE_APPTARGETING_TYPE_APP_CATEGORYTARGETING_TYPE_AUDIENCE_GROUPTARGETING_TYPE_AUDIO_CONTENT_TYPETARGETING_TYPE_AUTHORIZED_SELLER_STATUSTARGETING_TYPE_BROWSERTARGETING_TYPE_BUSINESS_CHAINTARGETING_TYPE_CARRIER_AND_ISPTARGETING_TYPE_CATEGORYTARGETING_TYPE_CHANNELTARGETING_TYPE_CONTENT_DURATIONTARGETING_TYPE_CONTENT_GENRETARGETING_TYPE_CONTENT_INSTREAM_POSITIONTARGETING_TYPE_CONTENT_OUTSTREAM_POSITIONTARGETING_TYPE_CONTENT_STREAM_TYPETARGETING_TYPE_DAY_AND_TIMETARGETING_TYPE_DEVICE_MAKE_MODELTARGETING_TYPE_DEVICE_TYPETARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSIONTARGETING_TYPE_ENVIRONMENTTARGETING_TYPE_EXCHANGETARGETING_TYPE_GENDERTARGETING_TYPE_GEO_REGIONTARGETING_TYPE_HOUSEHOLD_INCOMETARGETING_TYPE_INVENTORY_SOURCETARGETING_TYPE_INVENTORY_SOURCE_GROUPTARGETING_TYPE_KEYWORDTARGETING_TYPE_LANGUAGETARGETING_TYPE_NATIVE_CONTENT_POSITIONTARGETING_TYPE_NEGATIVE_KEYWORD_LISTTARGETING_TYPE_OMIDTARGETING_TYPE_ON_SCREEN_POSITIONTARGETING_TYPE_OPERATING_SYSTEMTARGETING_TYPE_PARENTAL_STATUSTARGETING_TYPE_POITARGETING_TYPE_PROXIMITY_LOCATION_LISTTARGETING_TYPE_REGIONAL_LOCATION_LISTTARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSIONTARGETING_TYPE_SUB_EXCHANGETARGETING_TYPE_THIRD_PARTY_VERIFIERTARGETING_TYPE_URLTARGETING_TYPE_USER_REWARDED_CONTENTTARGETING_TYPE_VIDEO_PLAYER_SIZETARGETING_TYPE_VIEWABILITY
|
回應主體
| JSON 表示法 |
{
"updatedLineItemIds": [
string
],
"failedLineItemIds": [
string
],
"errors": [
{
object (Status)
}
]
} |
| 欄位 |
updatedLineItemIds[] |
string (int64 format)
僅供輸出。已成功更新的委刊項 ID。
|
failedLineItemIds[] |
string (int64 format)
僅供輸出。失敗委刊項的 ID。
|
errors[] |
object (Status)
每個無法更新的委刊項錯誤資訊。
|
授權範圍
需要下列 OAuth 範圍：
https://www.googleapis.com/auth/display-video
詳情請參閱 OAuth 2.0 Overview。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-07-25 (世界標準時間)。
[null,null,["上次更新時間：2025-07-25 (世界標準時間)。"],[[["\u003cp\u003eThis endpoint enables bulk editing of targeting options for multiple line items by deleting and creating assigned targeting options.\u003c/p\u003e\n"],["\u003cp\u003eIt involves specifying the line item IDs, the targeting options to delete, and the targeting options to create in the request body.\u003c/p\u003e\n"],["\u003cp\u003eConcurrent requests updating the same line items using other methods are restricted.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides details about successfully updated line items, failed line items, and any associated errors.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This operation performs bulk edits to targeting options for multiple line items. It deletes assigned targeting options specified in `deleteRequests` and creates new ones from `createRequests`. The request includes `lineItemIds` to identify which items to edit. The request is a POST request to a URL with a specific path parameter: `advertiserId`. Concurrent requests to update the same line item are restricted. Successful edits are returned in `updatedLineItemIds`, failures in `failedLineItemIds`, and errors in `errors`.\n"],null,[]]
