Skip to main content
POST
Prozentsatz der wiedergegebenen Medien aufzeichnen

Supported products

Autorisierungen

Authorization
string
header
erforderlich

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

Body

application/json
mediaType
enum<string>
erforderlich

Der Typ des wiedergegebenen Mediums. Gültige Werte sind „VIDEO“, „AUDIO“, „DOCUMENT“, „OTHER“ und „IMAGE“.

Verfügbare Optionen:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer<int64>
erforderlich

Der Zeitstempel, wann das Medienwiedergabe-Event aufgetreten ist.

playedPercent
integer<int32>
erforderlich

Der Prozentsatz der Medien, die wiedergegeben wurden.

sessionId
string
erforderlich

Die eindeutige ID für die Sitzung, in der die Medien wiedergegeben wurden.

_hsenc
string

HubSpot-Codierungsparameter für Trackingzwecke.

contactId
integer<int64>

Die eindeutige ID für den Kontakt, der mit dem Medienwiedergabe-Event verknüpft ist.

contactUtk
string

Der dem Kontakt zugeordnete Benutzer-Token-Schlüssel.

externalId
string

Eine externe ID für die Medien, die vom Benutzer bereitgestellt wird.

externalPlayContext
enum<string>

Zusätzlicher extern bereitgestellter Kontext zum Medienwiedergabe-Event.

Verfügbare Optionen:
EMAIL,
EXTERNAL_PAGE
mediaBridgeId
integer<int64>

Die eindeutige ID für die Media Bridge-Instanz.

mediaName
string

Der Name des abgespielten Mediums.

mediaUrl
string

Die URL, unter der die Medien gehostet werden.

pageId
integer<int64>

Die eindeutige ID der Seite, auf der die Medien wiedergegeben wurden.

pageName
string

Der Name der Seite, auf der die Medien abgespielt wurden.

pageUrl
string

Die URL der Seite, auf der die Medien abgespielt wurden.

Antwort

successful operation

contactId
integer<int64>
erforderlich

Die eindeutige ID für den Kontakt, der dem Medien-Event zugeordnet ist. Es ist ein Zeichenfolgenwert.

mediaBridgeId
integer<int64>
erforderlich

Die eindeutige ID für die Media Bridge-Instanz. Es ist ein Zeichenfolgenwert.

mediaBridgeObjectCoordinates
string
erforderlich

Koordinaten, die den Standort des Media Bridge-Objekts angeben. Es handelt sich um einen Zeichenfolgenwert.

mediaBridgeObjectTypeId
string
erforderlich

Die Typ-ID für das Media Bridge-Objekt. Es ist ein Zeichenfolgenwert.

mediaName
string
erforderlich

Der Name des wiedergegebenen Medieninhalts. Es ist ein Zeichenfolgenwert.

mediaType
enum<string>
erforderlich

Der Typ des wiedergegebenen Mediums, z. B. „VIDEO“, „AUDIO“ usw. Es ist ein Zeichenfolgenwert.

Verfügbare Optionen:
AUDIO,
DOCUMENT,
IMAGE,
OTHER,
VIDEO
occurredTimestamp
integer<int64>
erforderlich

Der Zeitstempel, wann das Medienwiedergabe-Event aufgetreten ist. Es ist ein Zeichenfolgenwert im ISO 8601-Format.

playedPercent
integer<int32>
erforderlich

Der Prozentsatz des Medieninhalts, der wiedergegeben wurde. Es ist ein numerischer Wert.

portalId
integer<int32>
erforderlich

Die eindeutige ID für das HubSpot-Portal. Es ist ein Ganzzahlwert.

providerId
integer<int32>
erforderlich

Die eindeutige ID für den Medienanbieter. Es ist ein Zeichenfolgenwert.

sessionId
string
erforderlich

Die eindeutige ID für die Sitzung, während der die Medien wiedergegeben wurden. Es ist ein Zeichenfolgenwert.

externalPlayContext
enum<string>

Kontextbezogene Informationen über die externe Umgebung, in der die Medien wiedergegeben werden. Es handelt sich um einen Zeichenfolgenwert.

Verfügbare Optionen:
EMAIL,
EXTERNAL_PAGE
mediaUrl
string

Die URL des wiedergegebenen Medieninhalts. Es ist ein Zeichenfolgenwert.

pageId
integer<int64>

Die eindeutige ID für die Seite, auf der die Medien wiedergegeben werden. Es ist ein Zeichenfolgenwert.

pageName
string

Der Name der Seite, auf der die Medien wiedergegeben werden. Es ist ein Zeichenfolgenwert.

pageObjectCoordinates
string

Koordinaten, die die Position des Seitenobjekts angeben. Es ist ein Zeichenfolgenwert.

pageUrl
string

Die URL der Seite, auf der die Medien wiedergegeben werden. Es ist ein Zeichenfolgenwert.

Zuletzt geändert am 24. September 2026