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

* 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>
googleapis · Mar 23, 2023 · 5309392 · 5309392
1 parent b2c6d48
commit 5309392
Show file tree

Hide file tree

Showing 4 changed files with 24 additions and 44 deletions.
diff --git a/packages/google-cloud-billing/google/cloud/billing_v1/services/cloud_billing/async_client.py b/packages/google-cloud-billing/google/cloud/billing_v1/services/cloud_billing/async_client.py
@@ -254,8 +254,7 @@ async def sample_get_billing_account():
 
         Args:
             request (Optional[Union[google.cloud.billing_v1.types.GetBillingAccountRequest, dict]]):
-                The request object. Request message for
-                `GetBillingAccount`.
+                The request object. Request message for ``GetBillingAccount``.
             name (:class:`str`):
                 Required. The resource name of the billing account to
                 retrieve. For example,
@@ -370,8 +369,7 @@ async def sample_list_billing_accounts():
 
         Args:
             request (Optional[Union[google.cloud.billing_v1.types.ListBillingAccountsRequest, dict]]):
-                The request object. Request message for
-                `ListBillingAccounts`.
+                The request object. Request message for ``ListBillingAccounts``.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -474,8 +472,7 @@ async def sample_update_billing_account():
 
         Args:
             request (Optional[Union[google.cloud.billing_v1.types.UpdateBillingAccountRequest, dict]]):
-                The request object. Request message for
-                `UpdateBillingAccount`.
+                The request object. Request message for ``UpdateBillingAccount``.
             name (:class:`str`):
                 Required. The name of the billing
                 account resource to be updated.
@@ -612,8 +609,7 @@ async def sample_create_billing_account():
 
         Args:
             request (Optional[Union[google.cloud.billing_v1.types.CreateBillingAccountRequest, dict]]):
-                The request object. Request message for
-                `CreateBillingAccount`.
+                The request object. Request message for ``CreateBillingAccount``.
             billing_account (:class:`google.cloud.billing_v1.types.BillingAccount`):
                 Required. The billing account
                 resource to create. Currently
@@ -721,8 +717,7 @@ async def sample_list_project_billing_info():
 
         Args:
             request (Optional[Union[google.cloud.billing_v1.types.ListProjectBillingInfoRequest, dict]]):
-                The request object. Request message for
-                `ListProjectBillingInfo`.
+                The request object. Request message for ``ListProjectBillingInfo``.
             name (:class:`str`):
                 Required. The resource name of the billing account
                 associated with the projects that you want to list. For
@@ -852,8 +847,7 @@ async def sample_get_project_billing_info():
 
         Args:
             request (Optional[Union[google.cloud.billing_v1.types.GetProjectBillingInfoRequest, dict]]):
-                The request object. Request message for
-                `GetProjectBillingInfo`.
+                The request object. Request message for ``GetProjectBillingInfo``.
             name (:class:`str`):
                 Required. The resource name of the project for which
                 billing information is retrieved. For example,
@@ -1007,8 +1001,7 @@ async def sample_update_project_billing_info():
 
         Args:
             request (Optional[Union[google.cloud.billing_v1.types.UpdateProjectBillingInfoRequest, dict]]):
-                The request object. Request message for
-                `UpdateProjectBillingInfo`.
+                The request object. Request message for ``UpdateProjectBillingInfo``.
             name (:class:`str`):
                 Required. The resource name of the project associated
                 with the billing information that you want to update.
@@ -1138,8 +1131,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
@@ -1318,8 +1310,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
@@ -1500,8 +1491,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

diff --git a/packages/google-cloud-billing/google/cloud/billing_v1/services/cloud_billing/client.py b/packages/google-cloud-billing/google/cloud/billing_v1/services/cloud_billing/client.py
@@ -465,8 +465,7 @@ def sample_get_billing_account():
 
         Args:
             request (Union[google.cloud.billing_v1.types.GetBillingAccountRequest, dict]):
-                The request object. Request message for
-                `GetBillingAccount`.
+                The request object. Request message for ``GetBillingAccount``.
             name (str):
                 Required. The resource name of the billing account to
                 retrieve. For example,
@@ -571,8 +570,7 @@ def sample_list_billing_accounts():
 
         Args:
             request (Union[google.cloud.billing_v1.types.ListBillingAccountsRequest, dict]):
-                The request object. Request message for
-                `ListBillingAccounts`.
+                The request object. Request message for ``ListBillingAccounts``.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -666,8 +664,7 @@ def sample_update_billing_account():
 
         Args:
             request (Union[google.cloud.billing_v1.types.UpdateBillingAccountRequest, dict]):
-                The request object. Request message for
-                `UpdateBillingAccount`.
+                The request object. Request message for ``UpdateBillingAccount``.
             name (str):
                 Required. The name of the billing
                 account resource to be updated.
@@ -794,8 +791,7 @@ def sample_create_billing_account():
 
         Args:
             request (Union[google.cloud.billing_v1.types.CreateBillingAccountRequest, dict]):
-                The request object. Request message for
-                `CreateBillingAccount`.
+                The request object. Request message for ``CreateBillingAccount``.
             billing_account (google.cloud.billing_v1.types.BillingAccount):
                 Required. The billing account
                 resource to create. Currently
@@ -903,8 +899,7 @@ def sample_list_project_billing_info():
 
         Args:
             request (Union[google.cloud.billing_v1.types.ListProjectBillingInfoRequest, dict]):
-                The request object. Request message for
-                `ListProjectBillingInfo`.
+                The request object. Request message for ``ListProjectBillingInfo``.
             name (str):
                 Required. The resource name of the billing account
                 associated with the projects that you want to list. For
@@ -1026,8 +1021,7 @@ def sample_get_project_billing_info():
 
         Args:
             request (Union[google.cloud.billing_v1.types.GetProjectBillingInfoRequest, dict]):
-                The request object. Request message for
-                `GetProjectBillingInfo`.
+                The request object. Request message for ``GetProjectBillingInfo``.
             name (str):
                 Required. The resource name of the project for which
                 billing information is retrieved. For example,
@@ -1171,8 +1165,7 @@ def sample_update_project_billing_info():
 
         Args:
             request (Union[google.cloud.billing_v1.types.UpdateProjectBillingInfoRequest, dict]):
-                The request object. Request message for
-                `UpdateProjectBillingInfo`.
+                The request object. Request message for ``UpdateProjectBillingInfo``.
             name (str):
                 Required. The resource name of the project associated
                 with the billing information that you want to update.
@@ -1294,8 +1287,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
@@ -1461,8 +1453,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
@@ -1630,8 +1621,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

diff --git a/packages/google-cloud-billing/google/cloud/billing_v1/services/cloud_catalog/async_client.py b/packages/google-cloud-billing/google/cloud/billing_v1/services/cloud_catalog/async_client.py
@@ -253,7 +253,7 @@ async def sample_list_services():
 
         Args:
             request (Optional[Union[google.cloud.billing_v1.types.ListServicesRequest, dict]]):
-                The request object. Request message for `ListServices`.
+                The request object. Request message for ``ListServices``.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -340,7 +340,7 @@ async def sample_list_skus():
 
         Args:
             request (Optional[Union[google.cloud.billing_v1.types.ListSkusRequest, dict]]):
-                The request object. Request message for `ListSkus`.
+                The request object. Request message for ``ListSkus``.
             parent (:class:`str`):
                 Required. The name of the service.
                 Example: "services/DA34-426B-A397"

diff --git a/packages/google-cloud-billing/google/cloud/billing_v1/services/cloud_catalog/client.py b/packages/google-cloud-billing/google/cloud/billing_v1/services/cloud_catalog/client.py
@@ -492,7 +492,7 @@ def sample_list_services():
 
         Args:
             request (Union[google.cloud.billing_v1.types.ListServicesRequest, dict]):
-                The request object. Request message for `ListServices`.
+                The request object. Request message for ``ListServices``.
             retry (google.api_core.retry.Retry): Designation of what errors, if any,
                 should be retried.
             timeout (float): The timeout for this request.
@@ -580,7 +580,7 @@ def sample_list_skus():
 
         Args:
             request (Union[google.cloud.billing_v1.types.ListSkusRequest, dict]):
-                The request object. Request message for `ListSkus`.
+                The request object. Request message for ``ListSkus``.
             parent (str):
                 Required. The name of the service.
                 Example: "services/DA34-426B-A397"