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 世界標準時間「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"。
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

 建立廣告播放。