Skip to main content
POST
Registrar el porcentaje reproducido del contenido multimedia

Supported products

Autorizaciones

Authorization
string
header
requerido

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

FlowAuthorization Code
Authorization URL
https://app.hubspot.com/oauth/authorize
Token URL
https://api.hubapi.com/oauth/v1/token
Scopes1
media_bridge.write

Cuerpo

application/json
mediaType
enum<string>
requerido

El tipo de contenido multimedia que se reprodujo. Los valores válidos son "VIDEO", "AUDIO", "DOCUMENT", "OTHER" e "IMAGE".

Opciones disponibles:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer<int64>
requerido

La marca de tiempo en que ocurrió el evento de reproducción de contenido multimedia.

playedPercent
integer<int32>
requerido

El porcentaje del contenido multimedia que se ha reproducido.

sessionId
string
requerido

El identificador único de la sesión en la que se reprodujo el contenido multimedia.

_hsenc
string

Parámetro de codificación de HubSpot para fines de seguimiento.

contactId
integer<int64>

El identificador único del contacto asociado al evento de reproducción de contenido multimedia.

contactUtk
string

La clave del token de usuario asociada al contacto.

externalId
string

Un identificador externo para el contenido multimedia, proporcionado por el usuario.

externalPlayContext
enum<string>

Contexto adicional proporcionado externamente sobre el evento de reproducción de contenido multimedia.

Opciones disponibles:
EMAIL,
EXTERNAL_PAGE
mediaBridgeId
integer<int64>

El identificador único de la instancia del centro multimedia.

mediaName
string

El nombre del contenido multimedia que se reprodujo.

mediaUrl
string

La URL donde se aloja el contenido multimedia.

pageId
integer<int64>

El identificador único de la página donde se reprodujo el contenido multimedia.

pageName
string

El nombre de la página donde se reprodujo el contenido multimedia.

pageUrl
string

La URL de la página donde se reprodujo el contenido multimedia.

Respuesta

successful operation

contactId
integer<int64>
requerido

El identificador único del contacto asociado al evento multimedia. Es un valor de cadena.

mediaBridgeId
integer<int64>
requerido

El identificador único para la instancia del centro multimedia. Es un valor de cadena.

mediaBridgeObjectCoordinates
string
requerido

Coordenadas que especifican la ubicación del objeto del centro multimedia. Es un valor de cadena.

mediaBridgeObjectTypeId
string
requerido

El identificador de tipo para el objeto del centro multimedia. Es un valor de cadena.

mediaName
string
requerido

El nombre del contenido multimedia que se está reproduciendo. Es un valor de cadena.

mediaType
enum<string>
requerido

El tipo de contenido que se está reproduciendo, como "VIDEO", "AUDIO", etc. Es un valor de cadena.

Opciones disponibles:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer<int64>
requerido

La marca de tiempo de cuando ocurrió el evento de reproducción de contenido multimedia. Es un valor de cadena en formato ISO 8601.

playedPercent
integer<int32>
requerido

El porcentaje del contenido multimedia que se ha reproducido. Es un valor numérico.

portalId
integer<int32>
requerido

El identificador único del portal de HubSpot. El valor es un número entero.

providerId
integer<int32>
requerido

El identificador único del proveedor de medios. Es un valor de cadena.

sessionId
string
requerido

El identificador único de la sesión durante la cual se reprodujo el contenido multimedia. Es un valor de cadena.

externalPlayContext
enum<string>

Información contextual sobre el entorno externo donde se reproduce el contenido multimedia. Es un valor de cadena.

Opciones disponibles:
EMAIL,
EXTERNAL_PAGE
mediaUrl
string

La URL del contenido multimedia que se está reproduciendo. Es un valor de cadena.

pageId
integer<int64>

El identificador único de la página donde se reproduce el contenido multimedia. Es un valor de cadena.

pageName
string

El nombre de la página donde se reproduce el contenido multimedia. Es un valor de cadena.

pageObjectCoordinates
string

Coordenadas que especifican la ubicación del objeto de la página. Es un valor de cadena.

pageUrl
string

La URL de la página donde se reproduce el contenido multimedia. Es un valor de cadena.

Última modificación el 6 de octubre de 2026