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 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

endTime

string (Timestamp format)

必需。广告播放结束时间(不含)。应是过去的时间且晚于开始时间。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

recordTime

string (Timestamp format)

可选。录制此广告播放的时间。应为过去的时间和结束时间之后。

时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

impressions

number

必需。总展示次数。

方法

create

创建广告播放。

createWithExternalIds

创建使用外部 ID 的广告播放。