Saltar al contenido principal
POST
/
media-bridge
/
v1
/
events
/
media-played-percent
Crear un evento de cuarta parte
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>"
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Gratuito
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Gratuito

Autorizaciones

Authorization
string
header
requerido

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

Cuerpo

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

Respuesta

successful operation

contactId
integer<int64>
requerido

ID del contacto del sistema de HubSpot que consumió el medio. Puede obtenerse mediante la API Get contact by usertoken (utk) de HubSpot . La API también admite el suministro de un usertoken y se encargará de convertirlo automáticamente en un ID de contacto.

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

El ID de la cuenta HubSpot.

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

El ID de contenido de la página en la que un evento ocurrió, para las páginas de HubSpot. Se requiere si la página es de HubSpot.

pageName
string

El nombre o título de la página en la que un evento ocurrió. Se requiere para páginas que no son de HubSpot.

pageObjectCoordinates
string
pageUrl
string

La URL de la página en la que un evento ocurrió. Se requiere para páginas que no son de HubSpot.

Last modified on December 8, 2025