docs: Minor formatting (#433)

* docs: Minor formatting
chore: Update gapic-generator-python to v1.11.5
build: Update rules_python to 0.24.0

PiperOrigin-RevId: 563436317

Source-Link: googleapis/googleapis@42fd37b

Source-Link: https://github.com/googleapis/googleapis-gen/commit/280264ca02fb9316b4237a96d0af1a2343a81a56
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMjgwMjY0Y2EwMmZiOTMxNmI0MjM3YTk2ZDBhZjFhMjM0M2E4MWE1NiJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Anthonios Partheniou <[email protected]>

google/cloud/retail_v2/services/catalog_service/async_client.py

@@ -43,7 +43,7 @@
     OptionalRetry = Union[retries.Retry, object]  # type: ignore
 
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import field_mask_pb2  # type: ignore
 from google.protobuf import timestamp_pb2  # type: ignore
 

google/cloud/retail_v2/services/catalog_service/client.py

@@ -47,7 +47,7 @@
     OptionalRetry = Union[retries.Retry, object]  # type: ignore
 
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import field_mask_pb2  # type: ignore
 from google.protobuf import timestamp_pb2  # type: ignore
 

google/cloud/retail_v2/services/catalog_service/transports/base.py

@@ -23,7 +23,7 @@
 import google.auth  # type: ignore
 from google.auth import credentials as ga_credentials  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.oauth2 import service_account  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
 

google/cloud/retail_v2/services/catalog_service/transports/grpc.py

@@ -21,7 +21,7 @@
 from google.auth import credentials as ga_credentials  # type: ignore
 from google.auth.transport.grpc import SslCredentials  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
 import grpc  # type: ignore
 

google/cloud/retail_v2/services/catalog_service/transports/grpc_asyncio.py

@@ -20,7 +20,7 @@
 from google.auth import credentials as ga_credentials  # type: ignore
 from google.auth.transport.grpc import SslCredentials  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
 import grpc  # type: ignore
 from grpc.experimental import aio  # type: ignore

google/cloud/retail_v2/services/catalog_service/transports/rest.py

@@ -27,7 +27,6 @@
 from google.auth.transport.grpc import SslCredentials  # type: ignore
 from google.auth.transport.requests import AuthorizedSession  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
 from google.protobuf import json_format
 import grpc  # type: ignore
 from requests import __version__ as requests_version
@@ -38,6 +37,7 @@
     OptionalRetry = Union[retries.Retry, object]  # type: ignore
 
 
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
 
 from google.cloud.retail_v2.types import catalog

google/cloud/retail_v2/services/completion_service/async_client.py

@@ -45,7 +45,7 @@
 from google.api_core import operation  # type: ignore
 from google.api_core import operation_async  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 
 from google.cloud.retail_v2.types import completion_service, import_config
 
@@ -56,6 +56,7 @@
 
 class CompletionServiceAsyncClient:
     """Autocomplete service for retail.
+
     This feature is only available for users who have Retail Search
     enabled. Enable Retail Search on Cloud Console before using this
     feature.
@@ -315,11 +316,14 @@ async def import_completion_data(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> operation_async.AsyncOperation:
         r"""Bulk import of processed completion dataset.
+
         Request processing is asynchronous. Partial updating is
         not supported.
+
         The operation is successfully finished only after the
         imported suggestions are indexed successfully and ready
         for serving. The process takes hours.
+
         This feature is only available for users who have Retail
         Search enabled. Enable Retail Search on Cloud Console
         before using this feature.

google/cloud/retail_v2/services/completion_service/client.py

@@ -49,7 +49,7 @@
 from google.api_core import operation  # type: ignore
 from google.api_core import operation_async  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 
 from google.cloud.retail_v2.types import completion_service, import_config
 
@@ -98,6 +98,7 @@ def get_transport_class(
 
 class CompletionServiceClient(metaclass=CompletionServiceClientMeta):
     """Autocomplete service for retail.
+
     This feature is only available for users who have Retail Search
     enabled. Enable Retail Search on Cloud Console before using this
     feature.
@@ -545,11 +546,14 @@ def import_completion_data(
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> operation.Operation:
         r"""Bulk import of processed completion dataset.
+
         Request processing is asynchronous. Partial updating is
         not supported.
+
         The operation is successfully finished only after the
         imported suggestions are indexed successfully and ready
         for serving. The process takes hours.
+
         This feature is only available for users who have Retail
         Search enabled. Enable Retail Search on Cloud Console
         before using this feature.

google/cloud/retail_v2/services/completion_service/transports/grpc.py

@@ -33,6 +33,7 @@ class CompletionServiceGrpcTransport(CompletionServiceTransport):
     """gRPC backend transport for CompletionService.
 
     Autocomplete service for retail.
+
     This feature is only available for users who have Retail Search
     enabled. Enable Retail Search on Cloud Console before using this
     feature.
@@ -290,11 +291,14 @@ def import_completion_data(
         r"""Return a callable for the import completion data method over gRPC.
 
         Bulk import of processed completion dataset.
+
         Request processing is asynchronous. Partial updating is
         not supported.
+
         The operation is successfully finished only after the
         imported suggestions are indexed successfully and ready
         for serving. The process takes hours.
+
         This feature is only available for users who have Retail
         Search enabled. Enable Retail Search on Cloud Console
         before using this feature.

google/cloud/retail_v2/services/completion_service/transports/grpc_asyncio.py

@@ -34,6 +34,7 @@ class CompletionServiceGrpcAsyncIOTransport(CompletionServiceTransport):
     """gRPC AsyncIO backend transport for CompletionService.
 
     Autocomplete service for retail.
+
     This feature is only available for users who have Retail Search
     enabled. Enable Retail Search on Cloud Console before using this
     feature.
@@ -295,11 +296,14 @@ def import_completion_data(
         r"""Return a callable for the import completion data method over gRPC.
 
         Bulk import of processed completion dataset.
+
         Request processing is asynchronous. Partial updating is
         not supported.
+
         The operation is successfully finished only after the
         imported suggestions are indexed successfully and ready
         for serving. The process takes hours.
+
         This feature is only available for users who have Retail
         Search enabled. Enable Retail Search on Cloud Console
         before using this feature.

google/cloud/retail_v2/services/completion_service/transports/rest.py

@@ -33,7 +33,6 @@
 from google.auth.transport.grpc import SslCredentials  # type: ignore
 from google.auth.transport.requests import AuthorizedSession  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
 from google.protobuf import json_format
 import grpc  # type: ignore
 from requests import __version__ as requests_version
@@ -199,6 +198,7 @@ class CompletionServiceRestTransport(CompletionServiceTransport):
     """REST backend transport for CompletionService.
 
     Autocomplete service for retail.
+
     This feature is only available for users who have Retail Search
     enabled. Enable Retail Search on Cloud Console before using this
     feature.

google/cloud/retail_v2/services/control_service/async_client.py

@@ -43,7 +43,7 @@
     OptionalRetry = Union[retries.Retry, object]  # type: ignore
 
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import field_mask_pb2  # type: ignore
 
 from google.cloud.retail_v2.services.control_service import pagers
@@ -739,6 +739,7 @@ async def sample_list_controls():
         Returns:
             google.cloud.retail_v2.services.control_service.pagers.ListControlsAsyncPager:
                 Response for ListControls method.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.

google/cloud/retail_v2/services/control_service/client.py

@@ -47,7 +47,7 @@
     OptionalRetry = Union[retries.Retry, object]  # type: ignore
 
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import field_mask_pb2  # type: ignore
 
 from google.cloud.retail_v2.services.control_service import pagers
@@ -990,6 +990,7 @@ def sample_list_controls():
         Returns:
             google.cloud.retail_v2.services.control_service.pagers.ListControlsPager:
                 Response for ListControls method.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.

google/cloud/retail_v2/services/control_service/transports/base.py

@@ -23,7 +23,7 @@
 import google.auth  # type: ignore
 from google.auth import credentials as ga_credentials  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.oauth2 import service_account  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
 

google/cloud/retail_v2/services/control_service/transports/grpc.py

@@ -21,7 +21,7 @@
 from google.auth import credentials as ga_credentials  # type: ignore
 from google.auth.transport.grpc import SslCredentials  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
 import grpc  # type: ignore
 

google/cloud/retail_v2/services/control_service/transports/grpc_asyncio.py

@@ -20,7 +20,7 @@
 from google.auth import credentials as ga_credentials  # type: ignore
 from google.auth.transport.grpc import SslCredentials  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
 import grpc  # type: ignore
 from grpc.experimental import aio  # type: ignore

google/cloud/retail_v2/services/control_service/transports/rest.py

@@ -27,7 +27,6 @@
 from google.auth.transport.grpc import SslCredentials  # type: ignore
 from google.auth.transport.requests import AuthorizedSession  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
 from google.protobuf import json_format
 import grpc  # type: ignore
 from requests import __version__ as requests_version
@@ -38,6 +37,7 @@
     OptionalRetry = Union[retries.Retry, object]  # type: ignore
 
 
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import empty_pb2  # type: ignore
 
 from google.cloud.retail_v2.types import control

google/cloud/retail_v2/services/model_service/async_client.py

@@ -45,7 +45,7 @@
 from google.api_core import operation  # type: ignore
 from google.api_core import operation_async  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import field_mask_pb2  # type: ignore
 from google.protobuf import timestamp_pb2  # type: ignore
 
@@ -836,6 +836,7 @@ async def sample_list_models():
         Returns:
             google.cloud.retail_v2.services.model_service.pagers.ListModelsAsyncPager:
                 Response to a ListModelRequest.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.

google/cloud/retail_v2/services/model_service/client.py

@@ -49,7 +49,7 @@
 from google.api_core import operation  # type: ignore
 from google.api_core import operation_async  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import field_mask_pb2  # type: ignore
 from google.protobuf import timestamp_pb2  # type: ignore
 
@@ -1089,6 +1089,7 @@ def sample_list_models():
         Returns:
             google.cloud.retail_v2.services.model_service.pagers.ListModelsPager:
                 Response to a ListModelRequest.
+
                 Iterating over this object will yield
                 results and resolve additional pages
                 automatically.

google/cloud/retail_v2/services/model_service/transports/rest.py

@@ -33,7 +33,6 @@
 from google.auth.transport.grpc import SslCredentials  # type: ignore
 from google.auth.transport.requests import AuthorizedSession  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
 from google.protobuf import json_format
 import grpc  # type: ignore
 from requests import __version__ as requests_version

google/cloud/retail_v2/services/prediction_service/async_client.py

@@ -43,7 +43,7 @@
     OptionalRetry = Union[retries.Retry, object]  # type: ignore
 
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 
 from google.cloud.retail_v2.types import prediction_service
 

google/cloud/retail_v2/services/prediction_service/client.py

@@ -47,7 +47,7 @@
     OptionalRetry = Union[retries.Retry, object]  # type: ignore
 
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 
 from google.cloud.retail_v2.types import prediction_service
 

google/cloud/retail_v2/services/prediction_service/transports/base.py

@@ -23,7 +23,7 @@
 import google.auth  # type: ignore
 from google.auth import credentials as ga_credentials  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.oauth2 import service_account  # type: ignore
 
 from google.cloud.retail_v2 import gapic_version as package_version

google/cloud/retail_v2/services/prediction_service/transports/grpc.py

@@ -21,7 +21,7 @@
 from google.auth import credentials as ga_credentials  # type: ignore
 from google.auth.transport.grpc import SslCredentials  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 import grpc  # type: ignore
 
 from google.cloud.retail_v2.types import prediction_service

google/cloud/retail_v2/services/prediction_service/transports/grpc_asyncio.py

@@ -20,7 +20,7 @@
 from google.auth import credentials as ga_credentials  # type: ignore
 from google.auth.transport.grpc import SslCredentials  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 import grpc  # type: ignore
 from grpc.experimental import aio  # type: ignore
 

google/cloud/retail_v2/services/prediction_service/transports/rest.py

@@ -27,7 +27,6 @@
 from google.auth.transport.grpc import SslCredentials  # type: ignore
 from google.auth.transport.requests import AuthorizedSession  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
 from google.protobuf import json_format
 import grpc  # type: ignore
 from requests import __version__ as requests_version
@@ -38,6 +37,8 @@
     OptionalRetry = Union[retries.Retry, object]  # type: ignore
 
 
+from google.longrunning import operations_pb2  # type: ignore
+
 from google.cloud.retail_v2.types import prediction_service
 
 from .base import DEFAULT_CLIENT_INFO as BASE_DEFAULT_CLIENT_INFO

google/cloud/retail_v2/services/product_service/async_client.py

@@ -45,7 +45,7 @@
 from google.api_core import operation  # type: ignore
 from google.api_core import operation_async  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import duration_pb2  # type: ignore
 from google.protobuf import field_mask_pb2  # type: ignore
 from google.protobuf import timestamp_pb2  # type: ignore

google/cloud/retail_v2/services/product_service/client.py

@@ -49,7 +49,7 @@
 from google.api_core import operation  # type: ignore
 from google.api_core import operation_async  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
+from google.longrunning import operations_pb2  # type: ignore
 from google.protobuf import duration_pb2  # type: ignore
 from google.protobuf import field_mask_pb2  # type: ignore
 from google.protobuf import timestamp_pb2  # type: ignore

google/cloud/retail_v2/services/product_service/transports/rest.py

@@ -33,7 +33,6 @@
 from google.auth.transport.grpc import SslCredentials  # type: ignore
 from google.auth.transport.requests import AuthorizedSession  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.longrunning import operations_pb2
 from google.protobuf import json_format
 import grpc  # type: ignore
 from requests import __version__ as requests_version