Video API, REST: Stream.List
List streams for channel.
HTTP request
GET https://video.api.cloud.yandex.net/video/v1/streams
Query parameters
Field |
Description |
channelId |
string ID of the channel. |
pageSize |
string (int64) The maximum number of the results per page to return. Default value: 100. |
pageToken |
string Page token for getting the next page of the result. |
orderBy |
string By which column the listing should be ordered and in which direction, |
filter |
string Filter expression that filters resources listed in the response. |
Response
HTTP Code: 200 - OK
{
"streams": [
{
"id": "string",
"channelId": "string",
"lineId": "string",
"title": "string",
"description": "string",
"thumbnailId": "string",
"status": "string",
"startTime": "string",
"publishTime": "string",
"finishTime": "string",
// Includes only one of the fields `onDemand`, `schedule`
"onDemand": "object",
"schedule": {
"startTime": "string",
"finishTime": "string"
},
// end of the list of possible fields
"createdAt": "string",
"updatedAt": "string",
"labels": "string"
}
],
"nextPageToken": "string"
}
Field |
Description |
streams[] |
List of streams for channel. |
nextPageToken |
string Token for getting the next page. |
Stream
Field |
Description |
id |
string ID of the stream. |
channelId |
string ID of the channel where the stream was created. |
lineId |
string ID of the line to which stream is linked. |
title |
string Stream title. |
description |
string Stream description. |
thumbnailId |
string ID of the thumbnail. |
status |
enum (StreamStatus) Stream status.
|
startTime |
string (date-time) Stream start time. String in RFC3339 To work with values in this field, use the APIs described in the |
publishTime |
string (date-time) Stream publish time. Time when stream switched to ONAIR status. String in RFC3339 To work with values in this field, use the APIs described in the |
finishTime |
string (date-time) Stream finish time. String in RFC3339 To work with values in this field, use the APIs described in the |
onDemand |
object On demand stream. It starts immediately when a signal appears. Includes only one of the fields Stream type. |
schedule |
Schedule stream. Determines when to start receiving the signal or finish time. Includes only one of the fields Stream type. |
createdAt |
string (date-time) Time when stream was created. String in RFC3339 To work with values in this field, use the APIs described in the |
updatedAt |
string (date-time) Time of last stream update. String in RFC3339 To work with values in this field, use the APIs described in the |
labels |
string Custom labels as |
Schedule
If "Schedule" is used, stream automatically start and finish at this time.
Field |
Description |
startTime |
string (date-time) String in RFC3339 To work with values in this field, use the APIs described in the |
finishTime |
string (date-time) String in RFC3339 To work with values in this field, use the APIs described in the |