yandexcloud 0.350.0__py3-none-any.whl → 0.352.0__py3-none-any.whl

yandex/cloud/video/v1/video_service_pb2.pyi

@@ -23,7 +23,7 @@ class GetVideoRequest(google.protobuf.message.Message):
 
     VIDEO_ID_FIELD_NUMBER: builtins.int
     video_id: builtins.str
-    """ID of the video."""
+    """ID of the video to retrieve."""
     def __init__(
         self,
         *,
@@ -43,32 +43,34 @@ class ListVideoRequest(google.protobuf.message.Message):
     ORDER_BY_FIELD_NUMBER: builtins.int
     FILTER_FIELD_NUMBER: builtins.int
     channel_id: builtins.str
-    """ID of the channel."""
+    """ID of the channel containing the videos to list."""
     page_size: builtins.int
-    """The maximum number of the results per page to return.
-    Default value: 100.
-    """
+    """The maximum number of videos to return per page."""
     page_token: builtins.str
-    """Page token for getting the next page of the result."""
+    """Page token for retrieving the next page of results.
+    This token is obtained from the next_page_token field in the previous ListVideoResponse.
+    """
     order_by: builtins.str
-    """By which column the listing should be ordered and in which direction,
-    format is "<field> <order>" (e.g. "createdAt desc").
+    """Specifies the ordering of results.
+    Format is "<field> <order>" (e.g., "createdAt desc").
     Default: "id asc".
-    Possible fields: ["id", "title", "createdAt", "updatedAt"].
-    Both snake_case and camelCase are supported for fields.
+    Supported fields: ["id", "title", "createdAt", "updatedAt"].
+    Both snake_case and camelCase field names are supported.
     """
     filter: builtins.str
-    """Filter expression that filters resources listed in the response.
-    Expressions are composed of terms connected by logic operators.
-    If value contains spaces or quotes,
-    it should be in quotes (`'` or `"`) with the inner quotes being backslash escaped.
+    """Filter expression to narrow down the list of returned videos.
+    Expressions consist of terms connected by logical operators.
+    Values containing spaces or quotes must be enclosed in quotes (`'` or `"`)
+    with inner quotes being backslash-escaped.
+
     Supported logical operators: ["AND", "OR"].
-    Supported string match operators: ["=", "!=", ":"].
-    Operator ":" stands for substring matching.
-    Filter expressions may also contain parentheses to group logical operands.
-    Example: `key1='value' AND (key2!='\\'value\\'' OR key2:"\\"value\\"")`
-    Supported fields: ["id", "title", "status", "visibilityStatus"].
-    Both snake_case and camelCase are supported for fields.
+    Supported comparison operators: ["=", "!=", ":"] where ":" enables substring matching.
+    Parentheses can be used to group logical expressions.
+
+    Example: `title:'sample' AND (status='READY' OR visibilityStatus='PUBLISHED')`
+
+    Filterable fields: ["id", "title", "status", "visibilityStatus"].
+    Both snake_case and camelCase field names are supported.
     """
     def __init__(
         self,
@@ -90,9 +92,15 @@ class ListVideoResponse(google.protobuf.message.Message):
     VIDEOS_FIELD_NUMBER: builtins.int
     NEXT_PAGE_TOKEN_FIELD_NUMBER: builtins.int
     next_page_token: builtins.str
-    """Token for getting the next page."""
+    """Token for retrieving the next page of results.
+    Empty if there are no more results available.
+    """
     @property
-    def videos(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.video.v1.video_pb2.Video]: ...
+    def videos(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.video.v1.video_pb2.Video]:
+        """List of videos matching the request criteria.
+        May be empty if no videos match the criteria or if the channel is empty.
+        """
+
     def __init__(
         self,
         *,
@@ -110,10 +118,10 @@ class BatchGetVideosRequest(google.protobuf.message.Message):
     CHANNEL_ID_FIELD_NUMBER: builtins.int
     VIDEO_IDS_FIELD_NUMBER: builtins.int
     channel_id: builtins.str
-    """ID of the channel."""
+    """ID of the channel containing the videos to retrieve."""
     @property
     def video_ids(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
-        """List of requested video IDs."""
+        """List of video IDs to retrieve."""
 
     def __init__(
         self,
@@ -132,7 +140,7 @@ class BatchGetVideosResponse(google.protobuf.message.Message):
     VIDEOS_FIELD_NUMBER: builtins.int
     @property
     def videos(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.video.v1.video_pb2.Video]:
-        """List of videos for channel."""
+        """List of videos matching the requested IDs."""
 
     def __init__(
         self,
@@ -168,6 +176,7 @@ class CreateVideoRequest(google.protobuf.message.Message):
     DESCRIPTION_FIELD_NUMBER: builtins.int
     THUMBNAIL_ID_FIELD_NUMBER: builtins.int
     AUTO_TRANSCODE_FIELD_NUMBER: builtins.int
+    STYLE_PRESET_ID_FIELD_NUMBER: builtins.int
     AUTO_PUBLISH_FIELD_NUMBER: builtins.int
     ENABLE_AD_FIELD_NUMBER: builtins.int
     LABELS_FIELD_NUMBER: builtins.int
@@ -175,45 +184,61 @@ class CreateVideoRequest(google.protobuf.message.Message):
     PUBLIC_ACCESS_FIELD_NUMBER: builtins.int
     SIGN_URL_ACCESS_FIELD_NUMBER: builtins.int
     channel_id: builtins.str
-    """ID of the channel."""
+    """ID of the channel where the video will be created."""
     title: builtins.str
-    """Video title."""
+    """Title of the video to be displayed in interfaces and players."""
     description: builtins.str
-    """Video description."""
+    """Detailed description of the video content and context.
+    Optional field that can provide additional information about the video.
+    """
     thumbnail_id: builtins.str
-    """ID of the thumbnail."""
+    """ID of the thumbnail image to be used for the video.
+    If not provided, a thumbnail may be automatically generated during transcoding.
+    """
     auto_transcode: yandex.cloud.video.v1.video_pb2.AutoTranscode.ValueType
-    """Auto start transcoding."""
+    """Controls whether transcoding starts automatically after upload.
+    Set to ENABLE to automatically initiate transcoding after upload,
+    or DISABLE for manual initiation via the Transcode() method.
+    """
+    style_preset_id: builtins.str
+    """ID of the style preset to apply to the video during processing.
+    Style presets define visual appearance settings for the video player.
+    """
     @property
     def auto_publish(self) -> google.protobuf.wrappers_pb2.BoolValue:
-        """Automatically publish video after transcoding.
-        Switches visibility status to PUBLISHED.
+        """Controls whether the video is automatically published after transcoding.
+        When set to true, the video's visibility status will be set to PUBLISHED
+        once transcoding is complete, making it available for watching.
         """
 
     @property
     def enable_ad(self) -> google.protobuf.wrappers_pb2.BoolValue:
-        """Enable advertisement for this video.
-        Default: true.
-        Set explicitly to false to disable advertisements for a specific video.
+        """Controls the ability to display advertisements for this video.
+        Default: true
+        Set explicitly to false to disable advertisements for this specific video.
         """
 
     @property
     def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]:
-        """Custom labels as `` key:value `` pairs. Maximum 64 per resource."""
+        """Custom user-defined labels as `key:value` pairs.
+        Maximum 64 labels per video.
+        Keys must be lowercase alphanumeric strings with optional hyphens/underscores.
+        Values can contain alphanumeric characters and various symbols.
+        """
 
     @property
     def tusd(self) -> global___VideoTUSDParams:
-        """Upload video using the tus protocol."""
+        """Upload video using the TUS (Tus Resumable Upload Protocol) protocol.
+        This is a push-based upload method where the client pushes data to the server.
+        """
 
     @property
     def public_access(self) -> global___VideoPublicAccessParams:
-        """Publicly accessible video available for viewing by anyone with the direct link.
-        No additional authorization or access control is applied.
-        """
+        """Video is publicly available."""
 
     @property
     def sign_url_access(self) -> global___VideoSignURLAccessParams:
-        """Checking access rights using url's signature."""
+        """Access to the video is restricted by temporarily signed links."""
 
     def __init__(
         self,
@@ -223,6 +248,7 @@ class CreateVideoRequest(google.protobuf.message.Message):
         description: builtins.str = ...,
         thumbnail_id: builtins.str = ...,
         auto_transcode: yandex.cloud.video.v1.video_pb2.AutoTranscode.ValueType = ...,
+        style_preset_id: builtins.str = ...,
         auto_publish: google.protobuf.wrappers_pb2.BoolValue | None = ...,
         enable_ad: google.protobuf.wrappers_pb2.BoolValue | None = ...,
         labels: collections.abc.Mapping[builtins.str, builtins.str] | None = ...,
@@ -231,7 +257,7 @@ class CreateVideoRequest(google.protobuf.message.Message):
         sign_url_access: global___VideoSignURLAccessParams | None = ...,
     ) -> None: ...
     def HasField(self, field_name: typing.Literal["access_rights", b"access_rights", "auto_publish", b"auto_publish", "enable_ad", b"enable_ad", "public_access", b"public_access", "sign_url_access", b"sign_url_access", "source", b"source", "tusd", b"tusd"]) -> builtins.bool: ...
-    def ClearField(self, field_name: typing.Literal["access_rights", b"access_rights", "auto_publish", b"auto_publish", "auto_transcode", b"auto_transcode", "channel_id", b"channel_id", "description", b"description", "enable_ad", b"enable_ad", "labels", b"labels", "public_access", b"public_access", "sign_url_access", b"sign_url_access", "source", b"source", "thumbnail_id", b"thumbnail_id", "title", b"title", "tusd", b"tusd"]) -> None: ...
+    def ClearField(self, field_name: typing.Literal["access_rights", b"access_rights", "auto_publish", b"auto_publish", "auto_transcode", b"auto_transcode", "channel_id", b"channel_id", "description", b"description", "enable_ad", b"enable_ad", "labels", b"labels", "public_access", b"public_access", "sign_url_access", b"sign_url_access", "source", b"source", "style_preset_id", b"style_preset_id", "thumbnail_id", b"thumbnail_id", "title", b"title", "tusd", b"tusd"]) -> None: ...
     @typing.overload
     def WhichOneof(self, oneof_group: typing.Literal["access_rights", b"access_rights"]) -> typing.Literal["public_access", "sign_url_access"] | None: ...
     @typing.overload
@@ -246,9 +272,11 @@ class VideoTUSDParams(google.protobuf.message.Message):
     FILE_SIZE_FIELD_NUMBER: builtins.int
     FILE_NAME_FIELD_NUMBER: builtins.int
     file_size: builtins.int
-    """File size."""
+    """Total size of the file to be uploaded, in bytes."""
     file_name: builtins.str
-    """File name."""
+    """Original name of the file being uploaded.
+    This is used for reference and does not affect the upload process.
+    """
     def __init__(
         self,
         *,
@@ -261,6 +289,8 @@ global___VideoTUSDParams = VideoTUSDParams
 
 @typing.final
 class VideoPublicAccessParams(google.protobuf.message.Message):
+    """Parameters for video public access rights."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     def __init__(
@@ -271,6 +301,8 @@ global___VideoPublicAccessParams = VideoPublicAccessParams
 
 @typing.final
 class VideoSignURLAccessParams(google.protobuf.message.Message):
+    """Parameters for video access restrictions based on temporary signed links."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     def __init__(
@@ -285,7 +317,7 @@ class CreateVideoMetadata(google.protobuf.message.Message):
 
     VIDEO_ID_FIELD_NUMBER: builtins.int
     video_id: builtins.str
-    """ID of the video."""
+    """Unique identifier of the video."""
     def __init__(
         self,
         *,
@@ -321,44 +353,53 @@ class UpdateVideoRequest(google.protobuf.message.Message):
     DESCRIPTION_FIELD_NUMBER: builtins.int
     THUMBNAIL_ID_FIELD_NUMBER: builtins.int
     AUTO_TRANSCODE_FIELD_NUMBER: builtins.int
+    STYLE_PRESET_ID_FIELD_NUMBER: builtins.int
     ENABLE_AD_FIELD_NUMBER: builtins.int
     LABELS_FIELD_NUMBER: builtins.int
     PUBLIC_ACCESS_FIELD_NUMBER: builtins.int
     SIGN_URL_ACCESS_FIELD_NUMBER: builtins.int
     video_id: builtins.str
-    """ID of the video."""
+    """ID of the video to update."""
     title: builtins.str
-    """Video title."""
+    """New title for the video."""
     description: builtins.str
-    """Video description."""
+    """New description for the video."""
     thumbnail_id: builtins.str
-    """ID of the thumbnail."""
+    """New thumbnail ID for the video."""
     auto_transcode: yandex.cloud.video.v1.video_pb2.AutoTranscode.ValueType
-    """Auto start transcoding."""
+    """New auto-transcoding setting for the video.
+    Controls whether transcoding starts automatically after upload.
+    """
+    style_preset_id: builtins.str
+    """New style preset ID for the video."""
     @property
     def field_mask(self) -> google.protobuf.field_mask_pb2.FieldMask:
-        """Field mask that specifies which fields of the video are going to be updated."""
+        """Field mask specifying which fields of the video should be updated.
+        Only fields specified in this mask will be modified;
+        all other fields will retain their current values.
+        This allows for partial updates.
+        """
 
     @property
     def enable_ad(self) -> google.protobuf.wrappers_pb2.BoolValue:
-        """Enable advertisement for this video.
-        Default: true.
-        Use this to disable advertisement for a specific video.
+        """New advertisement setting for the video.
+        Set to false to disable advertisements for this specific video.
         """
 
     @property
     def labels(self) -> google.protobuf.internal.containers.ScalarMap[builtins.str, builtins.str]:
-        """Custom labels as `` key:value `` pairs. Maximum 64 per resource."""
+        """New custom labels for the video as `key:value` pairs.
+        Maximum 64 labels per video.
+        If provided, replaces all existing labels.
+        """
 
     @property
     def public_access(self) -> global___VideoPublicAccessParams:
-        """Publicly accessible video available for viewing by anyone with the direct link.
-        No additional authorization or access control is applied.
-        """
+        """Makes the video publicly accessible to anyone with the direct link."""
 
     @property
     def sign_url_access(self) -> global___VideoSignURLAccessParams:
-        """Checking access rights using url's signature."""
+        """Restricts video access using URL signatures for secure time-limited access."""
 
     def __init__(
         self,
@@ -369,13 +410,14 @@ class UpdateVideoRequest(google.protobuf.message.Message):
         description: builtins.str = ...,
         thumbnail_id: builtins.str = ...,
         auto_transcode: yandex.cloud.video.v1.video_pb2.AutoTranscode.ValueType = ...,
+        style_preset_id: builtins.str = ...,
         enable_ad: google.protobuf.wrappers_pb2.BoolValue | None = ...,
         labels: collections.abc.Mapping[builtins.str, builtins.str] | None = ...,
         public_access: global___VideoPublicAccessParams | None = ...,
         sign_url_access: global___VideoSignURLAccessParams | None = ...,
     ) -> None: ...
     def HasField(self, field_name: typing.Literal["access_rights", b"access_rights", "enable_ad", b"enable_ad", "field_mask", b"field_mask", "public_access", b"public_access", "sign_url_access", b"sign_url_access"]) -> builtins.bool: ...
-    def ClearField(self, field_name: typing.Literal["access_rights", b"access_rights", "auto_transcode", b"auto_transcode", "description", b"description", "enable_ad", b"enable_ad", "field_mask", b"field_mask", "labels", b"labels", "public_access", b"public_access", "sign_url_access", b"sign_url_access", "thumbnail_id", b"thumbnail_id", "title", b"title", "video_id", b"video_id"]) -> None: ...
+    def ClearField(self, field_name: typing.Literal["access_rights", b"access_rights", "auto_transcode", b"auto_transcode", "description", b"description", "enable_ad", b"enable_ad", "field_mask", b"field_mask", "labels", b"labels", "public_access", b"public_access", "sign_url_access", b"sign_url_access", "style_preset_id", b"style_preset_id", "thumbnail_id", b"thumbnail_id", "title", b"title", "video_id", b"video_id"]) -> None: ...
     def WhichOneof(self, oneof_group: typing.Literal["access_rights", b"access_rights"]) -> typing.Literal["public_access", "sign_url_access"] | None: ...
 
 global___UpdateVideoRequest = UpdateVideoRequest
@@ -406,24 +448,32 @@ class TranscodeVideoRequest(google.protobuf.message.Message):
     TRANSLATION_SETTINGS_FIELD_NUMBER: builtins.int
     SUMMARIZATION_SETTINGS_FIELD_NUMBER: builtins.int
     video_id: builtins.str
-    """ID of the video."""
+    """ID of the video to transcode."""
     @property
     def field_mask(self) -> google.protobuf.field_mask_pb2.FieldMask:
-        """Field mask that specifies which transcoding specific fields of the video
-        are going to be updated.
+        """Field mask specifying which transcoding-specific fields should be updated.
+        Only fields specified in this mask will be modified;
+        all other fields will retain their current values.
+        This allows for partial updates.
         """
 
     @property
     def subtitle_ids(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
-        """IDs of active manually uploaded video subtitles."""
+        """IDs of manually uploaded subtitle files to include in the transcoding process.
+        These subtitles will be embedded in the video output.
+        """
 
     @property
     def translation_settings(self) -> global___VideoTranslationSettings:
-        """Video translation settings."""
+        """Settings for automatic translation of audio tracks.
+        Defines source tracks and target languages for subtitle and audio translation.
+        """
 
     @property
     def summarization_settings(self) -> global___VideoSummarizationSettings:
-        """Video summarization settings."""
+        """Settings for automatic video content summarization.
+        Defines which audio tracks should be processed to generate text summaries.
+        """
 
     def __init__(
         self,
@@ -481,9 +531,7 @@ class VideoTranslationSettings(google.protobuf.message.Message):
         track_index: builtins.int
         """Input audio track index (one-based)."""
         src_lang: builtins.str
-        """Source track language in any of the following formats:
-        * three-letter code according to ISO 639-2/T, ISO 639-2/B, or ISO 639-3 
-        * two-letter code according to ISO 639-1                          
+        """Source track language represented as a three-letter code according to ISO 639-2/T.
         Track language will be deduced automatically if not provided.
         In the latter case the deduction accuracy is not guaranteed.
         For better performance please do specify the source track language when possible.
@@ -503,10 +551,7 @@ class VideoTranslationSettings(google.protobuf.message.Message):
         DST_LANG_FIELD_NUMBER: builtins.int
         LABEL_FIELD_NUMBER: builtins.int
         dst_lang: builtins.str
-        """Target language in any of the following formats:
-        * three-letter code according to ISO 639-2/T, ISO 639-2/B, or ISO 639-3 
-        * two-letter code according to ISO 639-1
-        """
+        """Target language represented as a three-letter code according to ISO 639-2/T."""
         label: builtins.str
         """Track label to be displayed on the screen during video playback."""
         def __init__(
@@ -524,10 +569,7 @@ class VideoTranslationSettings(google.protobuf.message.Message):
         DST_LANG_FIELD_NUMBER: builtins.int
         LABEL_FIELD_NUMBER: builtins.int
         dst_lang: builtins.str
-        """Target language in any of the following formats:
-        * three-letter code according to ISO 639-2/T, ISO 639-2/B, or ISO 639-3 
-        * two-letter code according to ISO 639-1
-        """
+        """Target language represented as a three-letter code according to ISO 639-2/T."""
         label: builtins.str
         """Track label to be displayed on the screen during video playback."""
         def __init__(
@@ -582,7 +624,7 @@ class VideoSummarizationSettings(google.protobuf.message.Message):
         track_index: builtins.int
         """Input audio track index (one-based)."""
         src_lang: builtins.str
-        """Source track language (three-letter code according to ISO 639-2/T, ISO 639-2/B, or ISO 639-3).
+        """Source track language represented as a three-letter code according to ISO 639-2/T.
         It will be deduced automatically if not provided.
         In the latter case the deduction accuracy is not guaranteed.
         For better performance please do specify the source track language when possible.
@@ -639,7 +681,7 @@ class DeleteVideoRequest(google.protobuf.message.Message):
 
     VIDEO_ID_FIELD_NUMBER: builtins.int
     video_id: builtins.str
-    """ID of the video."""
+    """ID of the video to delete."""
     def __init__(
         self,
         *,
@@ -655,7 +697,9 @@ class DeleteVideoMetadata(google.protobuf.message.Message):
 
     VIDEO_ID_FIELD_NUMBER: builtins.int
     video_id: builtins.str
-    """ID of the video."""
+    """ID of the video.
+    This identifier can be used to track the video deletion operation.
+    """
     def __init__(
         self,
         *,
@@ -672,10 +716,10 @@ class BatchDeleteVideosRequest(google.protobuf.message.Message):
     CHANNEL_ID_FIELD_NUMBER: builtins.int
     VIDEO_IDS_FIELD_NUMBER: builtins.int
     channel_id: builtins.str
-    """ID of the channel."""
+    """ID of the channel containing the videos to delete."""
     @property
     def video_ids(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
-        """List of video IDs."""
+        """List of video IDs to delete."""
 
     def __init__(
         self,
@@ -694,7 +738,10 @@ class BatchDeleteVideosMetadata(google.protobuf.message.Message):
     VIDEO_IDS_FIELD_NUMBER: builtins.int
     @property
     def video_ids(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
-        """List of video IDs."""
+        """List of video IDs being deleted.
+        This list can be used to track which videos are included
+        in the batch deletion operation.
+        """
 
     def __init__(
         self,
@@ -713,11 +760,19 @@ class PerformVideoActionRequest(google.protobuf.message.Message):
     PUBLISH_FIELD_NUMBER: builtins.int
     UNPUBLISH_FIELD_NUMBER: builtins.int
     video_id: builtins.str
-    """ID of the video."""
+    """ID of the video on which to perform the action."""
     @property
-    def publish(self) -> global___PublishVideoAction: ...
+    def publish(self) -> global___PublishVideoAction:
+        """Publish the video, making it available for watching.
+        Changes the video's visibility status to PUBLISHED.
+        """
+
     @property
-    def unpublish(self) -> global___UnpublishVideoAction: ...
+    def unpublish(self) -> global___UnpublishVideoAction:
+        """Unpublish the video, making it unavailable for watching.
+        Changes the video's visibility status to UNPUBLISHED.
+        """
+
     def __init__(
         self,
         *,
@@ -733,6 +788,8 @@ global___PerformVideoActionRequest = PerformVideoActionRequest
 
 @typing.final
 class PublishVideoAction(google.protobuf.message.Message):
+    """Parameters for the publish action."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     def __init__(
@@ -743,6 +800,8 @@ global___PublishVideoAction = PublishVideoAction
 
 @typing.final
 class UnpublishVideoAction(google.protobuf.message.Message):
+    """Parameters for the unpublish action."""
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     def __init__(
@@ -757,7 +816,10 @@ class PerformVideoActionMetadata(google.protobuf.message.Message):
 
     VIDEO_ID_FIELD_NUMBER: builtins.int
     video_id: builtins.str
-    """ID of the video."""
+    """ID of the video on which the action is being performed.
+    This identifier can be used to track the action operation
+    and to verify that the action is being applied to the correct video.
+    """
     def __init__(
         self,
         *,
@@ -775,12 +837,18 @@ class GetVideoPlayerURLRequest(google.protobuf.message.Message):
     PARAMS_FIELD_NUMBER: builtins.int
     SIGNED_URL_EXPIRATION_DURATION_FIELD_NUMBER: builtins.int
     video_id: builtins.str
-    """ID of the video."""
+    """ID of the video for which to generate a player URL."""
     @property
-    def params(self) -> global___VideoPlayerParams: ...
+    def params(self) -> global___VideoPlayerParams:
+        """Optional player parameters to customize the playback experience.
+        These parameters control initial player state such as mute, autoplay, and visibility of interface controls.
+        """
+
     @property
     def signed_url_expiration_duration(self) -> google.protobuf.duration_pb2.Duration:
-        """Optional field, used to set custom url expiration duration for videos with sign_url_access"""
+        """For episodes with signed URL access, specifies how long the generated URL will be valid.
+        If not provided, a default expiration duration will be used.
+        """
 
     def __init__(
         self,
@@ -802,11 +870,17 @@ class VideoPlayerParams(google.protobuf.message.Message):
     AUTOPLAY_FIELD_NUMBER: builtins.int
     HIDDEN_FIELD_NUMBER: builtins.int
     mute: builtins.bool
-    """If true, a player will be muted by default."""
+    """If true, the player will start with audio muted.
+    Users can unmute the audio manually after playback starts.
+    """
     autoplay: builtins.bool
-    """If true, playback will start automatically."""
+    """If true, the video will start playing automatically when the player loads.
+    This may be subject to browser autoplay policies that restrict autoplay with sound.
+    """
     hidden: builtins.bool
-    """If true, a player interface will be hidden by default."""
+    """If true, the player interface controls will be hidden initially.
+    Users can typically reveal the controls by moving the mouse over the player.
+    """
     def __init__(
         self,
         *,
@@ -825,9 +899,14 @@ class GetVideoPlayerURLResponse(google.protobuf.message.Message):
     PLAYER_URL_FIELD_NUMBER: builtins.int
     HTML_FIELD_NUMBER: builtins.int
     player_url: builtins.str
-    """Direct link to the video."""
+    """Direct URL to the video player.
+    This URL can be used to access the video in a web browser
+    or shared with users who have appropriate permissions.
+    """
     html: builtins.str
-    """HTML embed code in Iframe format."""
+    """HTML embed code in iframe format that can be inserted into web pages.
+    This code allows the video to be embedded directly in third-party websites.
+    """
     def __init__(
         self,
         *,
@@ -847,16 +926,24 @@ class BatchGetVideoPlayerURLsRequest(google.protobuf.message.Message):
     PARAMS_FIELD_NUMBER: builtins.int
     SIGNED_URL_EXPIRATION_DURATION_FIELD_NUMBER: builtins.int
     channel_id: builtins.str
-    """ID of the channel."""
+    """ID of the channel containing the videos for which to generate player URLs."""
     @property
     def video_ids(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
-        """List of requested video IDs."""
+        """List of video IDs for which to generate player URLs."""
 
     @property
-    def params(self) -> global___VideoPlayerParams: ...
+    def params(self) -> global___VideoPlayerParams:
+        """Optional player parameters to customize the playback experience.
+        These parameters control initial player state such as mute, autoplay, and visibility of interface controls.
+        These parameters will be applied to all generated player URLs.
+        """
+
     @property
     def signed_url_expiration_duration(self) -> google.protobuf.duration_pb2.Duration:
-        """Optional field, used to set custom url expiration duration for videos with sign_url_access"""
+        """For episodes with signed URL access, specifies how long the generated URL will be valid.
+        If not provided, a default expiration duration will be used.
+        This setting applies to all videos in the batch that use sign_url_access.
+        """
 
     def __init__(
         self,
@@ -877,7 +964,11 @@ class BatchGetVideoPlayerURLsResponse(google.protobuf.message.Message):
 
     PLAYER_URLS_FIELD_NUMBER: builtins.int
     @property
-    def player_urls(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]: ...
+    def player_urls(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
+        """List of player URLs corresponding to the requested video IDs.
+        The order of URLs matches the order of video IDs in the request.
+        """
+
     def __init__(
         self,
         *,
@@ -893,7 +984,7 @@ class GetVideoManifestsRequest(google.protobuf.message.Message):
 
     VIDEO_ID_FIELD_NUMBER: builtins.int
     video_id: builtins.str
-    """ID of the video."""
+    """ID of the video for which to retrieve manifest URLs."""
     def __init__(
         self,
         *,
@@ -909,7 +1000,11 @@ class GetVideoManifestsResponse(google.protobuf.message.Message):
 
     MANIFESTS_FIELD_NUMBER: builtins.int
     @property
-    def manifests(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.video.v1.manifest_pb2.Manifest]: ...
+    def manifests(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.video.v1.manifest_pb2.Manifest]:
+        """List of manifests available for the video.
+        Different manifests may represent different streaming formats (e.g., HLS, DASH)
+        """
+
     def __init__(
         self,
         *,