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

* 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: https://github.com/googleapis/googleapis-gen/commit/b2ab4b0a0ae2907e812c209198a74e0898afcb04
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/websecurityscanner_v1/services/web_security_scanner/async_client.py

@@ -270,8 +270,7 @@ async def sample_create_scan_config():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1.types.CreateScanConfigRequest, dict]]):
-                The request object. Request for the `CreateScanConfig`
-                method.
+                The request object. Request for the ``CreateScanConfig`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -349,8 +348,7 @@ async def sample_delete_scan_config():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1.types.DeleteScanConfigRequest, dict]]):
-                The request object. Request for the `DeleteScanConfig`
-                method.
+                The request object. Request for the ``DeleteScanConfig`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -431,8 +429,7 @@ async def sample_get_scan_config():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1.types.GetScanConfigRequest, dict]]):
-                The request object. Request for the `GetScanConfig`
-                method.
+                The request object. Request for the ``GetScanConfig`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -523,8 +520,7 @@ async def sample_list_scan_configs():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1.types.ListScanConfigsRequest, dict]]):
-                The request object. Request for the `ListScanConfigs`
-                method.
+                The request object. Request for the ``ListScanConfigs`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -626,8 +622,7 @@ async def sample_update_scan_config():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1.types.UpdateScanConfigRequest, dict]]):
-                The request object. Request for the
-                `UpdateScanConfigRequest` method.
+                The request object. Request for the ``UpdateScanConfigRequest`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -707,8 +702,7 @@ async def sample_start_scan_run():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1.types.StartScanRunRequest, dict]]):
-                The request object. Request for the `StartScanRun`
-                method.
+                The request object. Request for the ``StartScanRun`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -787,7 +781,7 @@ async def sample_get_scan_run():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1.types.GetScanRunRequest, dict]]):
-                The request object. Request for the `GetScanRun` method.
+                The request object. Request for the ``GetScanRun`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -878,8 +872,7 @@ async def sample_list_scan_runs():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1.types.ListScanRunsRequest, dict]]):
-                The request object. Request for the `ListScanRuns`
-                method.
+                The request object. Request for the ``ListScanRuns`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -978,8 +971,7 @@ async def sample_stop_scan_run():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1.types.StopScanRunRequest, dict]]):
-                The request object. Request for the `StopScanRun`
-                method.
+                The request object. Request for the ``StopScanRun`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -1061,8 +1053,7 @@ async def sample_list_crawled_urls():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1.types.ListCrawledUrlsRequest, dict]]):
-                The request object. Request for the `ListCrawledUrls`
-                method.
+                The request object. Request for the ``ListCrawledUrls`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -1161,7 +1152,7 @@ async def sample_get_finding():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1.types.GetFindingRequest, dict]]):
-                The request object. Request for the `GetFinding` method.
+                The request object. Request for the ``GetFinding`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -1251,8 +1242,7 @@ async def sample_list_findings():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1.types.ListFindingsRequest, dict]]):
-                The request object. Request for the `ListFindings`
-                method.
+                The request object. Request for the ``ListFindings`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -1353,8 +1343,7 @@ async def sample_list_finding_type_stats():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1.types.ListFindingTypeStatsRequest, dict]]):
-                The request object. Request for the
-                `ListFindingTypeStats` method.
+                The request object. Request for the ``ListFindingTypeStats`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.

google/cloud/websecurityscanner_v1/services/web_security_scanner/client.py

@@ -500,8 +500,7 @@ def sample_create_scan_config():
 
         Args:
             request (Union[google.cloud.websecurityscanner_v1.types.CreateScanConfigRequest, dict]):
-                The request object. Request for the `CreateScanConfig`
-                method.
+                The request object. Request for the ``CreateScanConfig`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -580,8 +579,7 @@ def sample_delete_scan_config():
 
         Args:
             request (Union[google.cloud.websecurityscanner_v1.types.DeleteScanConfigRequest, dict]):
-                The request object. Request for the `DeleteScanConfig`
-                method.
+                The request object. Request for the ``DeleteScanConfig`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -653,8 +651,7 @@ def sample_get_scan_config():
 
         Args:
             request (Union[google.cloud.websecurityscanner_v1.types.GetScanConfigRequest, dict]):
-                The request object. Request for the `GetScanConfig`
-                method.
+                The request object. Request for the ``GetScanConfig`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -736,8 +733,7 @@ def sample_list_scan_configs():
 
         Args:
             request (Union[google.cloud.websecurityscanner_v1.types.ListScanConfigsRequest, dict]):
-                The request object. Request for the `ListScanConfigs`
-                method.
+                The request object. Request for the ``ListScanConfigs`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -830,8 +826,7 @@ def sample_update_scan_config():
 
         Args:
             request (Union[google.cloud.websecurityscanner_v1.types.UpdateScanConfigRequest, dict]):
-                The request object. Request for the
-                `UpdateScanConfigRequest` method.
+                The request object. Request for the ``UpdateScanConfigRequest`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -912,8 +907,7 @@ def sample_start_scan_run():
 
         Args:
             request (Union[google.cloud.websecurityscanner_v1.types.StartScanRunRequest, dict]):
-                The request object. Request for the `StartScanRun`
-                method.
+                The request object. Request for the ``StartScanRun`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -993,7 +987,7 @@ def sample_get_scan_run():
 
         Args:
             request (Union[google.cloud.websecurityscanner_v1.types.GetScanRunRequest, dict]):
-                The request object. Request for the `GetScanRun` method.
+                The request object. Request for the ``GetScanRun`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -1075,8 +1069,7 @@ def sample_list_scan_runs():
 
         Args:
             request (Union[google.cloud.websecurityscanner_v1.types.ListScanRunsRequest, dict]):
-                The request object. Request for the `ListScanRuns`
-                method.
+                The request object. Request for the ``ListScanRuns`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -1166,8 +1159,7 @@ def sample_stop_scan_run():
 
         Args:
             request (Union[google.cloud.websecurityscanner_v1.types.StopScanRunRequest, dict]):
-                The request object. Request for the `StopScanRun`
-                method.
+                The request object. Request for the ``StopScanRun`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -1250,8 +1242,7 @@ def sample_list_crawled_urls():
 
         Args:
             request (Union[google.cloud.websecurityscanner_v1.types.ListCrawledUrlsRequest, dict]):
-                The request object. Request for the `ListCrawledUrls`
-                method.
+                The request object. Request for the ``ListCrawledUrls`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -1341,7 +1332,7 @@ def sample_get_finding():
 
         Args:
             request (Union[google.cloud.websecurityscanner_v1.types.GetFindingRequest, dict]):
-                The request object. Request for the `GetFinding` method.
+                The request object. Request for the ``GetFinding`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -1422,8 +1413,7 @@ def sample_list_findings():
 
         Args:
             request (Union[google.cloud.websecurityscanner_v1.types.ListFindingsRequest, dict]):
-                The request object. Request for the `ListFindings`
-                method.
+                The request object. Request for the ``ListFindings`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -1515,8 +1505,7 @@ def sample_list_finding_type_stats():
 
         Args:
             request (Union[google.cloud.websecurityscanner_v1.types.ListFindingTypeStatsRequest, dict]):
-                The request object. Request for the
-                `ListFindingTypeStats` method.
+                The request object. Request for the ``ListFindingTypeStats`` method.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.

google/cloud/websecurityscanner_v1alpha/services/web_security_scanner/async_client.py

@@ -283,8 +283,7 @@ async def sample_create_scan_config():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1alpha.types.CreateScanConfigRequest, dict]]):
-                The request object. Request for the `CreateScanConfig`
-                method.
+                The request object. Request for the ``CreateScanConfig`` method.
             parent (:class:`str`):
                 Required. The parent resource name
                 where the scan is created, which should
@@ -397,8 +396,7 @@ async def sample_delete_scan_config():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1alpha.types.DeleteScanConfigRequest, dict]]):
-                The request object. Request for the `DeleteScanConfig`
-                method.
+                The request object. Request for the ``DeleteScanConfig`` method.
             name (:class:`str`):
                 Required. The resource name of the
                 ScanConfig to be deleted. The name
@@ -504,8 +502,7 @@ async def sample_get_scan_config():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1alpha.types.GetScanConfigRequest, dict]]):
-                The request object. Request for the `GetScanConfig`
-                method.
+                The request object. Request for the ``GetScanConfig`` method.
             name (:class:`str`):
                 Required. The resource name of the
                 ScanConfig to be returned. The name
@@ -622,8 +619,7 @@ async def sample_list_scan_configs():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1alpha.types.ListScanConfigsRequest, dict]]):
-                The request object. Request for the `ListScanConfigs`
-                method.
+                The request object. Request for the ``ListScanConfigs`` method.
             parent (:class:`str`):
                 Required. The parent resource name,
                 which should be a project resource name
@@ -754,8 +750,7 @@ async def sample_update_scan_config():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1alpha.types.UpdateScanConfigRequest, dict]]):
-                The request object. Request for the
-                `UpdateScanConfigRequest` method.
+                The request object. Request for the ``UpdateScanConfigRequest`` method.
             scan_config (:class:`google.cloud.websecurityscanner_v1alpha.types.ScanConfig`):
                 Required. The ScanConfig to be
                 updated. The name field must be set to
@@ -872,8 +867,7 @@ async def sample_start_scan_run():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1alpha.types.StartScanRunRequest, dict]]):
-                The request object. Request for the `StartScanRun`
-                method.
+                The request object. Request for the ``StartScanRun`` method.
             name (:class:`str`):
                 Required. The resource name of the
                 ScanConfig to be used. The name follows
@@ -976,7 +970,7 @@ async def sample_get_scan_run():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1alpha.types.GetScanRunRequest, dict]]):
-                The request object. Request for the `GetScanRun` method.
+                The request object. Request for the ``GetScanRun`` method.
             name (:class:`str`):
                 Required. The resource name of the
                 ScanRun to be returned. The name follows
@@ -1091,8 +1085,7 @@ async def sample_list_scan_runs():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1alpha.types.ListScanRunsRequest, dict]]):
-                The request object. Request for the `ListScanRuns`
-                method.
+                The request object. Request for the ``ListScanRuns`` method.
             parent (:class:`str`):
                 Required. The parent resource name,
                 which should be a scan resource name in
@@ -1216,8 +1209,7 @@ async def sample_stop_scan_run():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1alpha.types.StopScanRunRequest, dict]]):
-                The request object. Request for the `StopScanRun`
-                method.
+                The request object. Request for the ``StopScanRun`` method.
             name (:class:`str`):
                 Required. The resource name of the
                 ScanRun to be stopped. The name follows
@@ -1323,8 +1315,7 @@ async def sample_list_crawled_urls():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1alpha.types.ListCrawledUrlsRequest, dict]]):
-                The request object. Request for the `ListCrawledUrls`
-                method.
+                The request object. Request for the ``ListCrawledUrls`` method.
             parent (:class:`str`):
                 Required. The parent resource name,
                 which should be a scan run resource name
@@ -1448,7 +1439,7 @@ async def sample_get_finding():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1alpha.types.GetFindingRequest, dict]]):
-                The request object. Request for the `GetFinding` method.
+                The request object. Request for the ``GetFinding`` method.
             name (:class:`str`):
                 Required. The resource name of the
                 Finding to be returned. The name follows
@@ -1565,8 +1556,7 @@ async def sample_list_findings():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1alpha.types.ListFindingsRequest, dict]]):
-                The request object. Request for the `ListFindings`
-                method.
+                The request object. Request for the ``ListFindings`` method.
             parent (:class:`str`):
                 Required. The parent resource name,
                 which should be a scan run resource name
@@ -1702,8 +1692,7 @@ async def sample_list_finding_type_stats():
 
         Args:
             request (Optional[Union[google.cloud.websecurityscanner_v1alpha.types.ListFindingTypeStatsRequest, dict]]):
-                The request object. Request for the
-                `ListFindingTypeStats` method.
+                The request object. Request for the ``ListFindingTypeStats`` method.
             parent (:class:`str`):
                 Required. The parent resource name,
                 which should be a scan run resource name