Zum Hauptinhalt springen
POST
/
media-bridge
/
v1
/
events
/
media-played-percent
四分位数イベントを作成
curl --request POST \
  --url https://api.hubapi.com/media-bridge/v1/events/media-played-percent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "mediaUrl": "<string>",
  "contactId": 123,
  "externalId": "<string>",
  "mediaType": "VIDEO",
  "sessionId": "<string>",
  "playedPercent": 123,
  "pageId": 123,
  "pageName": "<string>",
  "occurredTimestamp": 123,
  "contactUtk": "<string>",
  "pageUrl": "<string>",
  "_hsenc": "<string>",
  "mediaBridgeId": 123,
  "mediaName": "<string>"
}'
{
  "mediaUrl": "<string>",
  "contactId": 123,
  "mediaType": "VIDEO",
  "sessionId": "<string>",
  "playedPercent": 123,
  "pageId": 123,
  "mediaBridgeObjectTypeId": "<string>",
  "pageName": "<string>",
  "pageObjectCoordinates": "<string>",
  "occurredTimestamp": 123,
  "providerId": 123,
  "portalId": 123,
  "pageUrl": "<string>",
  "mediaBridgeId": 123,
  "mediaBridgeObjectCoordinates": "<string>",
  "mediaName": "<string>"
}
次のいずれかの製品またはそれ以上が必要です。
Marketing HubMarketing Hub -無料ツール
Sales HubSales Hub -無料ツール
Service HubService Hub -無料ツール
Content HubContent Hub -無料ツール
この API には、次のいずれかのスコープが必要です。
media_bridge.write

Authorizations

Authorization
string
header
required

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

Body

application/json
mediaType
enum<string>
required
Available options:
VIDEO,
AUDIO,
DOCUMENT,
OTHER,
IMAGE
sessionId
string
required
playedPercent
integer
required
occurredTimestamp
integer
required
mediaUrl
string
contactId
integer
externalId
string
pageId
integer
pageName
string
contactUtk
string
pageUrl
string
_hsenc
string
mediaBridgeId
integer
mediaName
string

Response

successful operation

contactId
integer
required

メディアを消費した、HubSpotのシステム内のコンタクトのID。これは、HubSpotのユーザートークン(utk)でコンタクトを取得するAPIを使用して取得できます。APIはユーザートークンの提供もサポートしており、コンタクトIDへの自動変換を処理します。

mediaType
enum<string>
required
Available options:
VIDEO,
AUDIO,
DOCUMENT,
OTHER,
IMAGE
sessionId
string
required
playedPercent
integer
required
mediaBridgeObjectTypeId
string
required
occurredTimestamp
integer
required
providerId
integer
required
portalId
integer
required

HubSpotアカウントのID。

mediaBridgeId
integer
required
mediaBridgeObjectCoordinates
string
required
mediaName
string
required
mediaUrl
string
pageId
integer

HubSpotページで、イベントが発生したページのコンテンツID。ページがHubSpotページの場合は必須です。

pageName
string

イベントが発生したページの名前またはタイトル。HubSpot以外のページに必須です。

pageObjectCoordinates
string
pageUrl
string

イベントが発生したページのURL。HubSpot以外のページに必須です。

I