Zum Hauptinhalt springen
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 '{
  "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>"
}
Produits pris en charge
Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing HubGratuit
Sales HubSales HubGratuit
Service HubService HubGratuit
Content HubContent HubGratuit

​
Portées requises

Cette API requiert l’une des portées suivantes :
  • 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

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.

​
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

L'ID du compte HubSpot.

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

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.

⌘I