REST Resource: sellers.adPlays

资源:AdPlay

播放一次广告。

JSON 表示法
{
  "name": string,
  "startTime": string,
  "endTime": string,
  "impressionCount": number,

  // Union field line_reference can be only one of the following:
  "line": string,
  "lineExternalId": string
  // End of list of possible types for union field line_reference.

  // Union field ad_unit_reference can be only one of the following:
  "adUnit": string,
  "adUnitExternalId": string
  // End of list of possible types for union field ad_unit_reference.

  // Union field creative_asset_reference can be only one of the following:
  "creativeAsset": string,
  "creativeAssetExternalId": string
  // End of list of possible types for union field creative_asset_reference.
}
字段
name

string

仅限输出。广告播放的资源名称,格式为:sellers/{seller}/adPlays/{adPlay}

startTime

string (Timestamp format)

广告开始播放的时间。

时间戳采用 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"

impressionCount

number

总展示次数。展示次数可以进行估算,并且支持使用小数值。

联合字段 line_reference

line_reference 只能是下列其中一项:

line

string

此广告播放所属的行。系统将从行中推断顺序。格式:sellers/111/orders/123/lines/321

lineExternalId

string

仅限输入。此广告播放所属行的外部 ID。系统将从行中推断顺序。格式:123

联合字段 ad_unit_reference

ad_unit_reference 只能是下列其中一项:

adUnit

string

播放此广告的广告单元。格式:sellers/111/adUnits/123

adUnitExternalId

string

仅限输入。投放该广告播放的广告单元的外部 ID。格式:789

联合字段 creative_asset_reference

creative_asset_reference 只能是下列其中一项:

creativeAsset

string

本次广告播放所投放的广告素材资源。格式:sellers/111/creativeAssets/123

creativeAssetExternalId

string

仅限输入。此广告播放所投放广告素材资源的外部 ID。格式:3210

方法

batchCreate

批量创建新的广告播放。

create

创建广告播放。