docs: Fix formatting of request arg in docstring (#527)

* docs: Fix formatting of request arg in docstring

chore: Update gapic-generator-python to v1.9.1
PiperOrigin-RevId: 518604533

Source-Link: googleapis/googleapis@8a085ae

Source-Link: googleapis/googleapis-gen@b2ab4b0
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYjJhYjRiMGEwYWUyOTA3ZTgxMmMyMDkxOThhNzRlMDg5OGFmY2IwNCJ9

* 🦉 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>

Author: gcf-owl-bot[bot]

packages/google-cloud-vision/google/cloud/vision_v1/services/image_annotator/async_client.py

@@ -642,7 +642,8 @@ async def sample_async_batch_annotate_files():
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.AsyncBatchAnnotateFilesRequest, dict]]):
                 The request object. Multiple async file annotation
-                requests are batched into a single service call.
+                requests are batched into a single
+                service call.
             requests (:class:`MutableSequence[google.cloud.vision_v1.types.AsyncAnnotateFileRequest]`):
                 Required. Individual async file
                 annotation requests for this batch.

packages/google-cloud-vision/google/cloud/vision_v1/services/image_annotator/client.py

@@ -874,7 +874,8 @@ def sample_async_batch_annotate_files():
         Args:
             request (Union[google.cloud.vision_v1.types.AsyncBatchAnnotateFilesRequest, dict]):
                 The request object. Multiple async file annotation
-                requests are batched into a single service call.
+                requests are batched into a single
+                service call.
             requests (MutableSequence[google.cloud.vision_v1.types.AsyncAnnotateFileRequest]):
                 Required. Individual async file
                 annotation requests for this batch.

packages/google-cloud-vision/google/cloud/vision_v1/services/image_annotator/transports/rest.py

@@ -382,7 +382,6 @@ def __call__(
                         The request object. Multiple async file annotation
                     requests are batched into a single
                     service call.
-
                     retry (google.api_core.retry.Retry): Designation of what errors, if any,
                         should be retried.
                     timeout (float): The timeout for this request.
@@ -493,7 +492,6 @@ def __call__(
                     request (~.image_annotator.AsyncBatchAnnotateImagesRequest):
                         The request object. Request for async image annotation
                     for a list of images.
-
                     retry (google.api_core.retry.Retry): Designation of what errors, if any,
                         should be retried.
                     timeout (float): The timeout for this request.
@@ -603,7 +601,6 @@ def __call__(
                 request (~.image_annotator.BatchAnnotateFilesRequest):
                     The request object. A list of requests to annotate files
                 using the BatchAnnotateFiles API.
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.
@@ -712,7 +709,6 @@ def __call__(
                 request (~.image_annotator.BatchAnnotateImagesRequest):
                     The request object. Multiple image annotation requests
                 are batched into a single service call.
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.

packages/google-cloud-vision/google/cloud/vision_v1/services/product_search/async_client.py

@@ -292,8 +292,7 @@ async def sample_create_product_set():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.CreateProductSetRequest, dict]]):
-                The request object. Request message for the
-                `CreateProductSet` method.
+                The request object. Request message for the ``CreateProductSet`` method.
             parent (:class:`str`):
                 Required. The project in which the ProductSet should be
                 created.
@@ -433,8 +432,7 @@ async def sample_list_product_sets():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.ListProductSetsRequest, dict]]):
-                The request object. Request message for the
-                `ListProductSets` method.
+                The request object. Request message for the ``ListProductSets`` method.
             parent (:class:`str`):
                 Required. The project from which ProductSets should be
                 listed.
@@ -564,8 +562,7 @@ async def sample_get_product_set():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.GetProductSetRequest, dict]]):
-                The request object. Request message for the
-                `GetProductSet` method.
+                The request object. Request message for the ``GetProductSet`` method.
             name (:class:`str`):
                 Required. Resource name of the ProductSet to get.
 
@@ -691,8 +688,7 @@ async def sample_update_product_set():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.UpdateProductSetRequest, dict]]):
-                The request object. Request message for the
-                `UpdateProductSet` method.
+                The request object. Request message for the ``UpdateProductSet`` method.
             product_set (:class:`google.cloud.vision_v1.types.ProductSet`):
                 Required. The ProductSet resource
                 which replaces the one on the server.
@@ -821,8 +817,7 @@ async def sample_delete_product_set():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.DeleteProductSetRequest, dict]]):
-                The request object. Request message for the
-                `DeleteProductSet` method.
+                The request object. Request message for the ``DeleteProductSet`` method.
             name (:class:`str`):
                 Required. Resource name of the ProductSet to delete.
 
@@ -939,8 +934,7 @@ async def sample_create_product():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.CreateProductRequest, dict]]):
-                The request object. Request message for the
-                `CreateProduct` method.
+                The request object. Request message for the ``CreateProduct`` method.
             parent (:class:`str`):
                 Required. The project in which the Product should be
                 created.
@@ -1075,8 +1069,7 @@ async def sample_list_products():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.ListProductsRequest, dict]]):
-                The request object. Request message for the
-                `ListProducts` method.
+                The request object. Request message for the ``ListProducts`` method.
             parent (:class:`str`):
                 Required. The project OR ProductSet from which Products
                 should be listed.
@@ -1204,8 +1197,7 @@ async def sample_get_product():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.GetProductRequest, dict]]):
-                The request object. Request message for the `GetProduct`
-                method.
+                The request object. Request message for the ``GetProduct`` method.
             name (:class:`str`):
                 Required. Resource name of the Product to get.
 
@@ -1333,8 +1325,7 @@ async def sample_update_product():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.UpdateProductRequest, dict]]):
-                The request object. Request message for the
-                `UpdateProduct` method.
+                The request object. Request message for the ``UpdateProduct`` method.
             product (:class:`google.cloud.vision_v1.types.Product`):
                 Required. The Product resource which
                 replaces the one on the server.
@@ -1462,8 +1453,7 @@ async def sample_delete_product():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.DeleteProductRequest, dict]]):
-                The request object. Request message for the
-                `DeleteProduct` method.
+                The request object. Request message for the ``DeleteProduct`` method.
             name (:class:`str`):
                 Required. Resource name of product to delete.
 
@@ -1596,8 +1586,7 @@ async def sample_create_reference_image():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.CreateReferenceImageRequest, dict]]):
-                The request object. Request message for the
-                `CreateReferenceImage` method.
+                The request object. Request message for the ``CreateReferenceImage`` method.
             parent (:class:`str`):
                 Required. Resource name of the product in which to
                 create the reference image.
@@ -1735,8 +1724,7 @@ async def sample_delete_reference_image():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.DeleteReferenceImageRequest, dict]]):
-                The request object. Request message for the
-                `DeleteReferenceImage` method.
+                The request object. Request message for the ``DeleteReferenceImage`` method.
             name (:class:`str`):
                 Required. The resource name of the reference image to
                 delete.
@@ -1850,8 +1838,7 @@ async def sample_list_reference_images():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.ListReferenceImagesRequest, dict]]):
-                The request object. Request message for the
-                `ListReferenceImages` method.
+                The request object. Request message for the ``ListReferenceImages`` method.
             parent (:class:`str`):
                 Required. Resource name of the product containing the
                 reference images.
@@ -1982,8 +1969,7 @@ async def sample_get_reference_image():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.GetReferenceImageRequest, dict]]):
-                The request object. Request message for the
-                `GetReferenceImage` method.
+                The request object. Request message for the ``GetReferenceImage`` method.
             name (:class:`str`):
                 Required. The resource name of the ReferenceImage to
                 get.
@@ -2106,8 +2092,8 @@ async def sample_add_product_to_product_set():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.AddProductToProductSetRequest, dict]]):
-                The request object. Request message for the
-                `AddProductToProductSet` method.
+                The request object. Request message for the ``AddProductToProductSet``
+                method.
             name (:class:`str`):
                 Required. The resource name for the ProductSet to
                 modify.
@@ -2225,8 +2211,8 @@ async def sample_remove_product_from_product_set():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.RemoveProductFromProductSetRequest, dict]]):
-                The request object. Request message for the
-                `RemoveProductFromProductSet` method.
+                The request object. Request message for the ``RemoveProductFromProductSet``
+                method.
             name (:class:`str`):
                 Required. The resource name for the ProductSet to
                 modify.
@@ -2353,8 +2339,8 @@ async def sample_list_products_in_product_set():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.ListProductsInProductSetRequest, dict]]):
-                The request object. Request message for the
-                `ListProductsInProductSet` method.
+                The request object. Request message for the ``ListProductsInProductSet``
+                method.
             name (:class:`str`):
                 Required. The ProductSet resource for which to retrieve
                 Products.
@@ -2500,8 +2486,7 @@ async def sample_import_product_sets():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.ImportProductSetsRequest, dict]]):
-                The request object. Request message for the
-                `ImportProductSets` method.
+                The request object. Request message for the ``ImportProductSets`` method.
             parent (:class:`str`):
                 Required. The project in which the ProductSets should be
                 imported.
@@ -2669,8 +2654,7 @@ async def sample_purge_products():
 
         Args:
             request (Optional[Union[google.cloud.vision_v1.types.PurgeProductsRequest, dict]]):
-                The request object. Request message for the
-                `PurgeProducts` method.
+                The request object. Request message for the ``PurgeProducts`` method.
             parent (:class:`str`):
                 Required. The project and location in which the Products
                 should be deleted.