Skip to main content
POST
メディア再生率を記録

Supported products

承認

Authorization
string
header
必須

The access token received from the authorization server in the OAuth 2.0 flow.

ボディ

application/json
mediaType
enum<string>
必須

再生されたメディアの種類。「VIDEO」、「AUDIO」、「DOCUMENT」、「OTHER」、「IMAGE」などが有効な値です。

利用可能なオプション:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer<int64>
必須

メディア再生イベントが発生したときのタイムスタンプ。

playedPercent
integer<int32>
必須

メディアが再生された割合。

sessionId
string
必須

メディアが再生されたセッションの一意の識別子。

_hsenc
string

トラッキング目的のHubSpotエンコーディングパラメーター。

contactId
integer<int64>

メディア再生イベントに関連付けられているコンタクトの一意の識別子。

contactUtk
string

コンタクトに関連付けられているユーザー トークン キー。

externalId
string

ユーザーが提供する、メディアの外部識別子。

externalPlayContext
enum<string>

メディア再生イベントに関して外部から提供された追加のコンテキスト。

利用可能なオプション:
EMAIL,
EXTERNAL_PAGE
mediaBridgeId
integer<int64>

メディア ブリッジ インスタンスの一意の識別子。

mediaName
string

再生されたメディアの名前。

mediaUrl
string

メディアがホストされているURL。

pageId
integer<int64>

メディアが再生されたページの固有の識別子。

pageName
string

メディアが再生されたページの名称。

pageUrl
string

メディアが再生されたページのURL。

レスポンス

successful operation

contactId
integer<int64>
必須

メディアイベントに関連付けられたコンタクトの一意の識別子です。文字列値です。

mediaBridgeId
integer<int64>
必須

メディアブリッジインスタンスの一意の識別子です。文字列値です。

mediaBridgeObjectCoordinates
string
必須

メディアブリッジオブジェクトの位置を指定する座標です。文字列値です。

mediaBridgeObjectTypeId
string
必須

メディアブリッジオブジェクトのタイプ識別子です。文字列値です。

mediaName
string
必須

再生中のメディアコンテンツの名前です。文字列値です。

mediaType
enum<string>
必須

再生されているメディアの種類(「VIDEO」、「AUDIO」など)です。文字列値です。

利用可能なオプション:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer<int64>
必須

メディア再生イベントが発生したときのタイムスタンプです。ISO 8601形式の文字列値です。

playedPercent
integer<int32>
必須

再生されたメディアコンテンツの割合です。数値で表されます。

portalId
integer<int32>
必須

HubSpotポータルの固有の識別子です。整数値です。

providerId
integer<int32>
必須

メディアプロバイダーの一意の識別子です。文字列値です。

sessionId
string
必須

メディアが再生されたセッションの一意の識別子です。文字列値です。

externalPlayContext
enum<string>

メディアが再生される外部環境に関するコンテキスト情報です。文字列値です。

利用可能なオプション:
EMAIL,
EXTERNAL_PAGE
mediaUrl
string

再生中のメディアコンテンツのURLです。文字列値です。

pageId
integer<int64>

メディアが再生されているページの一意の識別子です。文字列値です。

pageName
string

メディアが再生されているページの名称です。文字列値です。

pageObjectCoordinates
string

ページオブジェクトの位置を指定する座標です。文字列値です。

pageUrl
string

メディアが再生されているページのURLです。文字列値です。

最終更新日 2026年10月6日