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。