REST Resource: adPlays

資源:AdPlay

播放一次廣告。

JSON 表示法
{
  "name": string,
  "line": string,
  "adUnit": string,
  "creative": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
欄位
name

string

僅供輸出。播放廣告的資源名稱,格式為:adPlays/{id}

line

string

必要欄位。此廣告播放的行。系統會從行推斷順序。格式:orders/123/line/321

adUnit

string

必要欄位。用來放送這則廣告的廣告單元。格式:adUnits/123

creative

string

必要欄位。這個廣告播放的廣告素材。格式:creativeAssets/123

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

必要欄位。曝光總數。

方法

create

建立廣告播放。

createWithExternalIds

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