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

yandex/cloud/video/v1/episode_service_pb2_grpc.py

@@ -29,6 +29,9 @@ if _version_not_supported:
 
 class EpisodeServiceStub(object):
     """Episode management service.
+    Provides methods for creating, retrieving, updating, and deleting episodes,
+    which represent specific time segments of streams
+    that can be individually accessed, managed, and published.
     """
 
     def __init__(self, channel):
@@ -91,73 +94,87 @@ class EpisodeServiceStub(object):
 
 class EpisodeServiceServicer(object):
     """Episode management service.
+    Provides methods for creating, retrieving, updating, and deleting episodes,
+    which represent specific time segments of streams
+    that can be individually accessed, managed, and published.
     """
 
     def Get(self, request, context):
-        """Get the specific channel.
+        """Retrieves detailed information about a specific episode by its ID.
+        Returns all episode metadata, status, 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 episodes for stream or line.
+        """Lists all episodes associated with a specific stream or stream line with pagination support.
+        Results can be filtered and sorted using the provided parameters.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def BatchGet(self, request, context):
-        """Batch get episodes for channel.
+        """Retrieves multiple episodes by their IDs in a specific channel in a single request.
+        This is more efficient than making multiple Get requests when retrieving several episodes.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def Create(self, request, context):
-        """Create episode.
+        """Creates a new episode associated with a stream or stream line.
+        Episodes can be configured with various settings including title, description,
+        time boundaries, and access rights.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def Update(self, request, context):
-        """Update episode.
+        """Updates an existing episode's metadata and settings.
+        Only fields specified in the field_mask will be updated.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def Delete(self, request, context):
-        """Delete episode.
+        """Deletes a specific episode by its ID.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def BatchDelete(self, request, context):
-        """Batch delete episodes.
+        """Deletes multiple episodes associated with a specific stream or stream line in a single request.
+        This is more efficient than making multiple Delete requests when removing several episodes.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def PerformAction(self, request, context):
-        """Perform an action on the episode.
+        """Performs a specific action on an episode, such as publishing or unpublishing.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def GetPlayerURL(self, request, context):
-        """Get player url.
+        """Generates a player URL for watching the episode.
+        The URL can include player parameters such as autoplay, mute, and visibility of interface controls.
+        For episodes with signed URL access, an expiration duration can be specified.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
     def GetManifests(self, request, context):
-        """Get manifest urls.
+        """Retrieves the manifest URLs for the episode's media content.
+        Manifests provide players with necessary information
+        for streaming the content with different quality levels and formats.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
@@ -226,6 +243,9 @@ def add_EpisodeServiceServicer_to_server(servicer, server):
  # This class is part of an EXPERIMENTAL API.
 class EpisodeService(object):
     """Episode management service.
+    Provides methods for creating, retrieving, updating, and deleting episodes,
+    which represent specific time segments of streams
+    that can be individually accessed, managed, and published.
     """
 
     @staticmethod

yandex/cloud/video/v1/episode_service_pb2_grpc.pyi

@@ -20,134 +20,184 @@ class _ServicerContext(grpc.ServicerContext, grpc.aio.ServicerContext):  # type:
     ...
 
 class EpisodeServiceStub:
-    """Episode management service."""
+    """Episode management service.
+    Provides methods for creating, retrieving, updating, and deleting episodes,
+    which represent specific time segments of streams
+    that can be individually accessed, managed, and published.
+    """
 
     def __init__(self, channel: typing.Union[grpc.Channel, grpc.aio.Channel]) -> None: ...
     Get: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.GetEpisodeRequest,
         yandex.cloud.video.v1.episode_pb2.Episode,
     ]
-    """Get the specific channel."""
+    """Retrieves detailed information about a specific episode by its ID.
+    Returns all episode metadata, status, and related information.
+    """
 
     List: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.ListEpisodesRequest,
         yandex.cloud.video.v1.episode_service_pb2.ListEpisodesResponse,
     ]
-    """List episodes for stream or line."""
+    """Lists all episodes associated with a specific stream or stream line with pagination support.
+    Results can be filtered and sorted using the provided parameters.
+    """
 
     BatchGet: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.BatchGetEpisodesRequest,
         yandex.cloud.video.v1.episode_service_pb2.BatchGetEpisodesResponse,
     ]
-    """Batch get episodes for channel."""
+    """Retrieves multiple episodes by their IDs in a specific channel in a single request.
+    This is more efficient than making multiple Get requests when retrieving several episodes.
+    """
 
     Create: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.CreateEpisodeRequest,
         yandex.cloud.operation.operation_pb2.Operation,
     ]
-    """Create episode."""
+    """Creates a new episode associated with a stream or stream line.
+    Episodes can be configured with various settings including title, description,
+    time boundaries, and access rights.
+    """
 
     Update: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.UpdateEpisodeRequest,
         yandex.cloud.operation.operation_pb2.Operation,
     ]
-    """Update episode."""
+    """Updates an existing episode's metadata and settings.
+    Only fields specified in the field_mask will be updated.
+    """
 
     Delete: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.DeleteEpisodeRequest,
         yandex.cloud.operation.operation_pb2.Operation,
     ]
-    """Delete episode."""
+    """Deletes a specific episode by its ID."""
 
     BatchDelete: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.BatchDeleteEpisodesRequest,
         yandex.cloud.operation.operation_pb2.Operation,
     ]
-    """Batch delete episodes."""
+    """Deletes multiple episodes associated with a specific stream or stream line in a single request.
+    This is more efficient than making multiple Delete requests when removing several episodes.
+    """
 
     PerformAction: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.PerformEpisodeActionRequest,
         yandex.cloud.operation.operation_pb2.Operation,
     ]
-    """Perform an action on the episode."""
+    """Performs a specific action on an episode, such as publishing or unpublishing."""
 
     GetPlayerURL: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.GetEpisodePlayerURLRequest,
         yandex.cloud.video.v1.episode_service_pb2.GetEpisodePlayerURLResponse,
     ]
-    """Get player url."""
+    """Generates a player URL for watching the episode.
+    The URL can include player parameters such as autoplay, mute, and visibility of interface controls.
+    For episodes with signed URL access, an expiration duration can be specified.
+    """
 
     GetManifests: grpc.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.GetEpisodeManifestsRequest,
         yandex.cloud.video.v1.episode_service_pb2.GetEpisodeManifestsResponse,
     ]
-    """Get manifest urls."""
+    """Retrieves the manifest URLs for the episode's media content.
+    Manifests provide players with necessary information
+    for streaming the content with different quality levels and formats.
+    """
 
 class EpisodeServiceAsyncStub:
-    """Episode management service."""
+    """Episode management service.
+    Provides methods for creating, retrieving, updating, and deleting episodes,
+    which represent specific time segments of streams
+    that can be individually accessed, managed, and published.
+    """
 
     Get: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.GetEpisodeRequest,
         yandex.cloud.video.v1.episode_pb2.Episode,
     ]
-    """Get the specific channel."""
+    """Retrieves detailed information about a specific episode by its ID.
+    Returns all episode metadata, status, and related information.
+    """
 
     List: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.ListEpisodesRequest,
         yandex.cloud.video.v1.episode_service_pb2.ListEpisodesResponse,
     ]
-    """List episodes for stream or line."""
+    """Lists all episodes associated with a specific stream or stream line with pagination support.
+    Results can be filtered and sorted using the provided parameters.
+    """
 
     BatchGet: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.BatchGetEpisodesRequest,
         yandex.cloud.video.v1.episode_service_pb2.BatchGetEpisodesResponse,
     ]
-    """Batch get episodes for channel."""
+    """Retrieves multiple episodes by their IDs in a specific channel in a single request.
+    This is more efficient than making multiple Get requests when retrieving several episodes.
+    """
 
     Create: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.CreateEpisodeRequest,
         yandex.cloud.operation.operation_pb2.Operation,
     ]
-    """Create episode."""
+    """Creates a new episode associated with a stream or stream line.
+    Episodes can be configured with various settings including title, description,
+    time boundaries, and access rights.
+    """
 
     Update: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.UpdateEpisodeRequest,
         yandex.cloud.operation.operation_pb2.Operation,
     ]
-    """Update episode."""
+    """Updates an existing episode's metadata and settings.
+    Only fields specified in the field_mask will be updated.
+    """
 
     Delete: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.DeleteEpisodeRequest,
         yandex.cloud.operation.operation_pb2.Operation,
     ]
-    """Delete episode."""
+    """Deletes a specific episode by its ID."""
 
     BatchDelete: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.BatchDeleteEpisodesRequest,
         yandex.cloud.operation.operation_pb2.Operation,
     ]
-    """Batch delete episodes."""
+    """Deletes multiple episodes associated with a specific stream or stream line in a single request.
+    This is more efficient than making multiple Delete requests when removing several episodes.
+    """
 
     PerformAction: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.PerformEpisodeActionRequest,
         yandex.cloud.operation.operation_pb2.Operation,
     ]
-    """Perform an action on the episode."""
+    """Performs a specific action on an episode, such as publishing or unpublishing."""
 
     GetPlayerURL: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.GetEpisodePlayerURLRequest,
         yandex.cloud.video.v1.episode_service_pb2.GetEpisodePlayerURLResponse,
     ]
-    """Get player url."""
+    """Generates a player URL for watching the episode.
+    The URL can include player parameters such as autoplay, mute, and visibility of interface controls.
+    For episodes with signed URL access, an expiration duration can be specified.
+    """
 
     GetManifests: grpc.aio.UnaryUnaryMultiCallable[
         yandex.cloud.video.v1.episode_service_pb2.GetEpisodeManifestsRequest,
         yandex.cloud.video.v1.episode_service_pb2.GetEpisodeManifestsResponse,
     ]
-    """Get manifest urls."""
+    """Retrieves the manifest URLs for the episode's media content.
+    Manifests provide players with necessary information
+    for streaming the content with different quality levels and formats.
+    """
 
 class EpisodeServiceServicer(metaclass=abc.ABCMeta):
-    """Episode management service."""
+    """Episode management service.
+    Provides methods for creating, retrieving, updating, and deleting episodes,
+    which represent specific time segments of streams
+    that can be individually accessed, managed, and published.
+    """
 
     @abc.abstractmethod
     def Get(
@@ -155,7 +205,9 @@ class EpisodeServiceServicer(metaclass=abc.ABCMeta):
         request: yandex.cloud.video.v1.episode_service_pb2.GetEpisodeRequest,
         context: _ServicerContext,
     ) -> typing.Union[yandex.cloud.video.v1.episode_pb2.Episode, collections.abc.Awaitable[yandex.cloud.video.v1.episode_pb2.Episode]]:
-        """Get the specific channel."""
+        """Retrieves detailed information about a specific episode by its ID.
+        Returns all episode metadata, status, and related information.
+        """
 
     @abc.abstractmethod
     def List(
@@ -163,7 +215,9 @@ class EpisodeServiceServicer(metaclass=abc.ABCMeta):
         request: yandex.cloud.video.v1.episode_service_pb2.ListEpisodesRequest,
         context: _ServicerContext,
     ) -> typing.Union[yandex.cloud.video.v1.episode_service_pb2.ListEpisodesResponse, collections.abc.Awaitable[yandex.cloud.video.v1.episode_service_pb2.ListEpisodesResponse]]:
-        """List episodes for stream or line."""
+        """Lists all episodes associated with a specific stream or stream line with pagination support.
+        Results can be filtered and sorted using the provided parameters.
+        """
 
     @abc.abstractmethod
     def BatchGet(
@@ -171,7 +225,9 @@ class EpisodeServiceServicer(metaclass=abc.ABCMeta):
         request: yandex.cloud.video.v1.episode_service_pb2.BatchGetEpisodesRequest,
         context: _ServicerContext,
     ) -> typing.Union[yandex.cloud.video.v1.episode_service_pb2.BatchGetEpisodesResponse, collections.abc.Awaitable[yandex.cloud.video.v1.episode_service_pb2.BatchGetEpisodesResponse]]:
-        """Batch get episodes for channel."""
+        """Retrieves multiple episodes by their IDs in a specific channel in a single request.
+        This is more efficient than making multiple Get requests when retrieving several episodes.
+        """
 
     @abc.abstractmethod
     def Create(
@@ -179,7 +235,10 @@ class EpisodeServiceServicer(metaclass=abc.ABCMeta):
         request: yandex.cloud.video.v1.episode_service_pb2.CreateEpisodeRequest,
         context: _ServicerContext,
     ) -> typing.Union[yandex.cloud.operation.operation_pb2.Operation, collections.abc.Awaitable[yandex.cloud.operation.operation_pb2.Operation]]:
-        """Create episode."""
+        """Creates a new episode associated with a stream or stream line.
+        Episodes can be configured with various settings including title, description,
+        time boundaries, and access rights.
+        """
 
     @abc.abstractmethod
     def Update(
@@ -187,7 +246,9 @@ class EpisodeServiceServicer(metaclass=abc.ABCMeta):
         request: yandex.cloud.video.v1.episode_service_pb2.UpdateEpisodeRequest,
         context: _ServicerContext,
     ) -> typing.Union[yandex.cloud.operation.operation_pb2.Operation, collections.abc.Awaitable[yandex.cloud.operation.operation_pb2.Operation]]:
-        """Update episode."""
+        """Updates an existing episode's metadata and settings.
+        Only fields specified in the field_mask will be updated.
+        """
 
     @abc.abstractmethod
     def Delete(
@@ -195,7 +256,7 @@ class EpisodeServiceServicer(metaclass=abc.ABCMeta):
         request: yandex.cloud.video.v1.episode_service_pb2.DeleteEpisodeRequest,
         context: _ServicerContext,
     ) -> typing.Union[yandex.cloud.operation.operation_pb2.Operation, collections.abc.Awaitable[yandex.cloud.operation.operation_pb2.Operation]]:
-        """Delete episode."""
+        """Deletes a specific episode by its ID."""
 
     @abc.abstractmethod
     def BatchDelete(
@@ -203,7 +264,9 @@ class EpisodeServiceServicer(metaclass=abc.ABCMeta):
         request: yandex.cloud.video.v1.episode_service_pb2.BatchDeleteEpisodesRequest,
         context: _ServicerContext,
     ) -> typing.Union[yandex.cloud.operation.operation_pb2.Operation, collections.abc.Awaitable[yandex.cloud.operation.operation_pb2.Operation]]:
-        """Batch delete episodes."""
+        """Deletes multiple episodes associated with a specific stream or stream line in a single request.
+        This is more efficient than making multiple Delete requests when removing several episodes.
+        """
 
     @abc.abstractmethod
     def PerformAction(
@@ -211,7 +274,7 @@ class EpisodeServiceServicer(metaclass=abc.ABCMeta):
         request: yandex.cloud.video.v1.episode_service_pb2.PerformEpisodeActionRequest,
         context: _ServicerContext,
     ) -> typing.Union[yandex.cloud.operation.operation_pb2.Operation, collections.abc.Awaitable[yandex.cloud.operation.operation_pb2.Operation]]:
-        """Perform an action on the episode."""
+        """Performs a specific action on an episode, such as publishing or unpublishing."""
 
     @abc.abstractmethod
     def GetPlayerURL(
@@ -219,7 +282,10 @@ class EpisodeServiceServicer(metaclass=abc.ABCMeta):
         request: yandex.cloud.video.v1.episode_service_pb2.GetEpisodePlayerURLRequest,
         context: _ServicerContext,
     ) -> typing.Union[yandex.cloud.video.v1.episode_service_pb2.GetEpisodePlayerURLResponse, collections.abc.Awaitable[yandex.cloud.video.v1.episode_service_pb2.GetEpisodePlayerURLResponse]]:
-        """Get player url."""
+        """Generates a player URL for watching the episode.
+        The URL can include player parameters such as autoplay, mute, and visibility of interface controls.
+        For episodes with signed URL access, an expiration duration can be specified.
+        """
 
     @abc.abstractmethod
     def GetManifests(
@@ -227,6 +293,9 @@ class EpisodeServiceServicer(metaclass=abc.ABCMeta):
         request: yandex.cloud.video.v1.episode_service_pb2.GetEpisodeManifestsRequest,
         context: _ServicerContext,
     ) -> typing.Union[yandex.cloud.video.v1.episode_service_pb2.GetEpisodeManifestsResponse, collections.abc.Awaitable[yandex.cloud.video.v1.episode_service_pb2.GetEpisodeManifestsResponse]]:
-        """Get manifest urls."""
+        """Retrieves the manifest URLs for the episode's media content.
+        Manifests provide players with necessary information
+        for streaming the content with different quality levels and formats.
+        """
 
 def add_EpisodeServiceServicer_to_server(servicer: EpisodeServiceServicer, server: typing.Union[grpc.Server, grpc.aio.Server]) -> None: ...

yandex/cloud/video/v1/manifest_pb2.pyi

@@ -19,6 +19,11 @@ DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
 
 @typing.final
 class Manifest(google.protobuf.message.Message):
+    """Represents a streaming manifest file that defines how video content is delivered.
+    Manifests contain information about available video qualities, audio tracks,
+    and other metadata needed by video players to stream content efficiently.
+    """
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     class _ManifestType:
@@ -28,18 +33,36 @@ class Manifest(google.protobuf.message.Message):
     class _ManifestTypeEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[Manifest._ManifestType.ValueType], builtins.type):
         DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
         MANIFEST_TYPE_UNSPECIFIED: Manifest._ManifestType.ValueType  # 0
+        """The manifest type is not specified."""
         DASH: Manifest._ManifestType.ValueType  # 1
+        """Dynamic Adaptive Streaming over HTTP (DASH) format.
+        @see https://en.wikipedia.org/wiki/Dynamic_Adaptive_Streaming_over_HTTP
+        """
         HLS: Manifest._ManifestType.ValueType  # 2
+        """HTTP Live Streaming (HLS) format.
+        @see https://en.wikipedia.org/wiki/HTTP_Live_Streaming
+        """
+
+    class ManifestType(_ManifestType, metaclass=_ManifestTypeEnumTypeWrapper):
+        """Manifest format supported by the platform."""
 
-    class ManifestType(_ManifestType, metaclass=_ManifestTypeEnumTypeWrapper): ...
     MANIFEST_TYPE_UNSPECIFIED: Manifest.ManifestType.ValueType  # 0
+    """The manifest type is not specified."""
     DASH: Manifest.ManifestType.ValueType  # 1
+    """Dynamic Adaptive Streaming over HTTP (DASH) format.
+    @see https://en.wikipedia.org/wiki/Dynamic_Adaptive_Streaming_over_HTTP
+    """
     HLS: Manifest.ManifestType.ValueType  # 2
+    """HTTP Live Streaming (HLS) format.
+    @see https://en.wikipedia.org/wiki/HTTP_Live_Streaming
+    """
 
     URL_FIELD_NUMBER: builtins.int
     TYPE_FIELD_NUMBER: builtins.int
     url: builtins.str
+    """URL where the manifest file can be accessed."""
     type: global___Manifest.ManifestType.ValueType
+    """Format of the manifest file."""
     def __init__(
         self,
         *,

yandex/cloud/video/v1/playlist_pb2.py

@@ -26,7 +26,7 @@ from google.protobuf import timestamp_pb2 as google_dot_protobuf_dot_timestamp__
 from yandex.cloud import validation_pb2 as yandex_dot_cloud_dot_validation__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n$yandex/cloud/video/v1/playlist.proto\x12\x15yandex.cloud.video.v1\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1dyandex/cloud/validation.proto\"\xe8\x01\n\x08Playlist\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\x32\n\x05items\x18\x05 \x03(\x0b\x32#.yandex.cloud.video.v1.PlaylistItem\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.TimestampJ\x04\x08\x06\x10\x64\"{\n\x0cPlaylistItem\x12\x1c\n\x08video_id\x18\x64 \x01(\tB\x08\x8a\xc8\x31\x04<=50H\x00\x12\x1e\n\nepisode_id\x18\x65 \x01(\tB\x08\x8a\xc8\x31\x04<=50H\x00\x12\x1b\n\x08position\x18\x01 \x01(\x03\x42\t\xfa\xc7\x31\x05\x30-100B\n\n\x02id\x12\x04\xc0\xc1\x31\x01J\x04\x08\x02\x10\x64\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/playlist.proto\x12\x15yandex.cloud.video.v1\x1a\x1fgoogle/protobuf/timestamp.proto\x1a\x1dyandex/cloud/validation.proto\"\x81\x02\n\x08Playlist\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\x32\n\x05items\x18\x05 \x03(\x0b\x32#.yandex.cloud.video.v1.PlaylistItem\x12\x17\n\x0fstyle_preset_id\x18\x06 \x01(\t\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.TimestampJ\x04\x08\x07\x10\x64\"u\n\x0cPlaylistItem\x12\x1c\n\x08video_id\x18\x64 \x01(\tB\x08\x8a\xc8\x31\x04<=50H\x00\x12\x1e\n\nepisode_id\x18\x65 \x01(\tB\x08\x8a\xc8\x31\x04<=50H\x00\x12\x1b\n\x08position\x18\x01 \x01(\x03\x42\t\xfa\xc7\x31\x05\x30-100B\x04\n\x02idJ\x04\x08\x02\x10\x64\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)
@@ -34,8 +34,6 @@ _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'yandex.cloud.video.v1.playl
 if not _descriptor._USE_C_DESCRIPTORS:
   _globals['DESCRIPTOR']._loaded_options = None
   _globals['DESCRIPTOR']._serialized_options = b'\n\031yandex.cloud.api.video.v1Z?github.com/yandex-cloud/go-genproto/yandex/cloud/video/v1;video'
-  _globals['_PLAYLISTITEM'].oneofs_by_name['id']._loaded_options = None
-  _globals['_PLAYLISTITEM'].oneofs_by_name['id']._serialized_options = b'\300\3011\001'
   _globals['_PLAYLISTITEM'].fields_by_name['video_id']._loaded_options = None
   _globals['_PLAYLISTITEM'].fields_by_name['video_id']._serialized_options = b'\212\3101\004<=50'
   _globals['_PLAYLISTITEM'].fields_by_name['episode_id']._loaded_options = None
@@ -43,7 +41,7 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_PLAYLISTITEM'].fields_by_name['position']._loaded_options = None
   _globals['_PLAYLISTITEM'].fields_by_name['position']._serialized_options = b'\372\3071\0050-100'
   _globals['_PLAYLIST']._serialized_start=128
-  _globals['_PLAYLIST']._serialized_end=360
-  _globals['_PLAYLISTITEM']._serialized_start=362
-  _globals['_PLAYLISTITEM']._serialized_end=485
+  _globals['_PLAYLIST']._serialized_end=385
+  _globals['_PLAYLISTITEM']._serialized_start=387
+  _globals['_PLAYLISTITEM']._serialized_end=504
 # @@protoc_insertion_point(module_scope)

yandex/cloud/video/v1/playlist_pb2.pyi

@@ -15,7 +15,9 @@ DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
 
 @typing.final
 class Playlist(google.protobuf.message.Message):
-    """Entity representing an ordered list of videos or episodes."""
+    """Entity representing an ordered collection of videos or episodes.
+    Playlists allow organizing content into sequences for improved user experience.
+    """
 
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
@@ -24,27 +26,30 @@ class Playlist(google.protobuf.message.Message):
     TITLE_FIELD_NUMBER: builtins.int
     DESCRIPTION_FIELD_NUMBER: builtins.int
     ITEMS_FIELD_NUMBER: builtins.int
+    STYLE_PRESET_ID_FIELD_NUMBER: builtins.int
     CREATED_AT_FIELD_NUMBER: builtins.int
     UPDATED_AT_FIELD_NUMBER: builtins.int
     id: builtins.str
-    """ID of the playlist."""
+    """Unique identifier of the playlist."""
     channel_id: builtins.str
-    """ID of the channel to create the playlist in."""
+    """Identifier of the channel where this playlist is created and managed."""
     title: builtins.str
-    """Playlist title."""
+    """Title of the playlist displayed in interfaces and players."""
     description: builtins.str
-    """Playlist description."""
+    """Detailed description of the playlist's content and purpose."""
+    style_preset_id: builtins.str
+    """Identifier of the style preset used in the player during playlist playback."""
     @property
     def items(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[global___PlaylistItem]:
-        """List of playlist items."""
+        """Ordered list of content items included in this playlist."""
 
     @property
     def created_at(self) -> google.protobuf.timestamp_pb2.Timestamp:
-        """Time when playlist was created."""
+        """Timestamp when the playlist was initially created in the system."""
 
     @property
     def updated_at(self) -> google.protobuf.timestamp_pb2.Timestamp:
-        """Time of last playlist update."""
+        """Timestamp of the last modification to the playlist or its metadata."""
 
     def __init__(
         self,
@@ -54,27 +59,34 @@ class Playlist(google.protobuf.message.Message):
         title: builtins.str = ...,
         description: builtins.str = ...,
         items: collections.abc.Iterable[global___PlaylistItem] | None = ...,
+        style_preset_id: builtins.str = ...,
         created_at: google.protobuf.timestamp_pb2.Timestamp | None = ...,
         updated_at: google.protobuf.timestamp_pb2.Timestamp | None = ...,
     ) -> None: ...
     def HasField(self, field_name: typing.Literal["created_at", b"created_at", "updated_at", b"updated_at"]) -> builtins.bool: ...
-    def ClearField(self, field_name: typing.Literal["channel_id", b"channel_id", "created_at", b"created_at", "description", b"description", "id", b"id", "items", b"items", "title", b"title", "updated_at", b"updated_at"]) -> None: ...
+    def ClearField(self, field_name: typing.Literal["channel_id", b"channel_id", "created_at", b"created_at", "description", b"description", "id", b"id", "items", b"items", "style_preset_id", b"style_preset_id", "title", b"title", "updated_at", b"updated_at"]) -> None: ...
 
 global___Playlist = Playlist
 
 @typing.final
 class PlaylistItem(google.protobuf.message.Message):
+    """Represents a single item in a playlist.
+    Each item references either a video or an episode and specifies its position in the sequence.
+    """
+
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     VIDEO_ID_FIELD_NUMBER: builtins.int
     EPISODE_ID_FIELD_NUMBER: builtins.int
     POSITION_FIELD_NUMBER: builtins.int
     video_id: builtins.str
-    """ID of the video."""
+    """Identifier of a video included in the playlist."""
     episode_id: builtins.str
-    """ID of the episode."""
+    """Identifier of an episode included in the playlist."""
     position: builtins.int
-    """Item position (zero-indexed)."""
+    """Position of this item in the playlist sequence (zero-indexed).
+    Determines the playback order of content in the playlist.
+    """
     def __init__(
         self,
         *,