Video API, REST: Video.Get
Returns the specific video.
HTTP request
GET https://video.api.cloud.yandex.net/video/v1/videos/{videoId}
Path parameters
Field |
Description |
videoId |
string Required field. ID of the video. |
Response
HTTP Code: 200 - OK
{
"id": "string",
"channelId": "string",
"title": "string",
"description": "string",
"thumbnailId": "string",
"status": "string",
"duration": "string",
"visibilityStatus": "string",
// Includes only one of the fields `tusd`
"tusd": {
"url": "string"
},
// end of the list of possible fields
// Includes only one of the fields `publicAccess`, `authSystemAccess`
"publicAccess": "object",
"authSystemAccess": "object",
// end of the list of possible fields
"createdAt": "string",
"updatedAt": "string",
"labels": "string"
}
Field |
Description |
id |
string ID of the video. |
channelId |
string ID of the channel where the video was created. |
title |
string Video title. |
description |
string Video description. |
thumbnailId |
string ID of the thumbnail. |
status |
enum (VideoStatus) Video status.
|
duration |
string (duration) Video duration. Optional, may be empty until the transcoding result is ready. |
visibilityStatus |
enum (VisibilityStatus) Video visibility status.
|
tusd |
Upload video using the tus protocol. Includes only one of the fields Source type. |
publicAccess |
object Video is available to everyone. Includes only one of the fields Video access rights. |
authSystemAccess |
object Checking access rights using the authorization system. Includes only one of the fields Video access rights. |
createdAt |
string (date-time) Time when video 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 video update. String in RFC3339 To work with values in this field, use the APIs described in the |
labels |
string Custom labels as |
VideoTUSDSource
Field |
Description |
url |
string URL for uploading video via the tus protocol. |