Video API, gRPC: StreamService.BatchGet
Batch get streams for channel.
gRPC request
rpc BatchGet (BatchGetStreamsRequest) returns (BatchGetStreamsResponse)
BatchGetStreamsRequest
{
"channel_id": "string",
"stream_ids": [
"string"
]
}
|
Field |
Description |
|
channel_id |
string Required field. ID of the channel. |
|
stream_ids[] |
string List of requested stream IDs. |
BatchGetStreamsResponse
{
"streams": [
{
"id": "string",
"channel_id": "string",
"line_id": "string",
"title": "string",
"description": "string",
"thumbnail_id": "string",
"status": "StreamStatus",
"start_time": "google.protobuf.Timestamp",
"publish_time": "google.protobuf.Timestamp",
"finish_time": "google.protobuf.Timestamp",
// Includes only one of the fields `on_demand`, `schedule`
"on_demand": "OnDemand",
"schedule": {
"start_time": "google.protobuf.Timestamp",
"finish_time": "google.protobuf.Timestamp"
},
// end of the list of possible fields
"created_at": "google.protobuf.Timestamp",
"updated_at": "google.protobuf.Timestamp",
"labels": "map<string, string>"
}
]
}
|
Field |
Description |
|
streams[] |
List of streams for specific channel. |
Stream
|
Field |
Description |
|
id |
string ID of the stream. |
|
channel_id |
string ID of the channel where the stream was created. |
|
line_id |
string ID of the line to which stream is linked. |
|
title |
string Stream title. |
|
description |
string Stream description. |
|
thumbnail_id |
string ID of the thumbnail. |
|
status |
enum StreamStatus Stream status.
|
|
start_time |
Stream start time. |
|
publish_time |
Stream publish time. Time when stream switched to ONAIR status. |
|
finish_time |
Stream finish time. |
|
on_demand |
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. |
|
created_at |
Time when stream was created. |
|
updated_at |
Time of last stream update. |
|
labels |
object (map<string, string>) Custom labels as |
OnDemand
If "OnDemand" is used, client should start and finish explicitly.
|
Field |
Description |
|
Empty |
|
Schedule
If "Schedule" is used, stream automatically start and finish at this time.
|
Field |
Description |
|
start_time |
|
|
finish_time |