Passer au contenu principal
POST
/
media-bridge
/
v1
/
events
/
media-played-percent
Créer un événement de quartile
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 '
{
  "mediaType": "AUDIO",
  "occurredTimestamp": 123,
  "playedPercent": 123,
  "sessionId": "<string>",
  "_hsenc": "<string>",
  "contactId": 123,
  "contactUtk": "<string>",
  "externalId": "<string>",
  "mediaBridgeId": 123,
  "mediaName": "<string>",
  "mediaUrl": "<string>",
  "pageId": 123,
  "pageName": "<string>",
  "pageUrl": "<string>"
}
'
{
  "contactId": 123,
  "mediaBridgeId": 123,
  "mediaBridgeObjectCoordinates": "<string>",
  "mediaBridgeObjectTypeId": "<string>",
  "mediaName": "<string>",
  "mediaType": "AUDIO",
  "occurredTimestamp": 123,
  "playedPercent": 123,
  "portalId": 123,
  "providerId": 123,
  "sessionId": "<string>",
  "mediaUrl": "<string>",
  "pageId": 123,
  "pageName": "<string>",
  "pageObjectCoordinates": "<string>",
  "pageUrl": "<string>"
}

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Gratuit
Sales HubSales Hub -Gratuit
Service HubService Hub -Gratuit
Content HubContent Hub -Gratuit

Autorisations

Authorization
string
header
requis

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

Corps

application/json
mediaType
enum<string>
requis
Options disponibles:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer<int64>
requis
playedPercent
integer<int32>
requis
sessionId
string
requis
_hsenc
string
contactId
integer<int64>
contactUtk
string
externalId
string
mediaBridgeId
integer<int64>
mediaName
string
mediaUrl
string
pageId
integer<int64>
pageName
string
pageUrl
string

Réponse

successful operation

contactId
integer<int64>
requis

L’identifiant du contact dans le système HubSpot qui a consulté le média. Il peut être récupéré via l’API Obtenir le contact par l'usertoken (utk) de HubSpot. Cette API permet également de fournir un usertoken, qu’elle convertira automatiquement en ID de contact.

mediaBridgeId
integer<int64>
requis
mediaBridgeObjectCoordinates
string
requis
mediaBridgeObjectTypeId
string
requis
mediaName
string
requis
mediaType
enum<string>
requis
Options disponibles:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer<int64>
requis
playedPercent
integer<int32>
requis
portalId
integer<int32>
requis

L'ID du compte HubSpot.

providerId
integer<int32>
requis
sessionId
string
requis
mediaUrl
string
pageId
integer<int64>

L'ID de contenu de la page sur laquelle l’événement a eu lieu, pour les pages HubSpot. Obligatoire si la page est une page HubSpot.

pageName
string

Le nom ou le titre de la page sur laquelle l’événement a eu lieu. Obligatoire pour les pages qui ne sont pas hébergées sur HubSpot.

pageObjectCoordinates
string
pageUrl
string

L’URL de la page sur laquelle l’événement a eu lieu. Obligatoire pour les pages non hébergées sur HubSpot.

Last modified on December 8, 2025