yandexcloud 0.351.0__py3-none-any.whl → 0.353.0__py3-none-any.whl

yandex/cloud/video/v1/thumbnail_service_pb2.pyi

@@ -26,7 +26,9 @@ class GetThumbnailRequest(google.protobuf.message.Message):
 
     THUMBNAIL_ID_FIELD_NUMBER: builtins.int
     thumbnail_id: builtins.str
-    """ID of the thumbnail."""
+    """ID of the thumbnail to retrieve.
+    Must be a valid thumbnail identifier string.
+    """
     def __init__(
         self,
         *,
@@ -41,24 +43,34 @@ class ListThumbnailRequest(google.protobuf.message.Message):
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     CHANNEL_ID_FIELD_NUMBER: builtins.int
+    EPISODE_ID_FIELD_NUMBER: builtins.int
+    VIDEO_ID_FIELD_NUMBER: builtins.int
     PAGE_SIZE_FIELD_NUMBER: builtins.int
     PAGE_TOKEN_FIELD_NUMBER: builtins.int
     channel_id: builtins.str
-    """ID of the channel."""
+    """[Deprecated] ID of the channel."""
+    episode_id: builtins.str
+    """ID of the episode containing the thumbnails to list."""
+    video_id: builtins.str
+    """ID of the video containing the thumbnails to list."""
     page_size: builtins.int
-    """The maximum number of the results per page to return.
-    Default value: 100.
-    """
+    """The maximum number of thumbnails 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 ListThumbnailResponse.
+    """
     def __init__(
         self,
         *,
         channel_id: builtins.str = ...,
+        episode_id: builtins.str = ...,
+        video_id: builtins.str = ...,
         page_size: builtins.int = ...,
         page_token: builtins.str = ...,
     ) -> None: ...
-    def ClearField(self, field_name: typing.Literal["channel_id", b"channel_id", "page_size", b"page_size", "page_token", b"page_token"]) -> None: ...
+    def HasField(self, field_name: typing.Literal["episode_id", b"episode_id", "parent_id", b"parent_id", "video_id", b"video_id"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["channel_id", b"channel_id", "episode_id", b"episode_id", "page_size", b"page_size", "page_token", b"page_token", "parent_id", b"parent_id", "video_id", b"video_id"]) -> None: ...
+    def WhichOneof(self, oneof_group: typing.Literal["parent_id", b"parent_id"]) -> typing.Literal["episode_id", "video_id"] | None: ...
 
 global___ListThumbnailRequest = ListThumbnailRequest
 
@@ -69,10 +81,14 @@ class ListThumbnailResponse(google.protobuf.message.Message):
     THUMBNAILS_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 thumbnails(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[yandex.cloud.video.v1.thumbnail_pb2.Thumbnail]:
-        """List of thumbnails."""
+        """List of thumbnails matching the request criteria.
+        May be empty if no thumbnails match the criteria or if the parent resource has no thumbnails.
+        """
 
     def __init__(
         self,
@@ -89,14 +105,24 @@ class CreateThumbnailRequest(google.protobuf.message.Message):
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     CHANNEL_ID_FIELD_NUMBER: builtins.int
+    EPISODE_ID_FIELD_NUMBER: builtins.int
+    VIDEO_ID_FIELD_NUMBER: builtins.int
     channel_id: builtins.str
-    """ID of the channel."""
+    """[Deprecated] ID of the channel."""
+    episode_id: builtins.str
+    """ID of the episode to associate the thumbnail with."""
+    video_id: builtins.str
+    """ID of the video to associate the thumbnail with."""
     def __init__(
         self,
         *,
         channel_id: builtins.str = ...,
+        episode_id: builtins.str = ...,
+        video_id: builtins.str = ...,
     ) -> None: ...
-    def ClearField(self, field_name: typing.Literal["channel_id", b"channel_id"]) -> None: ...
+    def HasField(self, field_name: typing.Literal["episode_id", b"episode_id", "parent_id", b"parent_id", "video_id", b"video_id"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["channel_id", b"channel_id", "episode_id", b"episode_id", "parent_id", b"parent_id", "video_id", b"video_id"]) -> None: ...
+    def WhichOneof(self, oneof_group: typing.Literal["parent_id", b"parent_id"]) -> typing.Literal["episode_id", "video_id"] | None: ...
 
 global___CreateThumbnailRequest = CreateThumbnailRequest
 
@@ -106,7 +132,7 @@ class CreateThumbnailMetadata(google.protobuf.message.Message):
 
     THUMBNAIL_ID_FIELD_NUMBER: builtins.int
     thumbnail_id: builtins.str
-    """ID of the thumbnail."""
+    """ID of the thumbnail being created."""
     def __init__(
         self,
         *,
@@ -123,10 +149,10 @@ class BatchGenerateDownloadURLsRequest(google.protobuf.message.Message):
     CHANNEL_ID_FIELD_NUMBER: builtins.int
     THUMBNAIL_IDS_FIELD_NUMBER: builtins.int
     channel_id: builtins.str
-    """ID of the channel."""
+    """ID of the channel containing the thumbnails."""
     @property
     def thumbnail_ids(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
-        """List of thumbnails IDs."""
+        """List of thumbnail IDs for which to generate download URLs."""
 
     def __init__(
         self,
@@ -145,7 +171,9 @@ class BatchGenerateDownloadURLsResponse(google.protobuf.message.Message):
     DOWNLOAD_URLS_FIELD_NUMBER: builtins.int
     @property
     def download_urls(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[global___ThumbnailDownloadURL]:
-        """List of download urls."""
+        """List of download URLs for the requested thumbnails.
+        Each entry contains URLs for both the original image and various scaled versions.
+        """
 
     def __init__(
         self,
@@ -167,22 +195,38 @@ class ThumbnailDownloadURL(google.protobuf.message.Message):
     class _ImageFormatEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[ThumbnailDownloadURL._ImageFormat.ValueType], builtins.type):
         DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
         IMAGE_FORMAT_UNSPECIFIED: ThumbnailDownloadURL._ImageFormat.ValueType  # 0
-        """Image format unspecified."""
+        """The image format is not specified."""
         JPEG: ThumbnailDownloadURL._ImageFormat.ValueType  # 1
-        """JPEG image format."""
+        """JPEG image format.
+        Provides good compression with some quality loss.
+        Widely supported across all platforms and browsers.
+        """
         WEBP: ThumbnailDownloadURL._ImageFormat.ValueType  # 2
-        """WebP image format."""
+        """WebP image format.
+        Provides better compression than JPEG with similar quality.
+        May not be supported on all platforms and older browsers.
+        """
+
+    class ImageFormat(_ImageFormat, metaclass=_ImageFormatEnumTypeWrapper):
+        """Image format of a thumbnail."""
 
-    class ImageFormat(_ImageFormat, metaclass=_ImageFormatEnumTypeWrapper): ...
     IMAGE_FORMAT_UNSPECIFIED: ThumbnailDownloadURL.ImageFormat.ValueType  # 0
-    """Image format unspecified."""
+    """The image format is not specified."""
     JPEG: ThumbnailDownloadURL.ImageFormat.ValueType  # 1
-    """JPEG image format."""
+    """JPEG image format.
+    Provides good compression with some quality loss.
+    Widely supported across all platforms and browsers.
+    """
     WEBP: ThumbnailDownloadURL.ImageFormat.ValueType  # 2
-    """WebP image format."""
+    """WebP image format.
+    Provides better compression than JPEG with similar quality.
+    May not be supported on all platforms and older browsers.
+    """
 
     @typing.final
     class ScaledURL(google.protobuf.message.Message):
+        """Represents a URL for a specific scaled version of a thumbnail image."""
+
         DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
         URL_FIELD_NUMBER: builtins.int
@@ -190,13 +234,19 @@ class ThumbnailDownloadURL(google.protobuf.message.Message):
         MAX_HEIGHT_FIELD_NUMBER: builtins.int
         IMAGE_FORMAT_FIELD_NUMBER: builtins.int
         url: builtins.str
-        """Download url."""
+        """URL for downloading this scaled version of the thumbnail."""
         max_width: builtins.int
-        """Maximum width of the rectangle to inscribe the thumbnail into."""
+        """Maximum width in pixels of the scaled image.
+        The actual width may be smaller to maintain the aspect ratio.
+        """
         max_height: builtins.int
-        """Maximum height of the rectangle to inscribe the thumbnail into."""
+        """Maximum height in pixels of the scaled image.
+        The actual height may be smaller to maintain the aspect ratio.
+        """
         image_format: global___ThumbnailDownloadURL.ImageFormat.ValueType
-        """Image format."""
+        """Format of the scaled image (JPEG, WebP, etc.).
+        Different formats offer different trade-offs between quality and file size.
+        """
         def __init__(
             self,
             *,
@@ -211,12 +261,16 @@ class ThumbnailDownloadURL(google.protobuf.message.Message):
     ORIGINAL_URL_FIELD_NUMBER: builtins.int
     SCALED_URLS_FIELD_NUMBER: builtins.int
     thumbnail_id: builtins.str
-    """ID of the thumbnail."""
+    """ID of the thumbnail for which download URLs are provided."""
     original_url: builtins.str
-    """Original download url."""
+    """URL for downloading the original, unmodified thumbnail image.
+    This provides access to the image at its original resolution and format.
+    """
     @property
     def scaled_urls(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[global___ThumbnailDownloadURL.ScaledURL]:
-        """List of download urls, one per each available image size."""
+        """List of URLs for downloading scaled versions of the thumbnail.
+        Different scaled versions are optimized for different display sizes and purposes.
+        """
 
     def __init__(
         self,
@@ -235,7 +289,9 @@ class GenerateThumbnailUploadURLRequest(google.protobuf.message.Message):
 
     THUMBNAIL_ID_FIELD_NUMBER: builtins.int
     thumbnail_id: builtins.str
-    """ID of the thumbnail."""
+    """ID of the thumbnail for which to generate an upload URL.
+    The thumbnail record must already exist, typically created using the Create method.
+    """
     def __init__(
         self,
         *,
@@ -251,7 +307,10 @@ class GenerateThumbnailUploadURLResponse(google.protobuf.message.Message):
 
     UPLOAD_URL_FIELD_NUMBER: builtins.int
     upload_url: builtins.str
-    """Upload url."""
+    """Pre-signed URL for uploading the thumbnail image.
+    This URL can be used with an HTTP PUT request to upload the image file.
+    The URL has a limited validity period and will expire after a certain time.
+    """
     def __init__(
         self,
         *,
@@ -267,7 +326,7 @@ class DeleteThumbnailRequest(google.protobuf.message.Message):
 
     THUMBNAIL_ID_FIELD_NUMBER: builtins.int
     thumbnail_id: builtins.str
-    """ID of the thumbnail."""
+    """ID of the thumbnail to delete."""
     def __init__(
         self,
         *,
@@ -283,7 +342,9 @@ class DeleteThumbnailMetadata(google.protobuf.message.Message):
 
     THUMBNAIL_ID_FIELD_NUMBER: builtins.int
     thumbnail_id: builtins.str
-    """ID of the thumbnail."""
+    """ID of the thumbnail being deleted.
+    This identifier can be used to track the thumbnail deletion operation.
+    """
     def __init__(
         self,
         *,

yandex/cloud/video/v1/thumbnail_service_pb2_grpc.py

@@ -29,6 +29,8 @@ if _version_not_supported:
 
 class ThumbnailServiceStub(object):
     """Thumbnail management service.
+    Provides methods for creating, retrieving, and managing thumbnail images
+    that can be associated with various resources such as videos, streams, episodes, and channels.
     """
 
     def __init__(self, channel):
@@ -71,45 +73,56 @@ class ThumbnailServiceStub(object):
 
 class ThumbnailServiceServicer(object):
     """Thumbnail management service.
+    Provides methods for creating, retrieving, and managing thumbnail images
+    that can be associated with various resources such as videos, streams, episodes, and channels.
     """
 
     def Get(self, request, context):
-        """Get the specific thumbnail.
+        """Retrieves detailed information about a specific thumbnail by its ID.
+        Returns all thumbnail metadata and related information.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def List(self, request, context):
-        """List thumbnails for channel.
+        """Lists all thumbnails associated with a specific resource (channel, stream, video, etc.)
+        with pagination support.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def Create(self, request, context):
-        """Create thumbnail.
+        """Creates a new thumbnail record for a specific resource.
+        This method only creates the metadata record; the actual image must be uploaded
+        using the URL obtained from the GenerateUploadURL method.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def BatchGenerateDownloadURLs(self, request, context):
-        """Generate urls for downloading images.
+        """Generates download URLs for multiple thumbnails in a single request.
+        The response includes URLs for both original and scaled versions of each thumbnail.
+        This is useful for efficiently retrieving multiple thumbnails at once.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def GenerateUploadURL(self, request, context):
-        """Generate url for uploading an image.
+        """Generates a URL for uploading an image to an existing thumbnail record.
+        This URL can be used to upload the actual image file using an HTTP PUT request.
+        The URL is pre-signed and has a limited validity period.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def Delete(self, request, context):
-        """Delete thumbnail.
+        """Deletes a specific thumbnail by its ID.
+        This removes both the metadata record and the associated image file.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
@@ -158,6 +171,8 @@ def add_ThumbnailServiceServicer_to_server(servicer, server):
  # This class is part of an EXPERIMENTAL API.
 class ThumbnailService(object):
     """Thumbnail management service.
+    Provides methods for creating, retrieving, and managing thumbnail images
+    that can be associated with various resources such as videos, streams, episodes, and channels.
     """
 
     @staticmethod

yandex/cloud/video/v1/thumbnail_service_pb2_grpc.pyi

@@ -20,86 +20,125 @@ class _ServicerContext(grpc.ServicerContext, grpc.aio.ServicerContext):  # type:
     ...
 
 class ThumbnailServiceStub:
-    """Thumbnail management service."""
+    """Thumbnail management service.
+    Provides methods for creating, retrieving, and managing thumbnail images
+    that can be associated with various resources such as videos, streams, episodes, and channels.
+    """
 
     def __init__(self, channel: typing.Union[grpc.Channel, grpc.aio.Channel]) -> None: ...
     Get: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.thumbnail_service_pb2.GetThumbnailRequest,
         yandex.cloud.video.v1.thumbnail_pb2.Thumbnail,
     ]
-    """Get the specific thumbnail."""
+    """Retrieves detailed information about a specific thumbnail by its ID.
+    Returns all thumbnail metadata and related information.
+    """
 
     List: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.thumbnail_service_pb2.ListThumbnailRequest,
         yandex.cloud.video.v1.thumbnail_service_pb2.ListThumbnailResponse,
     ]
-    """List thumbnails for channel."""
+    """Lists all thumbnails associated with a specific resource (channel, stream, video, etc.)
+    with pagination support.
+    """
 
     Create: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.thumbnail_service_pb2.CreateThumbnailRequest,
         yandex.cloud.operation.operation_pb2.Operation,
     ]
-    """Create thumbnail."""
+    """Creates a new thumbnail record for a specific resource.
+    This method only creates the metadata record; the actual image must be uploaded
+    using the URL obtained from the GenerateUploadURL method.
+    """
 
     BatchGenerateDownloadURLs: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.thumbnail_service_pb2.BatchGenerateDownloadURLsRequest,
         yandex.cloud.video.v1.thumbnail_service_pb2.BatchGenerateDownloadURLsResponse,
     ]
-    """Generate urls for downloading images."""
+    """Generates download URLs for multiple thumbnails in a single request.
+    The response includes URLs for both original and scaled versions of each thumbnail.
+    This is useful for efficiently retrieving multiple thumbnails at once.
+    """
 
     GenerateUploadURL: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.thumbnail_service_pb2.GenerateThumbnailUploadURLRequest,
         yandex.cloud.video.v1.thumbnail_service_pb2.GenerateThumbnailUploadURLResponse,
     ]
-    """Generate url for uploading an image."""
+    """Generates a URL for uploading an image to an existing thumbnail record.
+    This URL can be used to upload the actual image file using an HTTP PUT request.
+    The URL is pre-signed and has a limited validity period.
+    """
 
     Delete: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.thumbnail_service_pb2.DeleteThumbnailRequest,
         yandex.cloud.operation.operation_pb2.Operation,
     ]
-    """Delete thumbnail."""
+    """Deletes a specific thumbnail by its ID.
+    This removes both the metadata record and the associated image file.
+    """
 
 class ThumbnailServiceAsyncStub:
-    """Thumbnail management service."""
+    """Thumbnail management service.
+    Provides methods for creating, retrieving, and managing thumbnail images
+    that can be associated with various resources such as videos, streams, episodes, and channels.
+    """
 
     Get: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.thumbnail_service_pb2.GetThumbnailRequest,
         yandex.cloud.video.v1.thumbnail_pb2.Thumbnail,
     ]
-    """Get the specific thumbnail."""
+    """Retrieves detailed information about a specific thumbnail by its ID.
+    Returns all thumbnail metadata and related information.
+    """
 
     List: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.thumbnail_service_pb2.ListThumbnailRequest,
         yandex.cloud.video.v1.thumbnail_service_pb2.ListThumbnailResponse,
     ]
-    """List thumbnails for channel."""
+    """Lists all thumbnails associated with a specific resource (channel, stream, video, etc.)
+    with pagination support.
+    """
 
     Create: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.thumbnail_service_pb2.CreateThumbnailRequest,
         yandex.cloud.operation.operation_pb2.Operation,
     ]
-    """Create thumbnail."""
+    """Creates a new thumbnail record for a specific resource.
+    This method only creates the metadata record; the actual image must be uploaded
+    using the URL obtained from the GenerateUploadURL method.
+    """
 
     BatchGenerateDownloadURLs: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.thumbnail_service_pb2.BatchGenerateDownloadURLsRequest,
         yandex.cloud.video.v1.thumbnail_service_pb2.BatchGenerateDownloadURLsResponse,
     ]
-    """Generate urls for downloading images."""
+    """Generates download URLs for multiple thumbnails in a single request.
+    The response includes URLs for both original and scaled versions of each thumbnail.
+    This is useful for efficiently retrieving multiple thumbnails at once.
+    """
 
     GenerateUploadURL: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.thumbnail_service_pb2.GenerateThumbnailUploadURLRequest,
         yandex.cloud.video.v1.thumbnail_service_pb2.GenerateThumbnailUploadURLResponse,
     ]
-    """Generate url for uploading an image."""
+    """Generates a URL for uploading an image to an existing thumbnail record.
+    This URL can be used to upload the actual image file using an HTTP PUT request.
+    The URL is pre-signed and has a limited validity period.
+    """
 
     Delete: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.thumbnail_service_pb2.DeleteThumbnailRequest,
         yandex.cloud.operation.operation_pb2.Operation,
     ]
-    """Delete thumbnail."""
+    """Deletes a specific thumbnail by its ID.
+    This removes both the metadata record and the associated image file.
+    """
 
 class ThumbnailServiceServicer(metaclass=abc.ABCMeta):
-    """Thumbnail management service."""
+    """Thumbnail management service.
+    Provides methods for creating, retrieving, and managing thumbnail images
+    that can be associated with various resources such as videos, streams, episodes, and channels.
+    """
 
     @abc.abstractmethod
     def Get(
@@ -107,7 +146,9 @@ class ThumbnailServiceServicer(metaclass=abc.ABCMeta):
         request: yandex.cloud.video.v1.thumbnail_service_pb2.GetThumbnailRequest,
         context: _ServicerContext,
     ) -> typing.Union[yandex.cloud.video.v1.thumbnail_pb2.Thumbnail, collections.abc.Awaitable[yandex.cloud.video.v1.thumbnail_pb2.Thumbnail]]:
-        """Get the specific thumbnail."""
+        """Retrieves detailed information about a specific thumbnail by its ID.
+        Returns all thumbnail metadata and related information.
+        """
 
     @abc.abstractmethod
     def List(
@@ -115,7 +156,9 @@ class ThumbnailServiceServicer(metaclass=abc.ABCMeta):
         request: yandex.cloud.video.v1.thumbnail_service_pb2.ListThumbnailRequest,
         context: _ServicerContext,
     ) -> typing.Union[yandex.cloud.video.v1.thumbnail_service_pb2.ListThumbnailResponse, collections.abc.Awaitable[yandex.cloud.video.v1.thumbnail_service_pb2.ListThumbnailResponse]]:
-        """List thumbnails for channel."""
+        """Lists all thumbnails associated with a specific resource (channel, stream, video, etc.)
+        with pagination support.
+        """
 
     @abc.abstractmethod
     def Create(
@@ -123,7 +166,10 @@ class ThumbnailServiceServicer(metaclass=abc.ABCMeta):
         request: yandex.cloud.video.v1.thumbnail_service_pb2.CreateThumbnailRequest,
         context: _ServicerContext,
     ) -> typing.Union[yandex.cloud.operation.operation_pb2.Operation, collections.abc.Awaitable[yandex.cloud.operation.operation_pb2.Operation]]:
-        """Create thumbnail."""
+        """Creates a new thumbnail record for a specific resource.
+        This method only creates the metadata record; the actual image must be uploaded
+        using the URL obtained from the GenerateUploadURL method.
+        """
 
     @abc.abstractmethod
     def BatchGenerateDownloadURLs(
@@ -131,7 +177,10 @@ class ThumbnailServiceServicer(metaclass=abc.ABCMeta):
         request: yandex.cloud.video.v1.thumbnail_service_pb2.BatchGenerateDownloadURLsRequest,
         context: _ServicerContext,
     ) -> typing.Union[yandex.cloud.video.v1.thumbnail_service_pb2.BatchGenerateDownloadURLsResponse, collections.abc.Awaitable[yandex.cloud.video.v1.thumbnail_service_pb2.BatchGenerateDownloadURLsResponse]]:
-        """Generate urls for downloading images."""
+        """Generates download URLs for multiple thumbnails in a single request.
+        The response includes URLs for both original and scaled versions of each thumbnail.
+        This is useful for efficiently retrieving multiple thumbnails at once.
+        """
 
     @abc.abstractmethod
     def GenerateUploadURL(
@@ -139,7 +188,10 @@ class ThumbnailServiceServicer(metaclass=abc.ABCMeta):
         request: yandex.cloud.video.v1.thumbnail_service_pb2.GenerateThumbnailUploadURLRequest,
         context: _ServicerContext,
     ) -> typing.Union[yandex.cloud.video.v1.thumbnail_service_pb2.GenerateThumbnailUploadURLResponse, collections.abc.Awaitable[yandex.cloud.video.v1.thumbnail_service_pb2.GenerateThumbnailUploadURLResponse]]:
-        """Generate url for uploading an image."""
+        """Generates a URL for uploading an image to an existing thumbnail record.
+        This URL can be used to upload the actual image file using an HTTP PUT request.
+        The URL is pre-signed and has a limited validity period.
+        """
 
     @abc.abstractmethod
     def Delete(
@@ -147,6 +199,8 @@ class ThumbnailServiceServicer(metaclass=abc.ABCMeta):
         request: yandex.cloud.video.v1.thumbnail_service_pb2.DeleteThumbnailRequest,
         context: _ServicerContext,
     ) -> typing.Union[yandex.cloud.operation.operation_pb2.Operation, collections.abc.Awaitable[yandex.cloud.operation.operation_pb2.Operation]]:
-        """Delete thumbnail."""
+        """Deletes a specific thumbnail by its ID.
+        This removes both the metadata record and the associated image file.
+        """
 
 def add_ThumbnailServiceServicer_to_server(servicer: ThumbnailServiceServicer, server: typing.Union[grpc.Server, grpc.aio.Server]) -> None: ...

yandex/cloud/video/v1/video_pb2.py

@@ -27,7 +27,7 @@ from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__
 from google.protobuf import wrappers_pb2 as google_dot_protobuf_dot_wrappers__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n!yandex/cloud/video/v1/video.proto\x12\x15yandex.cloud.video.v1\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1egoogle/protobuf/wrappers.proto\"\xb0\t\n\x05Video\x12\n\n\x02id\x18\x01 \x01(\t\x12\x12\n\nchannel_id\x18\x02 \x01(\t\x12\r\n\x05title\x18\x03 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x04 \x01(\t\x12\x14\n\x0cthumbnail_id\x18\x05 \x01(\t\x12\x38\n\x06status\x18\x06 \x01(\x0e\x32(.yandex.cloud.video.v1.Video.VideoStatus\x12\x15\n\rerror_message\x18\x12 \x01(\t\x12H\n\x11visibility_status\x18\t \x01(\x0e\x32-.yandex.cloud.video.v1.Video.VisibilityStatus\x12+\n\x08\x64uration\x18\x08 \x01(\x0b\x32\x19.google.protobuf.Duration\x12<\n\x0e\x61uto_transcode\x18\x0b \x01(\x0e\x32$.yandex.cloud.video.v1.AutoTranscode\x12-\n\tenable_ad\x18\x11 \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12\x14\n\x0csubtitle_ids\x18\x0c \x03(\t\x12\x36\n\x08\x66\x65\x61tures\x18\r \x01(\x0b\x32$.yandex.cloud.video.v1.VideoFeatures\x12\x37\n\x04tusd\x18\xe8\x07 \x01(\x0b\x32&.yandex.cloud.video.v1.VideoTUSDSourceH\x00\x12H\n\rpublic_access\x18\xd0\x0f \x01(\x0b\x32..yandex.cloud.video.v1.VideoPublicAccessRightsH\x01\x12K\n\x0fsign_url_access\x18\xd3\x0f \x01(\x0b\x32/.yandex.cloud.video.v1.VideoSignURLAccessRightsH\x01\x12.\n\ncreated_at\x18\x64 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\x65 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x39\n\x06labels\x18\xc8\x01 \x03(\x0b\x32(.yandex.cloud.video.v1.Video.LabelsEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x7f\n\x0bVideoStatus\x12\x1c\n\x18VIDEO_STATUS_UNSPECIFIED\x10\x00\x12\x12\n\x0eWAIT_UPLOADING\x10\x01\x12\x0c\n\x08UPLOADED\x10\x02\x12\x0e\n\nPROCESSING\x10\x04\x12\t\n\x05READY\x10\x05\x12\t\n\x05\x45RROR\x10\x07\"\x04\x08\x03\x10\x03\"\x04\x08\x06\x10\x06\"U\n\x10VisibilityStatus\x12!\n\x1dVISIBILITY_STATUS_UNSPECIFIED\x10\x00\x12\r\n\tPUBLISHED\x10\x01\x12\x0f\n\x0bUNPUBLISHED\x10\x02\x42\x08\n\x06sourceB\x0f\n\raccess_rightsJ\x06\x08\xd1\x0f\x10\xd2\x0fJ\x06\x08\xd2\x0f\x10\xd3\x0fJ\x04\x08\x07\x10\x08J\x04\x08\n\x10\x0bJ\x04\x08\x0e\x10\x11J\x04\x08\x13\x10\x64J\x05\x08\x66\x10\xc8\x01J\x06\x08\xc9\x01\x10\xe8\x07J\x06\x08\xe9\x07\x10\xd0\x0f\"1\n\x0fVideoTUSDSource\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\x11\n\tfile_size\x18\x02 \x01(\x03\"\x19\n\x17VideoPublicAccessRights\"\x1a\n\x18VideoSignURLAccessRights\"\x9a\x03\n\rVideoFeatures\x12=\n\x07summary\x18\x01 \x01(\x0b\x32,.yandex.cloud.video.v1.VideoFeatures.Summary\x1a\xdc\x01\n\x07Summary\x12\x42\n\x06result\x18\x01 \x01(\x0e\x32\x32.yandex.cloud.video.v1.VideoFeatures.FeatureResult\x12\x45\n\x04urls\x18\x03 \x03(\x0b\x32\x37.yandex.cloud.video.v1.VideoFeatures.Summary.SummaryURL\x1a@\n\nSummaryURL\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\x13\n\x0btrack_index\x18\x02 \x01(\x03\x12\x10\n\x08src_lang\x18\x03 \x01(\tJ\x04\x08\x02\x10\x03\"k\n\rFeatureResult\x12\x1e\n\x1a\x46\x45\x41TURE_RESULT_UNSPECIFIED\x10\x00\x12\x11\n\rNOT_REQUESTED\x10\x01\x12\x0e\n\nPROCESSING\x10\x02\x12\x0b\n\x07SUCCESS\x10\x03\x12\n\n\x06\x46\x41ILED\x10\x04*H\n\rAutoTranscode\x12\x1e\n\x1a\x41UTO_TRANSCODE_UNSPECIFIED\x10\x00\x12\n\n\x06\x45NABLE\x10\x01\x12\x0b\n\x07\x44ISABLE\x10\x02\x42\\\n\x19yandex.cloud.api.video.v1Z?github.com/yandex-cloud/go-genproto/yandex/cloud/video/v1;videob\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n!yandex/cloud/video/v1/video.proto\x12\x15yandex.cloud.video.v1\x1a\x1egoogle/protobuf/duration.proto\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1egoogle/protobuf/wrappers.proto\"\xc9\t\n\x05Video\x12\n\n\x02id\x18\x01 \x01(\t\x12\x12\n\nchannel_id\x18\x02 \x01(\t\x12\r\n\x05title\x18\x03 \x01(\t\x12\x13\n\x0b\x64\x65scription\x18\x04 \x01(\t\x12\x14\n\x0cthumbnail_id\x18\x05 \x01(\t\x12\x38\n\x06status\x18\x06 \x01(\x0e\x32(.yandex.cloud.video.v1.Video.VideoStatus\x12\x15\n\rerror_message\x18\x12 \x01(\t\x12H\n\x11visibility_status\x18\t \x01(\x0e\x32-.yandex.cloud.video.v1.Video.VisibilityStatus\x12+\n\x08\x64uration\x18\x08 \x01(\x0b\x32\x19.google.protobuf.Duration\x12<\n\x0e\x61uto_transcode\x18\x0b \x01(\x0e\x32$.yandex.cloud.video.v1.AutoTranscode\x12\x17\n\x0fstyle_preset_id\x18\x10 \x01(\t\x12-\n\tenable_ad\x18\x11 \x01(\x0b\x32\x1a.google.protobuf.BoolValue\x12\x14\n\x0csubtitle_ids\x18\x0c \x03(\t\x12\x36\n\x08\x66\x65\x61tures\x18\r \x01(\x0b\x32$.yandex.cloud.video.v1.VideoFeatures\x12\x37\n\x04tusd\x18\xe8\x07 \x01(\x0b\x32&.yandex.cloud.video.v1.VideoTUSDSourceH\x00\x12H\n\rpublic_access\x18\xd0\x0f \x01(\x0b\x32..yandex.cloud.video.v1.VideoPublicAccessRightsH\x01\x12K\n\x0fsign_url_access\x18\xd3\x0f \x01(\x0b\x32/.yandex.cloud.video.v1.VideoSignURLAccessRightsH\x01\x12.\n\ncreated_at\x18\x64 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12.\n\nupdated_at\x18\x65 \x01(\x0b\x32\x1a.google.protobuf.Timestamp\x12\x39\n\x06labels\x18\xc8\x01 \x03(\x0b\x32(.yandex.cloud.video.v1.Video.LabelsEntry\x1a-\n\x0bLabelsEntry\x12\x0b\n\x03key\x18\x01 \x01(\t\x12\r\n\x05value\x18\x02 \x01(\t:\x02\x38\x01\"\x7f\n\x0bVideoStatus\x12\x1c\n\x18VIDEO_STATUS_UNSPECIFIED\x10\x00\x12\x12\n\x0eWAIT_UPLOADING\x10\x01\x12\x0c\n\x08UPLOADED\x10\x02\x12\x0e\n\nPROCESSING\x10\x04\x12\t\n\x05READY\x10\x05\x12\t\n\x05\x45RROR\x10\x07\"\x04\x08\x03\x10\x03\"\x04\x08\x06\x10\x06\"U\n\x10VisibilityStatus\x12!\n\x1dVISIBILITY_STATUS_UNSPECIFIED\x10\x00\x12\r\n\tPUBLISHED\x10\x01\x12\x0f\n\x0bUNPUBLISHED\x10\x02\x42\x08\n\x06sourceB\x0f\n\raccess_rightsJ\x04\x08\n\x10\x0bJ\x06\x08\xd1\x0f\x10\xd2\x0fJ\x06\x08\xd2\x0f\x10\xd3\x0fJ\x04\x08\x07\x10\x08J\x04\x08\x0e\x10\x10J\x04\x08\x13\x10\x64J\x05\x08\x66\x10\xc8\x01J\x06\x08\xc9\x01\x10\xe8\x07J\x06\x08\xe9\x07\x10\xd0\x0f\"1\n\x0fVideoTUSDSource\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\x11\n\tfile_size\x18\x02 \x01(\x03\"\x19\n\x17VideoPublicAccessRights\"\x1a\n\x18VideoSignURLAccessRights\"\x9a\x03\n\rVideoFeatures\x12=\n\x07summary\x18\x01 \x01(\x0b\x32,.yandex.cloud.video.v1.VideoFeatures.Summary\x1a\xdc\x01\n\x07Summary\x12\x42\n\x06result\x18\x01 \x01(\x0e\x32\x32.yandex.cloud.video.v1.VideoFeatures.FeatureResult\x12\x45\n\x04urls\x18\x03 \x03(\x0b\x32\x37.yandex.cloud.video.v1.VideoFeatures.Summary.SummaryURL\x1a@\n\nSummaryURL\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\x13\n\x0btrack_index\x18\x02 \x01(\x03\x12\x10\n\x08src_lang\x18\x03 \x01(\tJ\x04\x08\x02\x10\x03\"k\n\rFeatureResult\x12\x1e\n\x1a\x46\x45\x41TURE_RESULT_UNSPECIFIED\x10\x00\x12\x11\n\rNOT_REQUESTED\x10\x01\x12\x0e\n\nPROCESSING\x10\x02\x12\x0b\n\x07SUCCESS\x10\x03\x12\n\n\x06\x46\x41ILED\x10\x04*H\n\rAutoTranscode\x12\x1e\n\x1a\x41UTO_TRANSCODE_UNSPECIFIED\x10\x00\x12\n\n\x06\x45NABLE\x10\x01\x12\x0b\n\x07\x44ISABLE\x10\x02\x42\\\n\x19yandex.cloud.api.video.v1Z?github.com/yandex-cloud/go-genproto/yandex/cloud/video/v1;videob\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -37,28 +37,28 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['DESCRIPTOR']._serialized_options = b'\n\031yandex.cloud.api.video.v1Z?github.com/yandex-cloud/go-genproto/yandex/cloud/video/v1;video'
   _globals['_VIDEO_LABELSENTRY']._loaded_options = None
   _globals['_VIDEO_LABELSENTRY']._serialized_options = b'8\001'
-  _globals['_AUTOTRANSCODE']._serialized_start=1879
-  _globals['_AUTOTRANSCODE']._serialized_end=1951
+  _globals['_AUTOTRANSCODE']._serialized_start=1904
+  _globals['_AUTOTRANSCODE']._serialized_end=1976
   _globals['_VIDEO']._serialized_start=158
-  _globals['_VIDEO']._serialized_end=1358
-  _globals['_VIDEO_LABELSENTRY']._serialized_start=1007
-  _globals['_VIDEO_LABELSENTRY']._serialized_end=1052
-  _globals['_VIDEO_VIDEOSTATUS']._serialized_start=1054
-  _globals['_VIDEO_VIDEOSTATUS']._serialized_end=1181
-  _globals['_VIDEO_VISIBILITYSTATUS']._serialized_start=1183
-  _globals['_VIDEO_VISIBILITYSTATUS']._serialized_end=1268
-  _globals['_VIDEOTUSDSOURCE']._serialized_start=1360
-  _globals['_VIDEOTUSDSOURCE']._serialized_end=1409
-  _globals['_VIDEOPUBLICACCESSRIGHTS']._serialized_start=1411
-  _globals['_VIDEOPUBLICACCESSRIGHTS']._serialized_end=1436
-  _globals['_VIDEOSIGNURLACCESSRIGHTS']._serialized_start=1438
-  _globals['_VIDEOSIGNURLACCESSRIGHTS']._serialized_end=1464
-  _globals['_VIDEOFEATURES']._serialized_start=1467
-  _globals['_VIDEOFEATURES']._serialized_end=1877
-  _globals['_VIDEOFEATURES_SUMMARY']._serialized_start=1548
-  _globals['_VIDEOFEATURES_SUMMARY']._serialized_end=1768
-  _globals['_VIDEOFEATURES_SUMMARY_SUMMARYURL']._serialized_start=1698
-  _globals['_VIDEOFEATURES_SUMMARY_SUMMARYURL']._serialized_end=1762
-  _globals['_VIDEOFEATURES_FEATURERESULT']._serialized_start=1770
-  _globals['_VIDEOFEATURES_FEATURERESULT']._serialized_end=1877
+  _globals['_VIDEO']._serialized_end=1383
+  _globals['_VIDEO_LABELSENTRY']._serialized_start=1032
+  _globals['_VIDEO_LABELSENTRY']._serialized_end=1077
+  _globals['_VIDEO_VIDEOSTATUS']._serialized_start=1079
+  _globals['_VIDEO_VIDEOSTATUS']._serialized_end=1206
+  _globals['_VIDEO_VISIBILITYSTATUS']._serialized_start=1208
+  _globals['_VIDEO_VISIBILITYSTATUS']._serialized_end=1293
+  _globals['_VIDEOTUSDSOURCE']._serialized_start=1385
+  _globals['_VIDEOTUSDSOURCE']._serialized_end=1434
+  _globals['_VIDEOPUBLICACCESSRIGHTS']._serialized_start=1436
+  _globals['_VIDEOPUBLICACCESSRIGHTS']._serialized_end=1461
+  _globals['_VIDEOSIGNURLACCESSRIGHTS']._serialized_start=1463
+  _globals['_VIDEOSIGNURLACCESSRIGHTS']._serialized_end=1489
+  _globals['_VIDEOFEATURES']._serialized_start=1492
+  _globals['_VIDEOFEATURES']._serialized_end=1902
+  _globals['_VIDEOFEATURES_SUMMARY']._serialized_start=1573
+  _globals['_VIDEOFEATURES_SUMMARY']._serialized_end=1793
+  _globals['_VIDEOFEATURES_SUMMARY_SUMMARYURL']._serialized_start=1723
+  _globals['_VIDEOFEATURES_SUMMARY_SUMMARYURL']._serialized_end=1787
+  _globals['_VIDEOFEATURES_FEATURERESULT']._serialized_start=1795
+  _globals['_VIDEOFEATURES_FEATURERESULT']._serialized_end=1902
 # @@protoc_insertion_point(module_scope)