Video API, REST: Video.get
Returns the specific video.
HTTP request
GET https://video.api.cloud.yandex.net/video/v1/videos/{videoId}
Path parameters
Parameter | Description |
---|---|
videoId | 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",
"createdAt": "string",
"updatedAt": "string",
"labels": "object",
"tusd": {
"url": "string"
},
// includes only one of the fields `publicAccess`, `authSystemAccess`
"publicAccess": {},
"authSystemAccess": {},
// end of the list of possible fields
}
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 | string Video status.
|
duration | string Video duration. Optional, may be empty until the transcoding result is ready. |
visibilityStatus | string Video visibility status.
|
createdAt | string (date-time) Time when video was created. String in RFC3339 text format. The range of possible values is from 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) Time of last video update. String in RFC3339 text format. The range of possible values is from 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). |
labels | object Custom labels as |
tusd | object Upload video using the tus protocol. |
tusd. url |
string URL for uploading video via the tus protocol. |
publicAccess | object Video is available to everyone. includes only one of the fields publicAccess , authSystemAccess |
authSystemAccess | object Checking access rights using the authorization system. includes only one of the fields publicAccess , authSystemAccess |