[Документация Yandex Cloud](../../../../index.md) > [Yandex Cloud Video](../../../index.md) > Справочник API > [gRPC (англ.)](../index.md) > [Video](index.md) > BatchGet # Video API, gRPC: VideoService.BatchGet Retrieves multiple videos by their IDs in a specific channel in a single request. This is more efficient than making multiple Get requests when retrieving several videos. ## gRPC request **rpc BatchGet ([BatchGetVideosRequest](#yandex.cloud.video.v1.BatchGetVideosRequest)) returns ([BatchGetVideosResponse](#yandex.cloud.video.v1.BatchGetVideosResponse))** ## BatchGetVideosRequest {#yandex.cloud.video.v1.BatchGetVideosRequest} ```json { "channel_id": "string", "video_ids": [ "string" ] } ``` #| ||Field | Description || || channel_id | **string** Required field. ID of the channel containing the videos to retrieve. The maximum string length in characters is 50. || || video_ids[] | **string** List of video IDs to retrieve. The maximum string length in characters for each value is 50. The number of elements must be in the range 1-100. || |# ## BatchGetVideosResponse {#yandex.cloud.video.v1.BatchGetVideosResponse} ```json { "videos": [ { "id": "string", "channel_id": "string", "title": "string", "description": "string", "thumbnail_id": "string", "status": "VideoStatus", "error_message": "string", "visibility_status": "VisibilityStatus", "duration": "google.protobuf.Duration", "auto_transcode": "AutoTranscode", "style_preset_id": "string", "enable_ad": "google.protobuf.BoolValue", "subtitle_ids": [ "string" ], "features": { "summary": { "result": "FeatureResult", "urls": [ { "url": "string", "track_index": "int64", "src_lang": "string" } ] }, "speech_to_text": { "result": "FeatureResult", "urls": [ { "url": "string", "track_index": "int64", "src_lang": "string" } ] } }, // Includes only one of the fields `tusd` "tusd": { "url": "string", "file_size": "int64" }, // end of the list of possible fields // Includes only one of the fields `public_access`, `sign_url_access` "public_access": "VideoPublicAccessRights", "sign_url_access": "VideoSignURLAccessRights", // end of the list of possible fields "created_at": "google.protobuf.Timestamp", "updated_at": "google.protobuf.Timestamp", "labels": "map" } ] } ``` #| ||Field | Description || || videos[] | **[Video](#yandex.cloud.video.v1.Video)** List of videos matching the requested IDs. || |# ## Video {#yandex.cloud.video.v1.Video} Main entity representing a video in the platform. #| ||Field | Description || || id | **string** Unique identifier of the video. || || channel_id | **string** Identifier of the channel where the video is created and managed. || || title | **string** Title of the video displayed to users in interfaces and players. || || description | **string** Detailed description of the video content and context. || || thumbnail_id | **string** Identifier of the thumbnail image used to represent the video visually. || || status | enum **VideoStatus** Current processing status of the video. - `WAIT_UPLOADING`: The video upload is in progress, waiting for all bytes to be received. - `UPLOADED`: The video has been fully uploaded and is ready for transcoding. - `PROCESSING`: The video is currently being processed. - `READY`: The video has been successfully processed and is ready for watching. - `ERROR`: An error occurred during video processing. || || error_message | **string** Error message describing the reason for video processing failure, if any. || || visibility_status | enum **VisibilityStatus** Current visibility status controlling whether the video is publicly available. - `PUBLISHED`: The video is publicly available, subject to its access permission settings. - `UNPUBLISHED`: The video is available only to administrators. || || duration | **[google.protobuf.Duration](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/duration)** Total duration of the video. Optional, may be empty until the transcoding result is ready. || || auto_transcode | enum **AutoTranscode** Auto-transcoding setting that controls the video processing workflow. Set ENABLE to automatically initiate transcoding after upload, or DISABLE for manual initiation via the Transcode() method. - `ENABLE`: Automatically start transcoding after the video upload is complete. - `DISABLE`: Do not automatically transcode; requires manual initiation via the Transcode() method. || || style_preset_id | **string** Identifier of the style preset applied to the video during processing. || || enable_ad | **[google.protobuf.BoolValue](https://developers.google.com/protocol-buffers/docs/reference/csharp/class/google/protobuf/well-known-types/bool-value)** Controls the ability to display advertisements for this video. Default: true. Set explicitly to false to disable advertisements for a specific video. || || subtitle_ids[] | **string** List of identifiers defining the active subtitles available for the video. || || features | **[VideoFeatures](#yandex.cloud.video.v1.VideoFeatures)** Additional video processing features and their results, such as summarization. || || tusd | **[VideoTUSDSource](#yandex.cloud.video.v1.VideoTUSDSource)** Upload video using the TUS (Tus Resumable Upload Protocol) protocol. @see https://tus.io/ Includes only one of the fields `tusd`. Specifies the video upload source method (one source variant must be chosen). || || public_access | **[VideoPublicAccessRights](#yandex.cloud.video.v1.VideoPublicAccessRights)** Allows unrestricted public access to the video via direct link. No additional authorization or access control is applied. Includes only one of the fields `public_access`, `sign_url_access`. Specifies the video access permission settings. || || sign_url_access | **[VideoSignURLAccessRights](#yandex.cloud.video.v1.VideoSignURLAccessRights)** Restricts video access using URL signatures for secure time-limited access. Includes only one of the fields `public_access`, `sign_url_access`. Specifies the video access permission settings. || || created_at | **[google.protobuf.Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#timestamp)** Timestamp when the video was initially created in the system. || || updated_at | **[google.protobuf.Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#timestamp)** Timestamp of the last modification to the video or its metadata. || || labels | **object** (map<**string**, **string**>) Custom user-defined labels as `key:value` pairs. Maximum 64 labels per video. Labels can be used for organization, filtering, and metadata purposes. || |# ## VideoFeatures {#yandex.cloud.video.v1.VideoFeatures} Contains additional processing features and their results for the video. #| ||Field | Description || || summary | **[Summary](#yandex.cloud.video.v1.VideoFeatures.Summary)** Results of the video content summarization process. || || speech_to_text | **[SpeechToText](#yandex.cloud.video.v1.VideoFeatures.SpeechToText)** Results of the speech recognition process. || |# ## Summary {#yandex.cloud.video.v1.VideoFeatures.Summary} Contains the results of video summarization. #| ||Field | Description || || result | enum **FeatureResult** Current status of the summarization process. - `NOT_REQUESTED`: The feature processing has not been requested. - `PROCESSING`: The feature is currently being processed. - `SUCCESS`: The feature processing has completed successfully. - `FAILED`: The feature processing has failed. || || urls[] | **[SummaryURL](#yandex.cloud.video.v1.VideoFeatures.Summary.SummaryURL)** List of URLs to summarization results for different audio tracks. || |# ## SummaryURL {#yandex.cloud.video.v1.VideoFeatures.Summary.SummaryURL} Contains a URL to a summarization result for a specific audio track. #| ||Field | Description || || url | **string** URL to the summarization result file. || || track_index | **int64** Input audio track index (one-based) that was summarized. || || src_lang | **string** Source track language represented as a three-letter code according to ISO 639-2/T. || |# ## SpeechToText {#yandex.cloud.video.v1.VideoFeatures.SpeechToText} Contains the results of speech-to-text processing. #| ||Field | Description || || result | enum **FeatureResult** Current status of the speech-to-text process. - `NOT_REQUESTED`: The feature processing has not been requested. - `PROCESSING`: The feature is currently being processed. - `SUCCESS`: The feature processing has completed successfully. - `FAILED`: The feature processing has failed. || || urls[] | **[SpeechToTextURL](#yandex.cloud.video.v1.VideoFeatures.SpeechToText.SpeechToTextURL)** List of URLs to speech-to-text results for different audio tracks. || |# ## SpeechToTextURL {#yandex.cloud.video.v1.VideoFeatures.SpeechToText.SpeechToTextURL} Contains a URL to a speech-to-text result for a specific audio track. #| ||Field | Description || || url | **string** URL to the speech-to-text result file. || || track_index | **int64** Input audio track index (one-based) that was transcribed. || || src_lang | **string** Source track language represented as a three-letter code according to ISO 639-2/T. || |# ## VideoTUSDSource {#yandex.cloud.video.v1.VideoTUSDSource} Represents a video upload source using the TUS (Tus Resumable Upload Protocol) protocol. This is a push-based upload method where the client pushes data to the server. @see https://tus.io/ #| ||Field | Description || || url | **string** URL endpoint for uploading the video via the TUS protocol. || || file_size | **int64** Total size of the uploaded file, in bytes. || |# ## VideoPublicAccessRights {#yandex.cloud.video.v1.VideoPublicAccessRights} Represents public access rights for a video. When this access type is set, the video is publicly accessible via direct link. #| ||Field | Description || || Empty | > || |# ## VideoSignURLAccessRights {#yandex.cloud.video.v1.VideoSignURLAccessRights} Represents access rights controlled by URL signatures. When this access type is set, the video is accessible only via properly signed temporary link. #| ||Field | Description || || Empty | > || |#