Method: sellers.adPlays.batchCreate

新しい広告の再生を一括して作成します。

  • 1 つのバッチでの広告再生の最大数は 1,000 です。
  • 成功した場合は、新しく作成された広告再生を返します。
  • 無効な広告ユニット、オーダー、広告申込情報、またはクリエイティブが指定されている場合は、エラーコード INVALID_ARGUMENT を返します。
  • 同じ広告ユニット、オーダー、行、クリエイティブに対して、同じ startTime の広告がすでに再生されている場合、エラーコード ALREADY_EXISTS を返します。
  • 一致する広告ユニット、オーダー、広告申込情報、またはクリエイティブ アセットが見つからない場合は、エラーコード NOT_FOUND が返されます。
  • リクエストにリソース名と外部 ID の両方が含まれている場合、エラーコード FAILED_PRECONDITION を返します。

HTTP リクエスト

POST https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adPlays:batchCreate

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

パスパラメータ

パラメータ
parent

string

必須。販売者のリソース名。形式: sellers/{seller}

リクエスト本文

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

JSON 表現 
{
  "requests": [
    {
      object (CreateAdPlayRequest)
    }
  ]
}
フィールド
requests[]

object (CreateAdPlayRequest)

必須。広告が再生されます。

1 つのバッチでの広告再生の最大数は 1,000 です。開始時間は過去の日時で、作成日の 3 日前までにする必要があります。終了時間には、開始時間より後の時間を指定してください。

レスポンスの本文

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

広告再生の一括作成に対するレスポンス。

JSON 表現 
{
  "adPlays": [
    {
      object (AdPlay)
    }
  ]
}
フィールド
adPlays[]

object (AdPlay)

作成された広告が再生されます。

認可スコープ

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

  • https://www.googleapis.com/auth/doubleclickbidmanager

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

CreateAdPlayRequest

AdPlayService.CreateAdPlay に対するリクエスト メッセージです。

JSON 表現 
{
  "parent": string,
  "adPlay": {
    object (AdPlay)
  }
}
フィールド
parent

string

必須。販売者のリソース名。形式: sellers/{seller}
adPlay

object (AdPlay)

必須。作成する広告再生。

広告プレイ名はシステムによって生成されるため、設定しないでください。開始時間は過去の日時で、作成日の 3 日前までにする必要があります。終了時間には、開始時間より後の時間を指定してください。