get_video_tracking

Read recorded playback/quartile tracking data for an asset.

get_video_tracking

Read recorded playback/quartile tracking data for an asset.

Read recorded tracking data for a confined asset (portal session only).

Safety class: B · API type: portal · Min version:

📘

Confinement

Class B: asset_id must be within your run-root anchor (read-only).

Signatures

def get_video_tracking(sdk, asset_id, tracking_event, seconds=None):
    """Read tracking data for asset_id / tracking_event; return the dict or None."""
    return sdk.get_video_tracking(asset_id, tracking_event, seconds)
export async function getVideoTracking(sdk, assetId, trackingEvent, seconds = null) {
    // Read recorded tracking data for a confined asset (portal session only).
    return await sdk.getVideoTracking(assetId, trackingEvent, seconds);
}

Parameters

Parameter (Python)Parameter (JS)TypeRequiredNotes
sdksdkNomad_SDKyes
asset_idassetIdstryese.g. <asset-uuid>
tracking_eventtrackingEventint | stryes0=seconds progress, 1-4=quartiles/complete, 5=hidden
secondssecondsint | Nonenorequired for seconds-progress (event 0)

Returns

dict | None — recorded tracking data; None when nothing recorded.

Errors

  • 401 unauthenticated
  • InvalidAPITypeException on a non-portal session

See also: Python ↔ JS naming map · Return shapes.