Tracks

A track is the basis of Ooyala Schedule.

A track is composed of one or more linearly scheduled track segments.
Tracks have the following structure.
Note: The live_stream_asset_id property is optional.
{
   "id": "8ffbfcda77fb40b0af6425ae24752254",
   "name": "P12N",
   "live_stream_asset_id": "0yMTVoMzpqSB_nCyAJwvaAXSePizm6I3"
}

Create a track

[POST]/v2/tracks{
   "name": "new track"
}

View all tracks

[GET]/v2/tracks

View one track

[GET]/v2/track/track_id

Delete a track

[DELETE]/v2/track/track_id

Modify a track

[PATCH]/v2/track/track_id{
   "name": "new track"
}

Route Attributes

The following table describes all attributes that can be expressed through the route.

Route Attribute Description
track_id

The ID of the track.

Type: String

Default: None

Example: /v2/tracks/8ffbfcda77fb40b0af6425ae24752254

Properties

The following table describes all properties that can be associated with a track.

Property Description Required?
live_stream_asset_id

Identifier of a live stream or remote live stream.

Type: String

Example: "0yMTVoMzpqSB_nCyAJwvaAXSePizm6I3"

No
name

A descriptive name for this track.

Type: String

Valid Values: Limit of 256 characters. Must not contain control characters, except for newline (char 10) or carriage return (char 13).

Example: "my fave track"

Yes

Examples

This example creates a track:

[POST]/v2/tracks{
   "name": "my fave track",
}

Backlot returns a response similar to the following:

{
   "id": "2162e39c331d407d9176895f34e36af8",
   "name": "my fave track"
}
Note: Try out the code samples using your account credentials in the Ooyala Scratchpad. To launch the Scratchpad, go to Ooyala API Scratchpad. For information about using the Scratchpad, see Practice Making Requests with the Scratchpad.

Was this article helpful?