REST Resource: sellers.adPlays

リソース: AdPlay

1 回の広告再生。

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「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

endTime

string (Timestamp format)

広告の再生が終了した時刻。

RFC3339 UTC「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

広告再生を作成します。