Method: advertisers.lineItems.bulkUpdate

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

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

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

HTTP リクエスト

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

レスポンスの本文

DatastoreService.BulkUpdatePlacements に対するレスポンス メッセージ。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

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 の概要をご覧ください。