Method: advertisers.lineItems.bulkUpdate

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

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

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

HTTP リクエスト

POST https://displayvideo.googleapis.com/v4/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"。

レスポンスの本文

LineItemService.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 Overview をご覧ください。