Method: sellers.adPlays.batchCreate

可批次建立新的廣告播放。

  • 批次中廣告播放數量上限為 1,000 個。
  • 如果成功，傳回新建的廣告播放。
  • 如果指定無效的廣告單元、訂單、行或廣告素材，則傳回錯誤代碼 INVALID_ARGUMENT。
  • 如果同一個廣告單元、訂單、行和廣告素材具有相同的 startTime，則傳回錯誤代碼 ALREADY_EXISTS。
  • 如果沒有相符的廣告單元、訂單、行或廣告素材資源，則傳回錯誤代碼 NOT_FOUND。
  • 如果要求包含資源名稱和外部 ID，則會傳回錯誤代碼 FAILED_PRECONDITION。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

必要欄位。賣家資源名稱。格式：Seller/{seller}

要求主體

要求主體的資料會採用以下結構：

JSON 表示法 
{
  "requests": [
    {
      object (CreateAdPlayRequest)
    }
  ]
}
欄位
requests[]

object (CreateAdPlayRequest)

必要欄位。系統會播放廣告來創作。

批次中廣告播放數量上限為 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

必要欄位。賣家資源名稱。格式：Seller/{seller}
adPlay

object (AdPlay)

必要欄位。要創作的廣告播放。

廣告播放名稱將由系統產生，不應設定。開始時間必須是過去時間，而且最多只能是建立日期前 3 天。結束時間必須是過去和之後的時間。