Merge branch 'main' into fix-google-cloud-documentai

packages/google-ai-generativelanguage/google/ai/generativelanguage_v1beta/types/retriever.py

@@ -88,7 +88,7 @@ class Document(proto.Message):
     Attributes:
         name (str):
             Immutable. Identifier. The ``Document`` resource name. The
-            ID (name excluding the "corpora/*/documents/" prefix) can
+            ID (name excluding the `corpora/*/documents/` prefix) can
             contain up to 40 characters that are lowercase alphanumeric
             or dashes (-). The ID cannot start or end with a dash. If
             the name is empty on create, a unique name will be derived
@@ -315,7 +315,7 @@ class Chunk(proto.Message):
     Attributes:
         name (str):
             Immutable. Identifier. The ``Chunk`` resource name. The ID
-            (name excluding the "corpora/*/documents/*/chunks/" prefix)
+            (name excluding the `corpora/*/documents/*/chunks/` prefix)
             can contain up to 40 characters that are lowercase
             alphanumeric or dashes (-). The ID cannot start or end with
             a dash. If the name is empty on create, a random

packages/google-ai-generativelanguage/google/ai/generativelanguage_v1beta3/services/permission_service/async_client.py

@@ -343,11 +343,11 @@ async def sample_create_permission():
                 role is a superset of the previous
                 role's permitted operations:
 
-                 - reader can use the resource (e.g.
+                - reader can use the resource (e.g.
                   tuned model) for inference
-                 - writer has reader's permissions and
+                - writer has reader's permissions and
                   additionally can edit and share
-                 - owner has writer's permissions and
+                - owner has writer's permissions and
                   additionally can delete
 
         """
@@ -473,11 +473,11 @@ async def sample_get_permission():
                 role is a superset of the previous
                 role's permitted operations:
 
-                 - reader can use the resource (e.g.
+                - reader can use the resource (e.g.
                   tuned model) for inference
-                 - writer has reader's permissions and
+                - writer has reader's permissions and
                   additionally can edit and share
-                 - owner has writer's permissions and
+                - owner has writer's permissions and
                   additionally can delete
 
         """
@@ -729,11 +729,11 @@ async def sample_update_permission():
                 role is a superset of the previous
                 role's permitted operations:
 
-                 - reader can use the resource (e.g.
+                - reader can use the resource (e.g.
                   tuned model) for inference
-                 - writer has reader's permissions and
+                - writer has reader's permissions and
                   additionally can edit and share
-                 - owner has writer's permissions and
+                - owner has writer's permissions and
                   additionally can delete
 
         """

packages/google-ai-generativelanguage/google/ai/generativelanguage_v1beta3/services/permission_service/client.py

@@ -764,11 +764,11 @@ def sample_create_permission():
                 role is a superset of the previous
                 role's permitted operations:
 
-                 - reader can use the resource (e.g.
+                - reader can use the resource (e.g.
                   tuned model) for inference
-                 - writer has reader's permissions and
+                - writer has reader's permissions and
                   additionally can edit and share
-                 - owner has writer's permissions and
+                - owner has writer's permissions and
                   additionally can delete
 
         """
@@ -894,11 +894,11 @@ def sample_get_permission():
                 role is a superset of the previous
                 role's permitted operations:
 
-                 - reader can use the resource (e.g.
+                - reader can use the resource (e.g.
                   tuned model) for inference
-                 - writer has reader's permissions and
+                - writer has reader's permissions and
                   additionally can edit and share
-                 - owner has writer's permissions and
+                - owner has writer's permissions and
                   additionally can delete
 
         """
@@ -1150,11 +1150,11 @@ def sample_update_permission():
                 role is a superset of the previous
                 role's permitted operations:
 
-                 - reader can use the resource (e.g.
+                - reader can use the resource (e.g.
                   tuned model) for inference
-                 - writer has reader's permissions and
+                - writer has reader's permissions and
                   additionally can edit and share
-                 - owner has writer's permissions and
+                - owner has writer's permissions and
                   additionally can delete
 
         """

packages/google-ai-generativelanguage/google/ai/generativelanguage_v1beta3/services/permission_service/transports/rest.py

@@ -395,11 +395,11 @@ def __call__(
                 role is a superset of the previous
                 role's permitted operations:
 
-                 - reader can use the resource (e.g.
+                - reader can use the resource (e.g.
                   tuned model) for inference
-                 - writer has reader's permissions and
+                - writer has reader's permissions and
                   additionally can edit and share
-                 - owner has writer's permissions and
+                - owner has writer's permissions and
                   additionally can delete
 
             """
@@ -588,11 +588,11 @@ def __call__(
                 role is a superset of the previous
                 role's permitted operations:
 
-                 - reader can use the resource (e.g.
+                - reader can use the resource (e.g.
                   tuned model) for inference
-                 - writer has reader's permissions and
+                - writer has reader's permissions and
                   additionally can edit and share
-                 - owner has writer's permissions and
+                - owner has writer's permissions and
                   additionally can delete
 
             """
@@ -882,11 +882,11 @@ def __call__(
                 role is a superset of the previous
                 role's permitted operations:
 
-                 - reader can use the resource (e.g.
+                - reader can use the resource (e.g.
                   tuned model) for inference
-                 - writer has reader's permissions and
+                - writer has reader's permissions and
                   additionally can edit and share
-                 - owner has writer's permissions and
+                - owner has writer's permissions and
                   additionally can delete
 
             """

packages/google-ai-generativelanguage/google/ai/generativelanguage_v1beta3/types/permission.py

@@ -41,10 +41,10 @@ class Permission(proto.Message):
     There are three concentric roles. Each role is a superset of the
     previous role's permitted operations:
 
-     - reader can use the resource (e.g. tuned model) for inference
-     - writer has reader's permissions and additionally can edit and
+    - reader can use the resource (e.g. tuned model) for inference
+    - writer has reader's permissions and additionally can edit and
       share
-     - owner has writer's permissions and additionally can delete
+    - owner has writer's permissions and additionally can delete
 
 
     .. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

packages/google-analytics-admin/google/analytics/admin_v1alpha/services/analytics_admin_service/async_client.py

@@ -10603,7 +10603,7 @@ async def create_calculated_metric(
                 metric's resource name.
 
                 This value should be 1-80 characters and valid
-                characters are /[a-zA-Z0-9_]/, no spaces allowed.
+                characters are `[a-zA-Z0-9_]`, no spaces allowed.
                 calculated_metric_id must be unique between all
                 calculated metrics under a property. The
                 calculated_metric_id is used when referencing this

packages/google-analytics-admin/google/analytics/admin_v1alpha/services/analytics_admin_service/client.py

@@ -11606,7 +11606,7 @@ def create_calculated_metric(
                 metric's resource name.
 
                 This value should be 1-80 characters and valid
-                characters are /[a-zA-Z0-9_]/, no spaces allowed.
+                characters are `[a-zA-Z0-9_]`, no spaces allowed.
                 calculated_metric_id must be unique between all
                 calculated metrics under a property. The
                 calculated_metric_id is used when referencing this

packages/google-analytics-admin/google/analytics/admin_v1alpha/types/analytics_admin.py

@@ -2486,7 +2486,7 @@ class CreateCalculatedMetricRequest(proto.Message):
             resource name.
 
             This value should be 1-80 characters and valid characters
-            are /[a-zA-Z0-9_]/, no spaces allowed. calculated_metric_id
+            are `[a-zA-Z0-9_]`, no spaces allowed. calculated_metric_id
             must be unique between all calculated metrics under a
             property. The calculated_metric_id is used when referencing
             this calculated metric from external APIs, for example,

packages/google-cloud-alloydb/google/cloud/alloydb_v1/types/resources.py

@@ -1283,7 +1283,7 @@ class QueryInsightsInstanceConfig(proto.Message):
             query_string_length (int):
                 Query string length. The default value is
                 1024. Any integer between 256 and 4500 is
-                    considered valid.
+                considered valid.
             query_plans_per_minute (int):
                 Number of query execution plans captured by
                 Insights per minute for all queries combined.

packages/google-cloud-alloydb/google/cloud/alloydb_v1alpha/types/resources.py

@@ -1340,7 +1340,7 @@ class QueryInsightsInstanceConfig(proto.Message):
             query_string_length (int):
                 Query string length. The default value is
                 1024. Any integer between 256 and 4500 is
-                    considered valid.
+                considered valid.
             query_plans_per_minute (int):
                 Number of query execution plans captured by
                 Insights per minute for all queries combined.

packages/google-cloud-alloydb/google/cloud/alloydb_v1beta/types/resources.py

@@ -1292,7 +1292,7 @@ class QueryInsightsInstanceConfig(proto.Message):
             query_string_length (int):
                 Query string length. The default value is
                 1024. Any integer between 256 and 4500 is
-                    considered valid.
+                considered valid.
             query_plans_per_minute (int):
                 Number of query execution plans captured by
                 Insights per minute for all queries combined.

packages/google-cloud-datacatalog/google/cloud/datacatalog_v1beta1/types/usage.py

@@ -37,7 +37,7 @@ class UsageStats(proto.Message):
     - The usage stats only include BigQuery query jobs
     - The usage stats might be underestimated, e.g. wildcard table
       references are not yet counted in usage computation
-    https://cloud.google.com/bigquery/docs/querying-wildcard-tables
+      https://cloud.google.com/bigquery/docs/querying-wildcard-tables
 
     Attributes:
         total_completions (float):

packages/google-cloud-deploy/google/cloud/deploy_v1/types/cloud_deploy.py

@@ -2355,7 +2355,7 @@ class SkaffoldGCSSource(proto.Message):
         Attributes:
             source (str):
                 Required. Cloud Storage source paths to copy recursively.
-                For example, providing "gs://my-bucket/dir/configs/*" will
+                For example, providing `gs://my-bucket/dir/configs/*` will
                 result in Skaffold copying all files within the
                 "dir/configs" directory in the bucket "my-bucket".
             path (str):

packages/google-cloud-dialogflow-cx/google/cloud/dialogflowcx_v3beta1/types/tool.py

@@ -666,12 +666,17 @@ class CACert(proto.Message):
                     certificates. N.B. Make sure the HTTPS server
                     certificates are signed with "subject alt name".
                     For instance a certificate can be self-signed
-                    using the following command,    openssl x509
-                    -req -days 200 -in example.com.csr \
-                    -signkey example.com.key \
-                         -out example.com.crt \
-                         -extfile <(printf
-                    "\nsubjectAltName='DNS:www.example.com'")
+                    using the following command:
+
+                    ::
+
+                        openssl x509
+                        -req -days 200 -in example.com.csr \
+                        -signkey example.com.key \
+                            -out example.com.crt \
+                            -extfile <(printf
+                        "\nsubjectAltName='DNS:www.example.com'")
+
             """
 
             display_name: str = proto.Field(

packages/google-cloud-dms/google/cloud/clouddms_v1/types/conversionworkspace_resources.py

@@ -1102,9 +1102,10 @@ class MultiColumnDatatypeChange(proto.Message):
             if not specified and relevant uses the source
             column precision.
         override_fractional_seconds_precision (int):
-            Optional. Column fractional seconds precision
-            - used only for timestamp based datatypes - if
-              not specified and relevant uses the source
+            Optional. Column fractional seconds precision:
+
+            - used only for timestamp based datatypes
+            - if not specified and relevant uses the source
               column fractional seconds precision.
         custom_features (google.protobuf.struct_pb2.Struct):
             Optional. Custom engine specific features.

packages/google-cloud-edgenetwork/google/cloud/edgenetwork_v1/types/resources.py

@@ -972,7 +972,7 @@ class BgpPeerStatus(proto.Message):
                 Time this session has been up.
                 Format:
 
-                 14 years, 51 weeks, 6 days, 23 hours, 59
+                14 years, 51 weeks, 6 days, 23 hours, 59
                 minutes, 59 seconds
             uptime_seconds (int):
                 Time this session has been up, in seconds.

packages/google-cloud-network-management/google/cloud/network_management_v1/types/connectivity_test.py

@@ -216,7 +216,7 @@ class Endpoint(proto.Message):
             provide forwarding information in the control
             plane. Format:
 
-             projects/{project}/global/forwardingRules/{id}
+            projects/{project}/global/forwardingRules/{id}
             or
             projects/{project}/regions/{region}/forwardingRules/{id}
         forwarding_rule_target (google.cloud.network_management_v1.types.Endpoint.ForwardingRuleTarget):

packages/google-cloud-securitycentermanagement/google/cloud/securitycentermanagement_v1/types/security_center_management.py

@@ -687,10 +687,9 @@ class UpdateSecurityHealthAnalyticsCustomModuleRequest(proto.Message):
             indicates the request is valid while an error
             response indicates the request is invalid. Note
             that a subsequent request to actually update the
-            module could still fail because 1. the state
-            could have changed (e.g. IAM permission lost) or
-            2. A failure occurred while trying to update the
-                module.
+            module could still fail because:
+            1. the state could have changed (e.g. IAM permission lost) or
+            2. A failure occurred while trying to update the module.
     """
 
     update_mask: field_mask_pb2.FieldMask = proto.Field(
@@ -730,10 +729,9 @@ class DeleteSecurityHealthAnalyticsCustomModuleRequest(proto.Message):
             indicates the request is valid while an error
             response indicates the request is invalid. Note
             that a subsequent request to actually delete the
-            module could still fail because 1. the state
-            could have changed (e.g. IAM permission lost) or
-            2. A failure occurred while trying to delete the
-                module.
+            module could still fail because:
+            1. the state could have changed (e.g. IAM permission lost) or
+            2. A failure occurred while trying to delete the module.
     """
 
     name: str = proto.Field(
@@ -1570,10 +1568,9 @@ class CreateEventThreatDetectionCustomModuleRequest(proto.Message):
             indicates the request is valid while an error
             response indicates the request is invalid. Note
             that a subsequent request to actually create the
-            module could still fail because 1. the state
-            could have changed (e.g. IAM permission lost) or
-            2. A failure occurred during creation of the
-                module.
+            module could still fail because:
+            1. the state could have changed (e.g. IAM permission lost) or
+            2. A failure occurred during creation of the module.
     """
 
     parent: str = proto.Field(
@@ -1613,10 +1610,9 @@ class UpdateEventThreatDetectionCustomModuleRequest(proto.Message):
             indicates the request is valid while an error
             response indicates the request is invalid. Note
             that a subsequent request to actually update the
-            module could still fail because 1. the state
-            could have changed (e.g. IAM permission lost) or
-            2. A failure occurred while trying to update the
-                module.
+            module could still fail because:
+            1. the state could have changed (e.g. IAM permission lost) or
+            2. A failure occurred while trying to update the module.
     """
 
     update_mask: field_mask_pb2.FieldMask = proto.Field(
@@ -1656,10 +1652,9 @@ class DeleteEventThreatDetectionCustomModuleRequest(proto.Message):
             indicates the request is valid while an error
             response indicates the request is invalid. Note
             that a subsequent request to actually delete the
-            module could still fail because 1. the state
-            could have changed (e.g. IAM permission lost) or
-            2. A failure occurred while trying to delete the
-                module.
+            module could still fail because:
+            1. the state could have changed (e.g. IAM permission lost) or
+            2. A failure occurred while trying to delete the module.
     """
 
     name: str = proto.Field(