Video API, REST: Video.Update
Update video.
HTTP request
PATCH https://video.api.cloud.yandex.net/video/v1/videos/{videoId}
Path parameters
Field |
Description |
videoId |
string Required field. ID of the video. |
Body parameters
{
"fieldMask": "string",
"title": "string",
"description": "string",
"thumbnailId": "string",
"labels": "string",
// Includes only one of the fields `publicAccess`, `authSystemAccess`
"publicAccess": "object",
"authSystemAccess": "object"
// end of the list of possible fields
}
Field |
Description |
fieldMask |
string (field-mask) A comma-separated names off ALL fields to be updated. If |
title |
string Video title. |
description |
string Video description. |
thumbnailId |
string ID of the thumbnail. |
labels |
string Custom labels as |
publicAccess |
object Includes only one of the fields |
authSystemAccess |
object Includes only one of the fields |
Response
HTTP Code: 200 - OK
{
"id": "string",
"description": "string",
"createdAt": "string",
"createdBy": "string",
"modifiedAt": "string",
"done": "boolean",
"metadata": {
"videoId": "string"
},
// Includes only one of the fields `error`, `response`
"error": {
"code": "integer",
"message": "string",
"details": [
"object"
]
},
"response": {
"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"
}
// end of the list of possible fields
}
An Operation resource. For more information, see Operation.
Field |
Description |
id |
string ID of the operation. |
description |
string Description of the operation. 0-256 characters long. |
createdAt |
string (date-time) Creation timestamp. String in RFC3339 To work with values in this field, use the APIs described in the |
createdBy |
string ID of the user or service account who initiated the operation. |
modifiedAt |
string (date-time) The time when the Operation resource was last modified. String in RFC3339 To work with values in this field, use the APIs described in the |
done |
boolean If the value is |
metadata |
Service-specific metadata associated with the operation. |
error |
The error result of the operation in case of failure or cancellation. Includes only one of the fields The operation result. |
response |
The normal response of the operation in case of success. Includes only one of the fields The operation result. |
UpdateVideoMetadata
Field |
Description |
videoId |
string ID of the video. |
Status
The error result of the operation in case of failure or cancellation.
Field |
Description |
code |
integer (int32) Error code. An enum value of google.rpc.Code |
message |
string An error message. |
details[] |
object A list of messages that carry the error details. |
Video
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. |