Video API, REST: Episode.Get

Field

Description

episodeId

string

Required field. ID of the episode to retrieve.

The maximum string length in characters is 50.

Field

Description

id

string

Unique identifier of the episode.

streamId

string

Identifier of the stream this episode is linked to.
Optional, empty if the episode is linked to a line.

lineId

string

Identifier of the line this episode is linked to.
Optional, empty if the episode is linked to a stream.

title

string

Title of the episode displayed in interfaces and players.

description

string

Detailed description of the episode content and context.

thumbnailId

string

Identifier of the thumbnail image used to represent the episode visually.

startTime

string (date-time)

Timestamp marking the beginning of the episode content.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

finishTime

string (date-time)

Timestamp marking the end of the episode content.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

dvrSeconds

string (int64)

Controls the Digital Video Recording (DVR) functionality for the episode.
Determines how many seconds of the stream are available for time-shifted viewing.

Possible values:

• 0: Infinite DVR size, the full length of the stream is available for viewing.
• >0: Size of DVR window in seconds, the minimum value is 30s.

visibilityStatus

enum (VisibilityStatus)

Current visibility status controlling whether the episode is publicly available.

• VISIBILITY_STATUS_UNSPECIFIED: The visibility status is not specified.
• PUBLISHED: The episode is publicly available, subject to its access permission settings.
• UNPUBLISHED: The episode is available only to administrators.

stylePresetId

string

Identifier of the style preset used in the player during episode playback.

publicAccess

object

Allows unrestricted public access to the episode via direct link.
No additional authorization or access control is applied.

Includes only one of the fields publicAccess, signUrlAccess.

Specifies the episode access permission settings.

signUrlAccess

object

Restricts episode access using URL signatures for secure time-limited access.

Includes only one of the fields publicAccess, signUrlAccess.

Specifies the episode access permission settings.

createdAt

string (date-time)

Timestamp when the episode was initially created in the system.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).

updatedAt

string (date-time)

Timestamp of the last modification to the episode or its metadata.

String in RFC3339 text format. The range of possible values is from
0001-01-01T00:00:00Z to 9999-12-31T23:59:59.999999999Z, i.e. from 0 to 9 digits for fractions of a second.

To work with values in this field, use the APIs described in the
Protocol Buffers reference.
In some languages, built-in datetime utilities do not support nanosecond precision (9 digits).