Method: advertisers.lineItems.bulkEditAssignedTargetingOptions

• HTTP リクエスト
• パスパラメータ
• リクエストの本文
  • JSON 表現
• レスポンスの本文
  • JSON 表現
• 認可スコープ
• 試してみる

複数の広告申込情報のターゲティング オプションを一括編集します。このオペレーションでは、BulkEditAssignedTargetingOptionsRequest.delete_requests で指定された割り当て済みターゲティング オプションが削除され、BulkEditAssignedTargetingOptionsRequest.create_requests で指定された割り当て済みターゲティング オプションが作成されます。

このエンドポイントへのリクエストは、同じ広告申込情報を更新する次のリクエストと同時に実行できません。

• lineItems.bulkUpdate
• lineItems.patch
• assignedTargetingOptions.create
• assignedTargetingOptions.delete

YouTube とパートナーの広告申込情報は、API を使用して作成または更新できません。

HTTP リクエスト

POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkEditAssignedTargetingOptions

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

パスパラメータ

パラメータ
advertiserId	string (int64 format) 必須。広告申込情報が属する広告主の ID。

リクエスト本文

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

JSON 表現
{ "lineItemIds": [ string ], "deleteRequests": [ { object (DeleteAssignedTargetingOptionsRequest) } ], "createRequests": [ { object (CreateAssignedTargetingOptionsRequest) } ] }

フィールド
lineItemIds[]	string (int64 format) 必須。ターゲティングが更新される広告申込情報の ID。
deleteRequests[]	object (DeleteAssignedTargetingOptionsRequest) バッチで削除する割り当て済みのターゲティング オプション。DeleteAssignedTargetingOptionsRequest のリストとして指定します。 サポートされているターゲティング タイプは次のとおりです。 TARGETING_TYPE_AGE_RANGE TARGETING_TYPE_APP TARGETING_TYPE_APP_CATEGORY TARGETING_TYPE_AUDIENCE_GROUP TARGETING_TYPE_AUDIO_CONTENT_TYPE TARGETING_TYPE_AUTHORIZED_SELLER_STATUS TARGETING_TYPE_BROWSER TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_CARRIER_AND_ISP TARGETING_TYPE_CATEGORY TARGETING_TYPE_CHANNEL TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_INSTREAM_POSITION TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION TARGETING_TYPE_CONTENT_STREAM_TYPE TARGETING_TYPE_DAY_AND_TIME TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION TARGETING_TYPE_ENVIRONMENT TARGETING_TYPE_EXCHANGE TARGETING_TYPE_GENDER TARGETING_TYPE_GEO_REGION TARGETING_TYPE_HOUSEHOLD_INCOME TARGETING_TYPE_INVENTORY_SOURCE TARGETING_TYPE_INVENTORY_SOURCE_GROUP TARGETING_TYPE_KEYWORD TARGETING_TYPE_LANGUAGE TARGETING_TYPE_NATIVE_CONTENT_POSITION TARGETING_TYPE_NEGATIVE_KEYWORD_LIST TARGETING_TYPE_OMID TARGETING_TYPE_ON_SCREEN_POSITION TARGETING_TYPE_OPERATING_SYSTEM TARGETING_TYPE_PARENTAL_STATUS TARGETING_TYPE_POI TARGETING_TYPE_PROXIMITY_LOCATION_LIST TARGETING_TYPE_REGIONAL_LOCATION_LIST TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION TARGETING_TYPE_SUB_EXCHANGE TARGETING_TYPE_THIRD_PARTY_VERIFIER TARGETING_TYPE_URL TARGETING_TYPE_USER_REWARDED_CONTENT TARGETING_TYPE_VIDEO_PLAYER_SIZE TARGETING_TYPE_VIEWABILITY
createRequests[]	object (CreateAssignedTargetingOptionsRequest) バッチで作成する割り当て済みのターゲティング オプション。CreateAssignedTargetingOptionsRequest のリストとして指定します。 サポートされているターゲティング タイプは次のとおりです。 TARGETING_TYPE_AGE_RANGE TARGETING_TYPE_APP TARGETING_TYPE_APP_CATEGORY TARGETING_TYPE_AUDIENCE_GROUP TARGETING_TYPE_AUDIO_CONTENT_TYPE TARGETING_TYPE_AUTHORIZED_SELLER_STATUS TARGETING_TYPE_BROWSER TARGETING_TYPE_BUSINESS_CHAIN TARGETING_TYPE_CARRIER_AND_ISP TARGETING_TYPE_CATEGORY TARGETING_TYPE_CHANNEL TARGETING_TYPE_CONTENT_DURATION TARGETING_TYPE_CONTENT_GENRE TARGETING_TYPE_CONTENT_INSTREAM_POSITION TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION TARGETING_TYPE_CONTENT_STREAM_TYPE TARGETING_TYPE_DAY_AND_TIME TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION TARGETING_TYPE_ENVIRONMENT TARGETING_TYPE_EXCHANGE TARGETING_TYPE_GENDER TARGETING_TYPE_GEO_REGION TARGETING_TYPE_HOUSEHOLD_INCOME TARGETING_TYPE_INVENTORY_SOURCE TARGETING_TYPE_INVENTORY_SOURCE_GROUP TARGETING_TYPE_KEYWORD TARGETING_TYPE_LANGUAGE TARGETING_TYPE_NATIVE_CONTENT_POSITION TARGETING_TYPE_NEGATIVE_KEYWORD_LIST TARGETING_TYPE_OMID TARGETING_TYPE_ON_SCREEN_POSITION TARGETING_TYPE_OPERATING_SYSTEM TARGETING_TYPE_PARENTAL_STATUS TARGETING_TYPE_POI TARGETING_TYPE_PROXIMITY_LOCATION_LIST TARGETING_TYPE_REGIONAL_LOCATION_LIST TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION TARGETING_TYPE_SUB_EXCHANGE TARGETING_TYPE_THIRD_PARTY_VERIFIER TARGETING_TYPE_URL TARGETING_TYPE_USER_REWARDED_CONTENT TARGETING_TYPE_VIDEO_PLAYER_SIZE TARGETING_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 の概要をご覧ください。