Method: advertisers.adGroups.bulkEditAssignedTargetingOptions

複数の広告グループのターゲティング オプションを一括編集します。

同じ削除リクエストと作成リクエストのセットが、指定されたすべての広告グループに適用されます。具体的には、このオペレーションでは、BulkEditAdGroupAssignedTargetingOptionsRequest.delete_requests で指定された割り当て済みのターゲティング オプションが各広告グループから削除され、BulkEditAdGroupAssignedTargetingOptionsRequest.create_requests で指定された割り当て済みのターゲティング オプションが作成されます。

このメソッドは、デマンド ジェネレーション広告グループでのみサポートされています。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
advertiserId

string (int64 format)

必須。広告グループが属する広告主の ID。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "adGroupIds": [
    string
  ],
  "deleteRequests": [
    {
      object (DeleteAssignedTargetingOptionsRequest)
    }
  ],
  "createRequests": [
    {
      object (CreateAssignedTargetingOptionsRequest)
    }
  ]
}
フィールド
adGroupIds[]

string (int64 format)

必須。割り当てられたターゲティング オプションが属する広告グループの ID。指定できる広告グループ ID は最大 25 個です。
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 をご覧ください。