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 '{
  "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>"
}
Productos compatibles
Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing HubGratuito
Sales HubSales HubGratuito
Service HubService HubGratuito
Content HubContent HubGratuito

Ámbitos Requeridos

Esta API requiere uno de los siguientes ámbitos:
  • 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

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.

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

El ID de la cuenta HubSpot.

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

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.