yandexcloud 0.364.0__py3-none-any.whl → 0.367.0__py3-none-any.whl

yandex/cloud/searchapi/v2/wordstat_service_pb2.pyi

@@ -0,0 +1,344 @@
+"""
+@generated by mypy-protobuf.  Do not edit manually!
+isort:skip_file
+"""
+
+import builtins
+import collections.abc
+import google.protobuf.descriptor
+import google.protobuf.internal.containers
+import google.protobuf.internal.enum_type_wrapper
+import google.protobuf.message
+import google.protobuf.timestamp_pb2
+import sys
+import typing
+
+if sys.version_info >= (3, 10):
+    import typing as typing_extensions
+else:
+    import typing_extensions
+
+DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
+
+class _Device:
+    ValueType = typing.NewType("ValueType", builtins.int)
+    V: typing_extensions.TypeAlias = ValueType
+
+class _DeviceEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[_Device.ValueType], builtins.type):
+    DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
+    DEVICE_UNSPECIFIED: _Device.ValueType  # 0
+    DEVICE_ALL: _Device.ValueType  # 1
+    """All devices."""
+    DEVICE_DESKTOP: _Device.ValueType  # 2
+    """Desktop computers."""
+    DEVICE_PHONE: _Device.ValueType  # 3
+    """Phones."""
+    DEVICE_TABLET: _Device.ValueType  # 4
+    """Tablets."""
+
+class Device(_Device, metaclass=_DeviceEnumTypeWrapper): ...
+
+DEVICE_UNSPECIFIED: Device.ValueType  # 0
+DEVICE_ALL: Device.ValueType  # 1
+"""All devices."""
+DEVICE_DESKTOP: Device.ValueType  # 2
+"""Desktop computers."""
+DEVICE_PHONE: Device.ValueType  # 3
+"""Phones."""
+DEVICE_TABLET: Device.ValueType  # 4
+"""Tablets."""
+global___Device = Device
+
+@typing.final
+class GetTopRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    PHRASE_FIELD_NUMBER: builtins.int
+    NUM_PHRASES_FIELD_NUMBER: builtins.int
+    REGIONS_FIELD_NUMBER: builtins.int
+    DEVICES_FIELD_NUMBER: builtins.int
+    FOLDER_ID_FIELD_NUMBER: builtins.int
+    phrase: builtins.str
+    """Keyword"""
+    num_phrases: builtins.int
+    """Number of the phrases in the response."""
+    folder_id: builtins.str
+    """ID of the folder."""
+    @property
+    def regions(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
+        """A list of IDs of the regions a query was made from."""
+
+    @property
+    def devices(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[global___Device.ValueType]:
+        """A list of device types a query was made from."""
+
+    def __init__(
+        self,
+        *,
+        phrase: builtins.str = ...,
+        num_phrases: builtins.int = ...,
+        regions: collections.abc.Iterable[builtins.str] | None = ...,
+        devices: collections.abc.Iterable[global___Device.ValueType] | None = ...,
+        folder_id: builtins.str = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing.Literal["devices", b"devices", "folder_id", b"folder_id", "num_phrases", b"num_phrases", "phrase", b"phrase", "regions", b"regions"]) -> None: ...
+
+global___GetTopRequest = GetTopRequest
+
+@typing.final
+class GetTopResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    @typing.final
+    class PhraseInfo(google.protobuf.message.Message):
+        DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+        PHRASE_FIELD_NUMBER: builtins.int
+        COUNT_FIELD_NUMBER: builtins.int
+        phrase: builtins.str
+        """Keyword."""
+        count: builtins.int
+        """Number of queries made."""
+        def __init__(
+            self,
+            *,
+            phrase: builtins.str = ...,
+            count: builtins.int = ...,
+        ) -> None: ...
+        def ClearField(self, field_name: typing.Literal["count", b"count", "phrase", b"phrase"]) -> None: ...
+
+    TOTAL_COUNT_FIELD_NUMBER: builtins.int
+    RESULTS_FIELD_NUMBER: builtins.int
+    ASSOCIATIONS_FIELD_NUMBER: builtins.int
+    total_count: builtins.int
+    """Total number of the queries that contain all the keywords, regardless of their order."""
+    @property
+    def results(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[global___GetTopResponse.PhraseInfo]:
+        """Results."""
+
+    @property
+    def associations(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[global___GetTopResponse.PhraseInfo]:
+        """Queries that are similar to the specified one."""
+
+    def __init__(
+        self,
+        *,
+        total_count: builtins.int = ...,
+        results: collections.abc.Iterable[global___GetTopResponse.PhraseInfo] | None = ...,
+        associations: collections.abc.Iterable[global___GetTopResponse.PhraseInfo] | None = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing.Literal["associations", b"associations", "results", b"results", "total_count", b"total_count"]) -> None: ...
+
+global___GetTopResponse = GetTopResponse
+
+@typing.final
+class GetDynamicsRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    class _Period:
+        ValueType = typing.NewType("ValueType", builtins.int)
+        V: typing_extensions.TypeAlias = ValueType
+
+    class _PeriodEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[GetDynamicsRequest._Period.ValueType], builtins.type):
+        DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
+        PERIOD_UNSPECIFIED: GetDynamicsRequest._Period.ValueType  # 0
+        PERIOD_MONTHLY: GetDynamicsRequest._Period.ValueType  # 1
+        """Details by month."""
+        PERIOD_WEEKLY: GetDynamicsRequest._Period.ValueType  # 2
+        """Details by week."""
+        PERIOD_DAILY: GetDynamicsRequest._Period.ValueType  # 3
+        """Details by day."""
+
+    class Period(_Period, metaclass=_PeriodEnumTypeWrapper): ...
+    PERIOD_UNSPECIFIED: GetDynamicsRequest.Period.ValueType  # 0
+    PERIOD_MONTHLY: GetDynamicsRequest.Period.ValueType  # 1
+    """Details by month."""
+    PERIOD_WEEKLY: GetDynamicsRequest.Period.ValueType  # 2
+    """Details by week."""
+    PERIOD_DAILY: GetDynamicsRequest.Period.ValueType  # 3
+    """Details by day."""
+
+    PHRASE_FIELD_NUMBER: builtins.int
+    PERIOD_FIELD_NUMBER: builtins.int
+    FROM_DATE_FIELD_NUMBER: builtins.int
+    TO_DATE_FIELD_NUMBER: builtins.int
+    REGIONS_FIELD_NUMBER: builtins.int
+    DEVICES_FIELD_NUMBER: builtins.int
+    FOLDER_ID_FIELD_NUMBER: builtins.int
+    phrase: builtins.str
+    """Keyword."""
+    period: global___GetDynamicsRequest.Period.ValueType
+    """The period of aggregation of the number of queries."""
+    folder_id: builtins.str
+    """ID of the folder."""
+    @property
+    def from_date(self) -> google.protobuf.timestamp_pb2.Timestamp:
+        """The start of the period data is requested for."""
+
+    @property
+    def to_date(self) -> google.protobuf.timestamp_pb2.Timestamp:
+        """The end of the period data is requested for."""
+
+    @property
+    def regions(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[builtins.str]:
+        """A list of IDs of the regions a query was made from."""
+
+    @property
+    def devices(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[global___Device.ValueType]:
+        """A list of device types a query was made from."""
+
+    def __init__(
+        self,
+        *,
+        phrase: builtins.str = ...,
+        period: global___GetDynamicsRequest.Period.ValueType = ...,
+        from_date: google.protobuf.timestamp_pb2.Timestamp | None = ...,
+        to_date: google.protobuf.timestamp_pb2.Timestamp | None = ...,
+        regions: collections.abc.Iterable[builtins.str] | None = ...,
+        devices: collections.abc.Iterable[global___Device.ValueType] | None = ...,
+        folder_id: builtins.str = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["from_date", b"from_date", "to_date", b"to_date"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["devices", b"devices", "folder_id", b"folder_id", "from_date", b"from_date", "period", b"period", "phrase", b"phrase", "regions", b"regions", "to_date", b"to_date"]) -> None: ...
+
+global___GetDynamicsRequest = GetDynamicsRequest
+
+@typing.final
+class GetDynamicsResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    @typing.final
+    class DynamicsInfo(google.protobuf.message.Message):
+        DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+        DATE_FIELD_NUMBER: builtins.int
+        COUNT_FIELD_NUMBER: builtins.int
+        SHARE_FIELD_NUMBER: builtins.int
+        count: builtins.int
+        """Number of queries containing the given keyword"""
+        share: builtins.float
+        """The share of the number of such queries from the total number of queries to Yandex."""
+        @property
+        def date(self) -> google.protobuf.timestamp_pb2.Timestamp:
+            """The date"""
+
+        def __init__(
+            self,
+            *,
+            date: google.protobuf.timestamp_pb2.Timestamp | None = ...,
+            count: builtins.int = ...,
+            share: builtins.float = ...,
+        ) -> None: ...
+        def HasField(self, field_name: typing.Literal["date", b"date"]) -> builtins.bool: ...
+        def ClearField(self, field_name: typing.Literal["count", b"count", "date", b"date", "share", b"share"]) -> None: ...
+
+    RESULTS_FIELD_NUMBER: builtins.int
+    @property
+    def results(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[global___GetDynamicsResponse.DynamicsInfo]:
+        """Results."""
+
+    def __init__(
+        self,
+        *,
+        results: collections.abc.Iterable[global___GetDynamicsResponse.DynamicsInfo] | None = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing.Literal["results", b"results"]) -> None: ...
+
+global___GetDynamicsResponse = GetDynamicsResponse
+
+@typing.final
+class GetRegionsDistributionRequest(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    class _Region:
+        ValueType = typing.NewType("ValueType", builtins.int)
+        V: typing_extensions.TypeAlias = ValueType
+
+    class _RegionEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[GetRegionsDistributionRequest._Region.ValueType], builtins.type):
+        DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
+        REGION_UNSPECIFIED: GetRegionsDistributionRequest._Region.ValueType  # 0
+        REGION_ALL: GetRegionsDistributionRequest._Region.ValueType  # 1
+        """Show distribution everywhere."""
+        REGION_CITIES: GetRegionsDistributionRequest._Region.ValueType  # 2
+        """Show distribution by cities."""
+        REGION_REGIONS: GetRegionsDistributionRequest._Region.ValueType  # 3
+        """Show distribution by regions."""
+
+    class Region(_Region, metaclass=_RegionEnumTypeWrapper): ...
+    REGION_UNSPECIFIED: GetRegionsDistributionRequest.Region.ValueType  # 0
+    REGION_ALL: GetRegionsDistributionRequest.Region.ValueType  # 1
+    """Show distribution everywhere."""
+    REGION_CITIES: GetRegionsDistributionRequest.Region.ValueType  # 2
+    """Show distribution by cities."""
+    REGION_REGIONS: GetRegionsDistributionRequest.Region.ValueType  # 3
+    """Show distribution by regions."""
+
+    PHRASE_FIELD_NUMBER: builtins.int
+    REGION_FIELD_NUMBER: builtins.int
+    DEVICES_FIELD_NUMBER: builtins.int
+    FOLDER_ID_FIELD_NUMBER: builtins.int
+    phrase: builtins.str
+    """Keyword"""
+    region: global___GetRegionsDistributionRequest.Region.ValueType
+    """Show query distribution only by city, only by region, or everywhere."""
+    folder_id: builtins.str
+    """ID of the folder."""
+    @property
+    def devices(self) -> google.protobuf.internal.containers.RepeatedScalarFieldContainer[global___Device.ValueType]:
+        """A list of device types a query was made from."""
+
+    def __init__(
+        self,
+        *,
+        phrase: builtins.str = ...,
+        region: global___GetRegionsDistributionRequest.Region.ValueType = ...,
+        devices: collections.abc.Iterable[global___Device.ValueType] | None = ...,
+        folder_id: builtins.str = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing.Literal["devices", b"devices", "folder_id", b"folder_id", "phrase", b"phrase", "region", b"region"]) -> None: ...
+
+global___GetRegionsDistributionRequest = GetRegionsDistributionRequest
+
+@typing.final
+class GetRegionsDistributionResponse(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    @typing.final
+    class RegionInfo(google.protobuf.message.Message):
+        DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+        REGION_FIELD_NUMBER: builtins.int
+        COUNT_FIELD_NUMBER: builtins.int
+        SHARE_FIELD_NUMBER: builtins.int
+        AFFINITY_INDEX_FIELD_NUMBER: builtins.int
+        region: builtins.str
+        """region ID"""
+        count: builtins.int
+        """Number of queries containing the given keyword."""
+        share: builtins.float
+        """The share of the number of such queries from the total number of queries to Yandex in the region."""
+        affinity_index: builtins.float
+        """The ratio between the share of the selected queries in the region and their share across the country."""
+        def __init__(
+            self,
+            *,
+            region: builtins.str = ...,
+            count: builtins.int = ...,
+            share: builtins.float = ...,
+            affinity_index: builtins.float = ...,
+        ) -> None: ...
+        def ClearField(self, field_name: typing.Literal["affinity_index", b"affinity_index", "count", b"count", "region", b"region", "share", b"share"]) -> None: ...
+
+    RESULTS_FIELD_NUMBER: builtins.int
+    @property
+    def results(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[global___GetRegionsDistributionResponse.RegionInfo]:
+        """Results."""
+
+    def __init__(
+        self,
+        *,
+        results: collections.abc.Iterable[global___GetRegionsDistributionResponse.RegionInfo] | None = ...,
+    ) -> None: ...
+    def ClearField(self, field_name: typing.Literal["results", b"results"]) -> None: ...
+
+global___GetRegionsDistributionResponse = GetRegionsDistributionResponse

yandex/cloud/searchapi/v2/wordstat_service_pb2_grpc.py

@@ -0,0 +1,189 @@
+# Generated by the gRPC Python protocol compiler plugin. DO NOT EDIT!
+"""Client and server classes corresponding to protobuf-defined services."""
+import grpc
+import warnings
+
+from yandex.cloud.searchapi.v2 import wordstat_service_pb2 as yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2
+
+GRPC_GENERATED_VERSION = '1.70.0'
+GRPC_VERSION = grpc.__version__
+_version_not_supported = False
+
+try:
+    from grpc._utilities import first_version_is_lower
+    _version_not_supported = first_version_is_lower(GRPC_VERSION, GRPC_GENERATED_VERSION)
+except ImportError:
+    _version_not_supported = True
+
+if _version_not_supported:
+    raise RuntimeError(
+        f'The grpc package installed is at version {GRPC_VERSION},'
+        + f' but the generated code in yandex/cloud/searchapi/v2/wordstat_service_pb2_grpc.py depends on'
+        + f' grpcio>={GRPC_GENERATED_VERSION}.'
+        + f' Please upgrade your grpc module to grpcio>={GRPC_GENERATED_VERSION}'
+        + f' or downgrade your generated code using grpcio-tools<={GRPC_VERSION}.'
+    )
+
+
+class WordstatServiceStub(object):
+    """A set of methods for viewing statistics on search queries to Yandex.
+    """
+
+    def __init__(self, channel):
+        """Constructor.
+
+        Args:
+            channel: A grpc.Channel.
+        """
+        self.GetTop = channel.unary_unary(
+                '/yandex.cloud.searchapi.v2.WordstatService/GetTop',
+                request_serializer=yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetTopRequest.SerializeToString,
+                response_deserializer=yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetTopResponse.FromString,
+                _registered_method=True)
+        self.GetDynamics = channel.unary_unary(
+                '/yandex.cloud.searchapi.v2.WordstatService/GetDynamics',
+                request_serializer=yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetDynamicsRequest.SerializeToString,
+                response_deserializer=yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetDynamicsResponse.FromString,
+                _registered_method=True)
+        self.GetRegionsDistribution = channel.unary_unary(
+                '/yandex.cloud.searchapi.v2.WordstatService/GetRegionsDistribution',
+                request_serializer=yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetRegionsDistributionRequest.SerializeToString,
+                response_deserializer=yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetRegionsDistributionResponse.FromString,
+                _registered_method=True)
+
+
+class WordstatServiceServicer(object):
+    """A set of methods for viewing statistics on search queries to Yandex.
+    """
+
+    def GetTop(self, request, context):
+        """The method returns the last 30 days data about popular queries containing the specified keyword and queries that are similar to the specified one.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def GetDynamics(self, request, context):
+        """The method returns the frequency of queries over time for a given keyword.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+    def GetRegionsDistribution(self, request, context):
+        """The method returns the distribution of the number of queries containing the given keyword globally by region for the last 30 days.
+        """
+        context.set_code(grpc.StatusCode.UNIMPLEMENTED)
+        context.set_details('Method not implemented!')
+        raise NotImplementedError('Method not implemented!')
+
+
+def add_WordstatServiceServicer_to_server(servicer, server):
+    rpc_method_handlers = {
+            'GetTop': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetTop,
+                    request_deserializer=yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetTopRequest.FromString,
+                    response_serializer=yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetTopResponse.SerializeToString,
+            ),
+            'GetDynamics': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetDynamics,
+                    request_deserializer=yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetDynamicsRequest.FromString,
+                    response_serializer=yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetDynamicsResponse.SerializeToString,
+            ),
+            'GetRegionsDistribution': grpc.unary_unary_rpc_method_handler(
+                    servicer.GetRegionsDistribution,
+                    request_deserializer=yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetRegionsDistributionRequest.FromString,
+                    response_serializer=yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetRegionsDistributionResponse.SerializeToString,
+            ),
+    }
+    generic_handler = grpc.method_handlers_generic_handler(
+            'yandex.cloud.searchapi.v2.WordstatService', rpc_method_handlers)
+    server.add_generic_rpc_handlers((generic_handler,))
+    server.add_registered_method_handlers('yandex.cloud.searchapi.v2.WordstatService', rpc_method_handlers)
+
+
+ # This class is part of an EXPERIMENTAL API.
+class WordstatService(object):
+    """A set of methods for viewing statistics on search queries to Yandex.
+    """
+
+    @staticmethod
+    def GetTop(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/yandex.cloud.searchapi.v2.WordstatService/GetTop',
+            yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetTopRequest.SerializeToString,
+            yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetTopResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def GetDynamics(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/yandex.cloud.searchapi.v2.WordstatService/GetDynamics',
+            yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetDynamicsRequest.SerializeToString,
+            yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetDynamicsResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)
+
+    @staticmethod
+    def GetRegionsDistribution(request,
+            target,
+            options=(),
+            channel_credentials=None,
+            call_credentials=None,
+            insecure=False,
+            compression=None,
+            wait_for_ready=None,
+            timeout=None,
+            metadata=None):
+        return grpc.experimental.unary_unary(
+            request,
+            target,
+            '/yandex.cloud.searchapi.v2.WordstatService/GetRegionsDistribution',
+            yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetRegionsDistributionRequest.SerializeToString,
+            yandex_dot_cloud_dot_searchapi_dot_v2_dot_wordstat__service__pb2.GetRegionsDistributionResponse.FromString,
+            options,
+            channel_credentials,
+            insecure,
+            call_credentials,
+            compression,
+            wait_for_ready,
+            timeout,
+            metadata,
+            _registered_method=True)

yandex/cloud/searchapi/v2/wordstat_service_pb2_grpc.pyi

@@ -0,0 +1,90 @@
+"""
+@generated by mypy-protobuf.  Do not edit manually!
+isort:skip_file
+"""
+
+import abc
+import collections.abc
+import grpc
+import grpc.aio
+import typing
+import yandex.cloud.searchapi.v2.wordstat_service_pb2
+
+_T = typing.TypeVar("_T")
+
+class _MaybeAsyncIterator(collections.abc.AsyncIterator[_T], collections.abc.Iterator[_T], metaclass=abc.ABCMeta): ...
+
+class _ServicerContext(grpc.ServicerContext, grpc.aio.ServicerContext):  # type: ignore[misc, type-arg]
+    ...
+
+class WordstatServiceStub:
+    """A set of methods for viewing statistics on search queries to Yandex."""
+
+    def __init__(self, channel: typing.Union[grpc.Channel, grpc.aio.Channel]) -> None: ...
+    GetTop: grpc.UnaryUnaryMultiCallable[
+        yandex.cloud.searchapi.v2.wordstat_service_pb2.GetTopRequest,
+        yandex.cloud.searchapi.v2.wordstat_service_pb2.GetTopResponse,
+    ]
+    """The method returns the last 30 days data about popular queries containing the specified keyword and queries that are similar to the specified one."""
+
+    GetDynamics: grpc.UnaryUnaryMultiCallable[
+        yandex.cloud.searchapi.v2.wordstat_service_pb2.GetDynamicsRequest,
+        yandex.cloud.searchapi.v2.wordstat_service_pb2.GetDynamicsResponse,
+    ]
+    """The method returns the frequency of queries over time for a given keyword."""
+
+    GetRegionsDistribution: grpc.UnaryUnaryMultiCallable[
+        yandex.cloud.searchapi.v2.wordstat_service_pb2.GetRegionsDistributionRequest,
+        yandex.cloud.searchapi.v2.wordstat_service_pb2.GetRegionsDistributionResponse,
+    ]
+    """The method returns the distribution of the number of queries containing the given keyword globally by region for the last 30 days."""
+
+class WordstatServiceAsyncStub:
+    """A set of methods for viewing statistics on search queries to Yandex."""
+
+    GetTop: grpc.aio.UnaryUnaryMultiCallable[
+        yandex.cloud.searchapi.v2.wordstat_service_pb2.GetTopRequest,
+        yandex.cloud.searchapi.v2.wordstat_service_pb2.GetTopResponse,
+    ]
+    """The method returns the last 30 days data about popular queries containing the specified keyword and queries that are similar to the specified one."""
+
+    GetDynamics: grpc.aio.UnaryUnaryMultiCallable[
+        yandex.cloud.searchapi.v2.wordstat_service_pb2.GetDynamicsRequest,
+        yandex.cloud.searchapi.v2.wordstat_service_pb2.GetDynamicsResponse,
+    ]
+    """The method returns the frequency of queries over time for a given keyword."""
+
+    GetRegionsDistribution: grpc.aio.UnaryUnaryMultiCallable[
+        yandex.cloud.searchapi.v2.wordstat_service_pb2.GetRegionsDistributionRequest,
+        yandex.cloud.searchapi.v2.wordstat_service_pb2.GetRegionsDistributionResponse,
+    ]
+    """The method returns the distribution of the number of queries containing the given keyword globally by region for the last 30 days."""
+
+class WordstatServiceServicer(metaclass=abc.ABCMeta):
+    """A set of methods for viewing statistics on search queries to Yandex."""
+
+    @abc.abstractmethod
+    def GetTop(
+        self,
+        request: yandex.cloud.searchapi.v2.wordstat_service_pb2.GetTopRequest,
+        context: _ServicerContext,
+    ) -> typing.Union[yandex.cloud.searchapi.v2.wordstat_service_pb2.GetTopResponse, collections.abc.Awaitable[yandex.cloud.searchapi.v2.wordstat_service_pb2.GetTopResponse]]:
+        """The method returns the last 30 days data about popular queries containing the specified keyword and queries that are similar to the specified one."""
+
+    @abc.abstractmethod
+    def GetDynamics(
+        self,
+        request: yandex.cloud.searchapi.v2.wordstat_service_pb2.GetDynamicsRequest,
+        context: _ServicerContext,
+    ) -> typing.Union[yandex.cloud.searchapi.v2.wordstat_service_pb2.GetDynamicsResponse, collections.abc.Awaitable[yandex.cloud.searchapi.v2.wordstat_service_pb2.GetDynamicsResponse]]:
+        """The method returns the frequency of queries over time for a given keyword."""
+
+    @abc.abstractmethod
+    def GetRegionsDistribution(
+        self,
+        request: yandex.cloud.searchapi.v2.wordstat_service_pb2.GetRegionsDistributionRequest,
+        context: _ServicerContext,
+    ) -> typing.Union[yandex.cloud.searchapi.v2.wordstat_service_pb2.GetRegionsDistributionResponse, collections.abc.Awaitable[yandex.cloud.searchapi.v2.wordstat_service_pb2.GetRegionsDistributionResponse]]:
+        """The method returns the distribution of the number of queries containing the given keyword globally by region for the last 30 days."""
+
+def add_WordstatServiceServicer_to_server(servicer: WordstatServiceServicer, server: typing.Union[grpc.Server, grpc.aio.Server]) -> None: ...