Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

大量編輯多個廣告群組的指定目標選項。

系統會對所有指定的廣告群組套用同一組刪除和建立要求。具體來說，這項作業會刪除每個廣告群組中 BulkEditAdGroupAssignedTargetingOptionsRequest.delete_requests 提供的指定目標選項，然後建立 BulkEditAdGroupAssignedTargetingOptionsRequest.create_requests 提供的指定目標選項。

這個方法僅適用於需求開發廣告群組。

HTTP 要求

POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/adGroups:bulkEditAssignedTargetingOptions

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
advertiserId

string (int64 format)

必填。廣告群組所屬廣告主的 ID。

要求主體

要求主體會包含結構如下的資料：

JSON 表示法 
{
  "adGroupIds": [
    string
  ],
  "deleteRequests": [
    {
      object (DeleteAssignedTargetingOptionsRequest)
    }
  ],
  "createRequests": [
    {
      object (CreateAssignedTargetingOptionsRequest)
    }
  ]
}
欄位
adGroupIds[]

string (int64 format)

必填。指定目標選項所屬的廣告群組 ID。最多可指定 25 個廣告群組 ID。
deleteRequests[]

object (DeleteAssignedTargetingOptionsRequest)

(選用步驟) 要以批次方式刪除的指定目標選項，指定為 DeleteAssignedTargetingOptionsRequest 清單。

支援的指定類型：

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO
createRequests[]

object (CreateAssignedTargetingOptionsRequest)

(選用步驟) 用於批次建立的已指派指定目標選項，指定為 CreateAssignedTargetingOptionRequest 清單。

支援的指定類型：

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_APP
  • TARGETING_TYPE_APP_CATEGORY
  • TARGETING_TYPE_AUDIENCE_GROUP
  • TARGETING_TYPE_CATEGORY
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_GEO_REGION
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_KEYWORD
  • TARGETING_TYPE_LANGUAGE
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_URL
  • TARGETING_TYPE_YOUTUBE_CHANNEL
  • TARGETING_TYPE_YOUTUBE_VIDEO

回應主體

adGroups.bulkEditAssignedTargetingOptions 的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "updatedAdGroupIds": [
    string
  ],
  "failedAdGroupIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
欄位
updatedAdGroupIds[]

string (int64 format)

僅供輸出。已成功更新的廣告群組 ID。
failedAdGroupIds[]

string (int64 format)

僅供輸出。無法更新的廣告群組 ID。
errors[]

object (Status)

僅供輸出。無法更新的每個廣告群組的錯誤資訊。

授權範圍

需要下列 OAuth 範圍：

  • https://www.googleapis.com/auth/display-video

詳情請參閱OAuth 2.0 Overview。