Method: adPlays.createWithExternalIds

使用外部 ID 建立廣告播放。

  • 如果成功，會傳回新建立的廣告播放。
  • 如果指定無效的廣告單元外部 ID、訂單外部 ID、行外部 ID 或廣告素材資源外部 ID，則傳回錯誤代碼 INVALID_ARGUMENT。
  • 如果同一個廣告單元、訂單、行和廣告素材具有相同的 startTime，則傳回錯誤代碼 INVALID_ARGUMENT。
  • 如果沒有相符的廣告單元外部 ID、訂單外部 ID、行外部 ID 或廣告素材資源外部 ID，則傳回錯誤代碼 NOT_FOUND。

HTTP 要求

POST https://dv360outofhomeseller.googleapis.com/v1beta1/adPlays:createWithExternalIds

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

要求主體

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

JSON 表示法 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
欄位
lineExternalId

string

必要欄位。此廣告播放的行外部 ID。格式：123。
orderExternalId

string

必要欄位。此廣告播放順序的外部 ID。格式：456。
adUnitExternalId

string

必要欄位。播放此廣告的廣告單元外部 ID。格式：789。
creativeAssetExternalId

string

必要欄位。這則廣告所放送廣告素材的外部 ID。格式：3210。
startTime

string (Timestamp format)

必要欄位。廣告開始播放的時間 (含)。必須是過去 3 天內的日期。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
endTime

string (Timestamp format)

必要欄位。廣告播放結束的時間 (不含)。不得早於開始時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
recordTime

string (Timestamp format)

選用設定。記錄這則廣告播放的時間。不得早於結束時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
impressions

number

必要欄位。曝光總數。

回應主體

如果成功，回應主體會包含 AdPlay 的執行例項。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。