Method: advertisers.lineItems.bulkUpdate

複数の広告申込情報を更新します。

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

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

HTTP リクエスト

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

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

パスパラメータ

パラメータ
advertiserId

string (int64 format)

必須。この広告申込情報が属する広告主の ID。

リクエスト本文

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

JSON 表現 
{
  "lineItemIds": [
    string
  ],
  "targetLineItem": {
    object (LineItem)
  },
  "updateMask": string
}
フィールド
lineItemIds[]

string (int64 format)

必須。更新する広告申込情報の ID。
targetLineItem

object (LineItem)

必須。更新するフィールドと、lineItemIds で指定されたすべての広告申込情報に割り当てる新しい値を含む広告申込情報オブジェクト。
updateMask

string (FieldMask format)

必須。更新するフィールドを識別するフィールド マスク。

現在サポートされているのは、次のフィールドのみです。

完全修飾フィールド名のカンマ区切りリスト。例: "user.displayName,photo"。

レスポンスの本文

doubleclick.BulkUpdateLineItems に対するレスポンス メッセージです。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "updatedLineItemIds": [
    string
  ],
  "failedLineItemIds": [
    string
  ],
  "skippedLineItemIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
フィールド
updatedLineItemIds[]

string (int64 format)

正常に更新された広告申込情報の ID。
failedLineItemIds[]

string (int64 format)

更新に失敗した広告申込情報の ID。
skippedLineItemIds[]

string (int64 format)

更新時にスキップされる広告申込情報の ID。たとえば、実質的に広告申込情報への変更が行われない不要な変更はスキップされ、対応する広告申込情報 ID をここでトラッキングできます。
errors[]

object (Status)

更新に失敗した広告申込情報から返されるエラー。

認可スコープ

次の OAuth スコープが必要です。

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

詳しくは、OAuth 2.0 の概要をご覧ください。