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>
必須

メディア再生イベントが発生した日時(Unix時間形式)。

sessionId
string
必須

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

state
enum<string>
必須

メディア再生施策の現在のステータスを示すイベント。

利用可能なオプション:
STARTED,
VIEWED
_hsenc
string

HubSpotが内部で使用するエンコーディングパラメーター。

contactId
integer<int64>

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

contactUtk
string

コンタクトの追跡に使用される、一意の追跡キー。

externalId
string

メディアの外部識別子で、外部システムとの関連付けに使用します。

externalPlayContext
enum<string>

外部システムから提供される、メディア再生イベントに関する追加のコンテキスト。

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

該当する場合、メディアを含むiframeのURL。

mediaBridgeId
integer<int64>

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

mediaName
string

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

mediaUrl
string

再生されたメディアのURL。

pageId
integer<int64>

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

pageName
string

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

pageUrl
string

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

レスポンス

successful operation

contactId
integer<int64>
必須

このメディアイベントに関連付けられているコンタクトの固有ID。

mediaBridgeId
integer<int64>
必須

このイベントに関連付けられているメディアブリッジインスタンスの一意の識別子。

mediaBridgeObjectCoordinates
string
必須

メディアブリッジオブジェクトの位置またはコンテキストを指定する座標。

mediaBridgeObjectTypeId
string
必須

イベントに含まれるメディアブリッジオブジェクトのタイプID。

mediaName
string
必須

再生されたメディアコンテンツの名前。

mediaType
enum<string>
必須

再生されたメディアの種類(動画や音声など)。

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

メディア再生イベントが発生した日時を示すUnixタイムスタンプ(ミリ秒)。

portalId
integer<int32>
必須

イベントが発生したHubSpotポータルの固有ID。

providerId
integer<int32>
必須

メディアプロバイダーの一意の識別子。

sessionId
string
必須

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

state
enum<string>
必須

メディア再生イベントのステータス(「started」や「completed」など)。

利用可能なオプション:
STARTED,
VIEWED
externalPlayContext
enum<string>

再生イベントについて外部システムから提供される追加の背景情報。

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

メディアが埋め込まれて再生されたiframeのURL。

mediaUrl
string

メディアコンテンツが提供されているURL。

pageId
integer<int64>

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

pageName
string

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

pageObjectCoordinates
string

ページオブジェクトの位置またはコンテキストを指定する座標。

pageUrl
string

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

最終更新日 2026年10月6日