Skip to main content
POST
Enregistrer le pourcentage de lecture des médias

Supported products

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

Le type de média qui a été lu. Les valeurs valides incluent « VIDÉO », « AUDIO », « DOCUMENT », « AUTRE » et « IMAGE ».

Options disponibles:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer<int64>
requis

L'horodatage de l'événement de lecture du média.

playedPercent
integer<int32>
requis

Le pourcentage du média qui a été lu.

sessionId
string
requis

L'identifiant unique de la session au cours de laquelle le média a été lu.

_hsenc
string

Paramètre d'encodage HubSpot à des fins de suivi.

contactId
integer<int64>

L'identifiant unique du contact associé à l'événement de scénario.

contactUtk
string

La clé de jeton utilisateur associée au contact.

externalId
string

Un identifiant externe pour le média, fourni par l'utilisateur.

externalPlayContext
enum<string>

Contexte additionnel fourni en externe concernant l'événement de scénario média.

Options disponibles:
EMAIL,
EXTERNAL_PAGE
mediaBridgeId
integer<int64>

L'identifiant unique de l'instance du pont média.

mediaName
string

Le nom du média qui a été lu.

mediaUrl
string

L'URL où le média est hébergé.

pageId
integer<int64>

L'identifiant unique de la page où le média a été lu.

pageName
string

Le nom de la page où le média a été lu.

pageUrl
string

L'URL de la page où le média a été lu.

Réponse

successful operation

contactId
integer<int64>
requis

L'identifiant unique du contact associé à l'événement média. Il s'agit d'une valeur de type chaîne de caractères.

mediaBridgeId
integer<int64>
requis

L'identifiant unique de l'instance du pont média. Il s'agit d'une chaîne.

mediaBridgeObjectCoordinates
string
requis

Coordonnées qui indiquent l'emplacement de l'objet de pont média. Il s'agit d'une chaîne de caractères.

mediaBridgeObjectTypeId
string
requis

L'identifiant de type pour l'objet de pont média. C'est une chaîne de caractères.

mediaName
string
requis

Le nom du contenu multimédia en cours de lecture. Il s'agit d'une valeur de type chaîne de caractères.

mediaType
enum<string>
requis

Le type de média en cours de lecture, tel que « vidéo », « audio », etc. Il s'agit d'une valeur de type chaîne de caractères.

Options disponibles:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer<int64>
requis

L'horodatage de l'événement de lecture du média. C'est une chaîne de caractères au format ISO 8601.

playedPercent
integer<int32>
requis

Le pourcentage du contenu multimédia qui a été lu. Il s'agit d'une valeur numérique.

portalId
integer<int32>
requis

L'identifiant unique du portail HubSpot. Il s'agit d'une valeur entière.

providerId
integer<int32>
requis

L'identifiant unique du fournisseur de médias. Il s'agit d'une valeur de type chaîne de caractères.

sessionId
string
requis

L'identifiant unique de la session pendant laquelle le média a été lu. Il s'agit d'une valeur de type chaîne de caractères.

externalPlayContext
enum<string>

Informations contextuelles sur l'environnement externe où le média est lu. Il s'agit d'une chaîne de caractères.

Options disponibles:
EMAIL,
EXTERNAL_PAGE
mediaUrl
string

L'URL du contenu multimédia en cours de lecture. Il s'agit d'une valeur de type chaîne.

pageId
integer<int64>

L'identifiant unique de la page où le média est lu. Il s'agit d'une valeur de type chaîne de caractères.

pageName
string

Le nom de la page où le média est lu. Il s'agit d'une valeur de chaîne.

pageObjectCoordinates
string

Coordonnées qui spécifient l'emplacement de l'objet de la page. Il s'agit d'une valeur de type chaîne.

pageUrl
string

L'URL de la page où le média est lu. Il s'agit d'une valeur de type chaîne.

Dernière modification le 6 octobre 2026