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

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

google/cloud/spanner_admin_database_v1/services/database_admin/async_client.py

@@ -688,19 +688,19 @@ async def sample_update_database_ddl():
 
         Args:
             request (Optional[Union[google.cloud.spanner_admin_database_v1.types.UpdateDatabaseDdlRequest, dict]]):
-                The request object. Enqueues the given DDL statements to
-                be applied, in order but not necessarily all at once, to
-                the database schema at some point (or points) in the
-                future. The server checks that the statements are
-                executable (syntactically valid, name tables that exist,
-                etc.) before enqueueing them, but they may still fail
-                upon
+                The request object. Enqueues the given DDL statements to be applied, in
+                order but not necessarily all at once, to the database
+                schema at some point (or points) in the future. The
+                server checks that the statements are executable
+                (syntactically valid, name tables that exist, etc.)
+                before enqueueing them, but they may still fail upon
                 later execution (e.g., if a statement from another batch
                 of statements is applied first and it conflicts in some
                 way, or if there is some data-related problem like a
-                `NULL` value in a column to which `NOT NULL` would be
-                added). If a statement fails, all subsequent statements
-                in the batch are automatically cancelled.
+                ``NULL`` value in a column to which ``NOT NULL`` would
+                be added). If a statement fails, all subsequent
+                statements in the batch are automatically cancelled.
+
                 Each batch of statements is assigned a name which can be
                 used with the
                 [Operations][google.longrunning.Operations] API to
@@ -1072,8 +1072,7 @@ async def sample_set_iam_policy():
 
         Args:
             request (Optional[Union[google.iam.v1.iam_policy_pb2.SetIamPolicyRequest, dict]]):
-                The request object. Request message for `SetIamPolicy`
-                method.
+                The request object. Request message for ``SetIamPolicy`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
                 policy is being specified. See the
@@ -1247,8 +1246,7 @@ async def sample_get_iam_policy():
 
         Args:
             request (Optional[Union[google.iam.v1.iam_policy_pb2.GetIamPolicyRequest, dict]]):
-                The request object. Request message for `GetIamPolicy`
-                method.
+                The request object. Request message for ``GetIamPolicy`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
                 policy is being requested. See the
@@ -1434,8 +1432,7 @@ async def sample_test_iam_permissions():
 
         Args:
             request (Optional[Union[google.iam.v1.iam_policy_pb2.TestIamPermissionsRequest, dict]]):
-                The request object. Request message for
-                `TestIamPermissions` method.
+                The request object. Request message for ``TestIamPermissions`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
                 policy detail is being requested. See

google/cloud/spanner_admin_database_v1/services/database_admin/client.py

@@ -994,19 +994,19 @@ def sample_update_database_ddl():
 
         Args:
             request (Union[google.cloud.spanner_admin_database_v1.types.UpdateDatabaseDdlRequest, dict]):
-                The request object. Enqueues the given DDL statements to
-                be applied, in order but not necessarily all at once, to
-                the database schema at some point (or points) in the
-                future. The server checks that the statements are
-                executable (syntactically valid, name tables that exist,
-                etc.) before enqueueing them, but they may still fail
-                upon
+                The request object. Enqueues the given DDL statements to be applied, in
+                order but not necessarily all at once, to the database
+                schema at some point (or points) in the future. The
+                server checks that the statements are executable
+                (syntactically valid, name tables that exist, etc.)
+                before enqueueing them, but they may still fail upon
                 later execution (e.g., if a statement from another batch
                 of statements is applied first and it conflicts in some
                 way, or if there is some data-related problem like a
-                `NULL` value in a column to which `NOT NULL` would be
-                added). If a statement fails, all subsequent statements
-                in the batch are automatically cancelled.
+                ``NULL`` value in a column to which ``NOT NULL`` would
+                be added). If a statement fails, all subsequent
+                statements in the batch are automatically cancelled.
+
                 Each batch of statements is assigned a name which can be
                 used with the
                 [Operations][google.longrunning.Operations] API to
@@ -1348,8 +1348,7 @@ def sample_set_iam_policy():
 
         Args:
             request (Union[google.iam.v1.iam_policy_pb2.SetIamPolicyRequest, dict]):
-                The request object. Request message for `SetIamPolicy`
-                method.
+                The request object. Request message for ``SetIamPolicy`` method.
             resource (str):
                 REQUIRED: The resource for which the
                 policy is being specified. See the
@@ -1520,8 +1519,7 @@ def sample_get_iam_policy():
 
         Args:
             request (Union[google.iam.v1.iam_policy_pb2.GetIamPolicyRequest, dict]):
-                The request object. Request message for `GetIamPolicy`
-                method.
+                The request object. Request message for ``GetIamPolicy`` method.
             resource (str):
                 REQUIRED: The resource for which the
                 policy is being requested. See the
@@ -1694,8 +1692,7 @@ def sample_test_iam_permissions():
 
         Args:
             request (Union[google.iam.v1.iam_policy_pb2.TestIamPermissionsRequest, dict]):
-                The request object. Request message for
-                `TestIamPermissions` method.
+                The request object. Request message for ``TestIamPermissions`` method.
             resource (str):
                 REQUIRED: The resource for which the
                 policy detail is being requested. See

google/cloud/spanner_admin_database_v1/services/database_admin/transports/rest.py

@@ -955,7 +955,6 @@ def __call__(
                 request (~.backup.CopyBackupRequest):
                     The request object. The request for
                 [CopyBackup][google.spanner.admin.database.v1.DatabaseAdmin.CopyBackup].
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.
@@ -1055,7 +1054,6 @@ def __call__(
                 request (~.gsad_backup.CreateBackupRequest):
                     The request object. The request for
                 [CreateBackup][google.spanner.admin.database.v1.DatabaseAdmin.CreateBackup].
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.
@@ -1153,7 +1151,6 @@ def __call__(
                 request (~.spanner_database_admin.CreateDatabaseRequest):
                     The request object. The request for
                 [CreateDatabase][google.spanner.admin.database.v1.DatabaseAdmin.CreateDatabase].
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.
@@ -1251,7 +1248,6 @@ def __call__(
                 request (~.backup.DeleteBackupRequest):
                     The request object. The request for
                 [DeleteBackup][google.spanner.admin.database.v1.DatabaseAdmin.DeleteBackup].
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.
@@ -1327,7 +1323,6 @@ def __call__(
                 request (~.spanner_database_admin.DropDatabaseRequest):
                     The request object. The request for
                 [DropDatabase][google.spanner.admin.database.v1.DatabaseAdmin.DropDatabase].
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.
@@ -1403,7 +1398,6 @@ def __call__(
                 request (~.backup.GetBackupRequest):
                     The request object. The request for
                 [GetBackup][google.spanner.admin.database.v1.DatabaseAdmin.GetBackup].
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.
@@ -1491,7 +1485,6 @@ def __call__(
                 request (~.spanner_database_admin.GetDatabaseRequest):
                     The request object. The request for
                 [GetDatabase][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabase].
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.
@@ -1579,7 +1572,6 @@ def __call__(
                 request (~.spanner_database_admin.GetDatabaseDdlRequest):
                     The request object. The request for
                 [GetDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.GetDatabaseDdl].
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.
@@ -1846,7 +1838,6 @@ def __call__(
                 request (~.backup.ListBackupOperationsRequest):
                     The request object. The request for
                 [ListBackupOperations][google.spanner.admin.database.v1.DatabaseAdmin.ListBackupOperations].
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.
@@ -1938,7 +1929,6 @@ def __call__(
                 request (~.backup.ListBackupsRequest):
                     The request object. The request for
                 [ListBackups][google.spanner.admin.database.v1.DatabaseAdmin.ListBackups].
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.
@@ -2028,7 +2018,6 @@ def __call__(
                 request (~.spanner_database_admin.ListDatabaseOperationsRequest):
                     The request object. The request for
                 [ListDatabaseOperations][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseOperations].
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.
@@ -2122,7 +2111,6 @@ def __call__(
                 request (~.spanner_database_admin.ListDatabaseRolesRequest):
                     The request object. The request for
                 [ListDatabaseRoles][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabaseRoles].
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.
@@ -2214,7 +2202,6 @@ def __call__(
                 request (~.spanner_database_admin.ListDatabasesRequest):
                     The request object. The request for
                 [ListDatabases][google.spanner.admin.database.v1.DatabaseAdmin.ListDatabases].
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.
@@ -2304,7 +2291,6 @@ def __call__(
                 request (~.spanner_database_admin.RestoreDatabaseRequest):
                     The request object. The request for
                 [RestoreDatabase][google.spanner.admin.database.v1.DatabaseAdmin.RestoreDatabase].
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.
@@ -2688,7 +2674,6 @@ def __call__(
                 request (~.gsad_backup.UpdateBackupRequest):
                     The request object. The request for
                 [UpdateBackup][google.spanner.admin.database.v1.DatabaseAdmin.UpdateBackup].
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.
@@ -2802,7 +2787,6 @@ def __call__(
                 monitor progress. See the
                 [operation_id][google.spanner.admin.database.v1.UpdateDatabaseDdlRequest.operation_id]
                 field for more details.
-
                 retry (google.api_core.retry.Retry): Designation of what errors, if any,
                     should be retried.
                 timeout (float): The timeout for this request.

google/cloud/spanner_admin_instance_v1/services/instance_admin/async_client.py

@@ -1876,8 +1876,7 @@ async def sample_set_iam_policy():
 
         Args:
             request (Optional[Union[google.iam.v1.iam_policy_pb2.SetIamPolicyRequest, dict]]):
-                The request object. Request message for `SetIamPolicy`
-                method.
+                The request object. Request message for ``SetIamPolicy`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
                 policy is being specified. See the
@@ -2047,8 +2046,7 @@ async def sample_get_iam_policy():
 
         Args:
             request (Optional[Union[google.iam.v1.iam_policy_pb2.GetIamPolicyRequest, dict]]):
-                The request object. Request message for `GetIamPolicy`
-                method.
+                The request object. Request message for ``GetIamPolicy`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
                 policy is being requested. See the
@@ -2231,8 +2229,7 @@ async def sample_test_iam_permissions():
 
         Args:
             request (Optional[Union[google.iam.v1.iam_policy_pb2.TestIamPermissionsRequest, dict]]):
-                The request object. Request message for
-                `TestIamPermissions` method.
+                The request object. Request message for ``TestIamPermissions`` method.
             resource (:class:`str`):
                 REQUIRED: The resource for which the
                 policy detail is being requested. See

google/cloud/spanner_admin_instance_v1/services/instance_admin/client.py

@@ -2070,8 +2070,7 @@ def sample_set_iam_policy():
 
         Args:
             request (Union[google.iam.v1.iam_policy_pb2.SetIamPolicyRequest, dict]):
-                The request object. Request message for `SetIamPolicy`
-                method.
+                The request object. Request message for ``SetIamPolicy`` method.
             resource (str):
                 REQUIRED: The resource for which the
                 policy is being specified. See the
@@ -2238,8 +2237,7 @@ def sample_get_iam_policy():
 
         Args:
             request (Union[google.iam.v1.iam_policy_pb2.GetIamPolicyRequest, dict]):
-                The request object. Request message for `GetIamPolicy`
-                method.
+                The request object. Request message for ``GetIamPolicy`` method.
             resource (str):
                 REQUIRED: The resource for which the
                 policy is being requested. See the
@@ -2409,8 +2407,7 @@ def sample_test_iam_permissions():
 
         Args:
             request (Union[google.iam.v1.iam_policy_pb2.TestIamPermissionsRequest, dict]):
-                The request object. Request message for
-                `TestIamPermissions` method.
+                The request object. Request message for ``TestIamPermissions`` method.
             resource (str):
                 REQUIRED: The resource for which the
                 policy detail is being requested. See