Date: Tue, 17 Sep 2024 07:08:03 +0000 Subject: [PATCH 02/32] feat(aiplatform): update the api #### aiplatform:v1 The following keys were added: - schemas.GoogleCloudAiplatformV1CreateNotebookExecutionJobRequest (Total Keys: 5) - schemas.GoogleCloudAiplatformV1Schedule.properties.createNotebookExecutionJobRequest.$ref (Total Keys: 1) #### aiplatform:v1beta1 The following keys were added: - resources.projects.resources.locations.methods.augmentPrompt (Total Keys: 12) - resources.projects.resources.locations.methods.corroborateContent (Total Keys: 12) - schemas.GoogleCloudAiplatformV1beta1AugmentPromptRequest (Total Keys: 10) - schemas.GoogleCloudAiplatformV1beta1AugmentPromptResponse (Total Keys: 6) - schemas.GoogleCloudAiplatformV1beta1Claim (Total Keys: 11) - schemas.GoogleCloudAiplatformV1beta1CorroborateContentRequest (Total Keys: 10) - schemas.GoogleCloudAiplatformV1beta1CorroborateContentResponse (Total Keys: 6) - schemas.GoogleCloudAiplatformV1beta1Fact (Total Keys: 7) --- ...tform_v1.projects.locations.schedules.html | 258 ++++++++++++++++++ ...aiplatform_v1beta1.projects.locations.html | 205 ++++++++++++++ .../documents/aiplatform.v1.json | 25 +- .../documents/aiplatform.v1beta1.json | 227 ++++++++++++++- 4 files changed, 713 insertions(+), 2 deletions(-) diff --git a/docs/dyn/aiplatform_v1.projects.locations.schedules.html b/docs/dyn/aiplatform_v1.projects.locations.schedules.html index 35fcf434cda..88f89bf6a34 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.schedules.html +++ b/docs/dyn/aiplatform_v1.projects.locations.schedules.html @@ -124,6 +124,49 @@

Method Details

{ # An instance of a Schedule periodically schedules runs to make API calls based on user specified time specification and API request type. "allowQueueing": True or False, # Optional. Whether new scheduled runs can be queued when max_concurrent_runs limit is reached. If set to true, new runs will be queued instead of skipped. Default to false. "catchUp": True or False, # Output only. Whether to backfill missed runs when the schedule is resumed from PAUSED state. If set to true, all missed runs will be scheduled. New runs will be scheduled after the backfill is complete. Default to false. + "createNotebookExecutionJobRequest": { # Request message for [NotebookService.CreateNotebookExecutionJob] # Request for NotebookService.CreateNotebookExecutionJob. + "notebookExecutionJob": { # NotebookExecutionJob represents an instance of a notebook execution. # Required. The NotebookExecutionJob to create. + "createTime": "A String", # Output only. Timestamp when this NotebookExecutionJob was created. + "dataformRepositorySource": { # The Dataform Repository containing the input notebook. # The Dataform Repository pointing to a single file notebook repository. + "commitSha": "A String", # The commit SHA to read repository with. If unset, the file will be read at HEAD. + "dataformRepositoryResourceName": "A String", # The resource name of the Dataform Repository. Format: `projects/{project_id}/locations/{location}/repositories/{repository_id}` + }, + "directNotebookSource": { # The content of the input notebook in ipynb format. # The contents of an input notebook file. + "content": "A String", # The base64-encoded contents of the input notebook file. + }, + "displayName": "A String", # The display name of the NotebookExecutionJob. The name can be up to 128 characters long and can consist of any UTF-8 characters. + "encryptionSpec": { # Represents a customer-managed encryption key spec that can be applied to a top-level resource. # Customer-managed encryption key spec for the notebook execution job. This field is auto-populated if the NotebookService.NotebookRuntimeTemplate has an encryption spec. + "kmsKeyName": "A String", # Required. The Cloud KMS resource identifier of the customer managed encryption key used to protect a resource. Has the form: `projects/my-project/locations/my-region/keyRings/my-kr/cryptoKeys/my-key`. The key needs to be in the same region as where the compute resource is created. + }, + "executionTimeout": "A String", # Max running time of the execution job in seconds (default 86400s / 24 hrs). + "executionUser": "A String", # The user email to run the execution as. Only supported by Colab runtimes. + "gcsNotebookSource": { # The Cloud Storage uri for the input notebook. # The Cloud Storage url pointing to the ipynb file. Format: `gs://bucket/notebook_file.ipynb` + "generation": "A String", # The version of the Cloud Storage object to read. If unset, the current version of the object is read. See https://cloud.google.com/storage/docs/metadata#generation-number. + "uri": "A String", # The Cloud Storage uri pointing to the ipynb file. Format: `gs://bucket/notebook_file.ipynb` + }, + "gcsOutputUri": "A String", # The Cloud Storage location to upload the result to. Format: `gs://bucket-name` + "jobState": "A String", # Output only. The state of the NotebookExecutionJob. + "labels": { # The labels with user-defined metadata to organize NotebookExecutionJobs. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels. System reserved label keys are prefixed with "aiplatform.googleapis.com/" and are immutable. + "a_key": "A String", + }, + "name": "A String", # Output only. The resource name of this NotebookExecutionJob. Format: `projects/{project_id}/locations/{location}/notebookExecutionJobs/{job_id}` + "notebookRuntimeTemplateResourceName": "A String", # The NotebookRuntimeTemplate to source compute configuration from. + "scheduleResourceName": "A String", # Output only. The Schedule resource name if this job is triggered by one. Format: `projects/{project_id}/locations/{location}/schedules/{schedule_id}` + "serviceAccount": "A String", # The service account to run the execution as. + "status": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. Populated when the NotebookExecutionJob is completed. When there is an error during notebook execution, the error details are populated. + "code": 42, # The status code, which should be an enum value of google.rpc.Code. + "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use. + { + "a_key": "", # Properties of the object. Contains field @type with type URL. + }, + ], + "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client. + }, + "updateTime": "A String", # Output only. Timestamp when this NotebookExecutionJob was most recently updated. + }, + "notebookExecutionJobId": "A String", # Optional. User specified ID for the NotebookExecutionJob. + "parent": "A String", # Required. The resource name of the Location to create the NotebookExecutionJob. Format: `projects/{project}/locations/{location}` + }, "createPipelineJobRequest": { # Request message for PipelineService.CreatePipelineJob. # Request for PipelineService.CreatePipelineJob. CreatePipelineJobRequest.parent field is required (format: projects/{project}/locations/{location}). "parent": "A String", # Required. The resource name of the Location to create the PipelineJob in. Format: `projects/{project}/locations/{location}` "pipelineJob": { # An instance of a machine learning PipelineJob. # Required. The PipelineJob to create. @@ -374,6 +417,49 @@

Method Details

Instance Methods

Returns the tuningJobs Resource.

+ augmentPrompt(parent, body=None, x__xgafv=None)

Given an input prompt, it returns augmented prompt from vertex rag store to guide LLM towards generating grounded responses.

close()

Close httplib2 connections.

+ corroborateContent(parent, body=None, x__xgafv=None)

Given an input text, it returns a score that evaluates the factuality of the text. It also extracts and returns claims from the text and provides supporting facts.

evaluateInstances(location, body=None, x__xgafv=None)

Evaluates instances based on a given metric.

@@ -303,11 +309,210 @@

Instance Methods

retrieveContexts(parent, body=None, x__xgafv=None)

Retrieves relevant contexts for a query.

Method Details

+ augmentPrompt(parent, body=None, x__xgafv=None) +

Given an input prompt, it returns augmented prompt from vertex rag store to guide LLM towards generating grounded responses.
+
+Args:
+  parent: string, Required. The resource name of the Location from which to augment prompt. The users must have permission to make a call in the project. Format: `projects/{project}/locations/{location}`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for AugmentPrompt.
+  "contents": [ # Optional. Input content to augment, only text format is supported for now.
+    { # The base structured datatype containing multi-part content of a message. A `Content` includes a `role` field designating the producer of the `Content` and a `parts` field containing multi-part data that contains the content of the message turn.
+      "parts": [ # Required. Ordered `Parts` that constitute a single message. Parts may have different IANA MIME types.
+        { # A datatype containing media that is part of a multi-part `Content` message. A `Part` consists of data which has an associated datatype. A `Part` can only contain one of the accepted types in `Part.data`. A `Part` must have a fixed IANA MIME type identifying the type and subtype of the media if `inline_data` or `file_data` field is filled with raw bytes.
+          "fileData": { # URI based data. # Optional. URI based data.
+            "fileUri": "A String", # Required. URI.
+            "mimeType": "A String", # Required. The IANA standard MIME type of the source data.
+          },
+          "functionCall": { # A predicted [FunctionCall] returned from the model that contains a string representing the [FunctionDeclaration.name] and a structured JSON object containing the parameters and their values. # Optional. A predicted [FunctionCall] returned from the model that contains a string representing the [FunctionDeclaration.name] with the parameters and their values.
+            "args": { # Optional. Required. The function parameters and values in JSON object format. See [FunctionDeclaration.parameters] for parameter details.
+              "a_key": "", # Properties of the object.
+            },
+            "name": "A String", # Required. The name of the function to call. Matches [FunctionDeclaration.name].
+          },
+          "functionResponse": { # The result output from a [FunctionCall] that contains a string representing the [FunctionDeclaration.name] and a structured JSON object containing any output from the function is used as context to the model. This should contain the result of a [FunctionCall] made based on model prediction. # Optional. The result output of a [FunctionCall] that contains a string representing the [FunctionDeclaration.name] and a structured JSON object containing any output from the function call. It is used as context to the model.
+            "name": "A String", # Required. The name of the function to call. Matches [FunctionDeclaration.name] and [FunctionCall.name].
+            "response": { # Required. The function response in JSON object format. Use "output" key to specify function output and "error" key to specify error details (if any). If "output" and "error" keys are not specified, then whole "response" is treated as function output.
+              "a_key": "", # Properties of the object.
+            },
+          },
+          "inlineData": { # Content blob. It's preferred to send as text directly rather than raw bytes. # Optional. Inlined bytes data.
+            "data": "A String", # Required. Raw bytes.
+            "mimeType": "A String", # Required. The IANA standard MIME type of the source data.
+          },
+          "text": "A String", # Optional. Text part (can be code).
+          "videoMetadata": { # Metadata describes the input video content. # Optional. Video metadata. The metadata should only be specified while the video data is presented in inline_data or file_data.
+            "endOffset": "A String", # Optional. The end offset of the video.
+            "startOffset": "A String", # Optional. The start offset of the video.
+          },
+        },
+      ],
+      "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. Useful to set for multi-turn conversations, otherwise can be left blank or unset.
+    },
+  ],
+  "model": { # Metadata of the backend deployed model. # Optional. Metadata of the backend deployed model.
+    "model": "A String", # Optional. The model that the user will send the augmented prompt for content generation.
+    "modelVersion": "A String", # Optional. The model version of the backend deployed model.
+  },
+  "vertexRagStore": { # Retrieve from Vertex RAG Store for grounding. # Optional. Retrieves contexts from the Vertex RagStore.
+    "ragCorpora": [ # Optional. Deprecated. Please use rag_resources instead.
+      "A String",
+    ],
+    "ragResources": [ # Optional. The representation of the rag source. It can be used to specify corpus only or ragfiles. Currently only support one corpus or multiple files from one corpus. In the future we may open up multiple corpora support.
+      { # The definition of the Rag resource.
+        "ragCorpus": "A String", # Optional. RagCorpora resource name. Format: `projects/{project}/locations/{location}/ragCorpora/{rag_corpus}`
+        "ragFileIds": [ # Optional. rag_file_id. The files should be in the same rag_corpus set in rag_corpus field.
+          "A String",
+        ],
+      },
+    ],
+    "similarityTopK": 42, # Optional. Number of top k results to return from the selected corpora.
+    "vectorDistanceThreshold": 3.14, # Optional. Only return results with vector distance smaller than the threshold.
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for AugmentPrompt.
+  "augmentedPrompt": [ # Augmented prompt, only text format is supported for now.
+    { # The base structured datatype containing multi-part content of a message. A `Content` includes a `role` field designating the producer of the `Content` and a `parts` field containing multi-part data that contains the content of the message turn.
+      "parts": [ # Required. Ordered `Parts` that constitute a single message. Parts may have different IANA MIME types.
+        { # A datatype containing media that is part of a multi-part `Content` message. A `Part` consists of data which has an associated datatype. A `Part` can only contain one of the accepted types in `Part.data`. A `Part` must have a fixed IANA MIME type identifying the type and subtype of the media if `inline_data` or `file_data` field is filled with raw bytes.
+          "fileData": { # URI based data. # Optional. URI based data.
+            "fileUri": "A String", # Required. URI.
+            "mimeType": "A String", # Required. The IANA standard MIME type of the source data.
+          },
+          "functionCall": { # A predicted [FunctionCall] returned from the model that contains a string representing the [FunctionDeclaration.name] and a structured JSON object containing the parameters and their values. # Optional. A predicted [FunctionCall] returned from the model that contains a string representing the [FunctionDeclaration.name] with the parameters and their values.
+            "args": { # Optional. Required. The function parameters and values in JSON object format. See [FunctionDeclaration.parameters] for parameter details.
+              "a_key": "", # Properties of the object.
+            },
+            "name": "A String", # Required. The name of the function to call. Matches [FunctionDeclaration.name].
+          },
+          "functionResponse": { # The result output from a [FunctionCall] that contains a string representing the [FunctionDeclaration.name] and a structured JSON object containing any output from the function is used as context to the model. This should contain the result of a [FunctionCall] made based on model prediction. # Optional. The result output of a [FunctionCall] that contains a string representing the [FunctionDeclaration.name] and a structured JSON object containing any output from the function call. It is used as context to the model.
+            "name": "A String", # Required. The name of the function to call. Matches [FunctionDeclaration.name] and [FunctionCall.name].
+            "response": { # Required. The function response in JSON object format. Use "output" key to specify function output and "error" key to specify error details (if any). If "output" and "error" keys are not specified, then whole "response" is treated as function output.
+              "a_key": "", # Properties of the object.
+            },
+          },
+          "inlineData": { # Content blob. It's preferred to send as text directly rather than raw bytes. # Optional. Inlined bytes data.
+            "data": "A String", # Required. Raw bytes.
+            "mimeType": "A String", # Required. The IANA standard MIME type of the source data.
+          },
+          "text": "A String", # Optional. Text part (can be code).
+          "videoMetadata": { # Metadata describes the input video content. # Optional. Video metadata. The metadata should only be specified while the video data is presented in inline_data or file_data.
+            "endOffset": "A String", # Optional. The end offset of the video.
+            "startOffset": "A String", # Optional. The start offset of the video.
+          },
+        },
+      ],
+      "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. Useful to set for multi-turn conversations, otherwise can be left blank or unset.
+    },
+  ],
+  "facts": [ # Retrieved facts from RAG data sources.
+    { # The fact used in grounding.
+      "query": "A String", # Query that is used to retrieve this fact.
+      "summary": "A String", # If present, the summary/snippet of the fact.
+      "title": "A String", # If present, it refers to the title of this fact.
+      "uri": "A String", # If present, this uri links to the source of the fact.
+      "vectorDistance": 3.14, # If present, the distance between the query vector and this fact vector.
+    },
+  ],
+}

close()

Close httplib2 connections.

+ corroborateContent(parent, body=None, x__xgafv=None) +

Given an input text, it returns a score that evaluates the factuality of the text. It also extracts and returns claims from the text and provides supporting facts.
+
+Args:
+  parent: string, Required. The resource name of the Location from which to corroborate text. The users must have permission to make a call in the project. Format: `projects/{project}/locations/{location}`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for CorroborateContent.
+  "content": { # The base structured datatype containing multi-part content of a message. A `Content` includes a `role` field designating the producer of the `Content` and a `parts` field containing multi-part data that contains the content of the message turn. # Optional. Input content to corroborate, only text format is supported for now.
+    "parts": [ # Required. Ordered `Parts` that constitute a single message. Parts may have different IANA MIME types.
+      { # A datatype containing media that is part of a multi-part `Content` message. A `Part` consists of data which has an associated datatype. A `Part` can only contain one of the accepted types in `Part.data`. A `Part` must have a fixed IANA MIME type identifying the type and subtype of the media if `inline_data` or `file_data` field is filled with raw bytes.
+        "fileData": { # URI based data. # Optional. URI based data.
+          "fileUri": "A String", # Required. URI.
+          "mimeType": "A String", # Required. The IANA standard MIME type of the source data.
+        },
+        "functionCall": { # A predicted [FunctionCall] returned from the model that contains a string representing the [FunctionDeclaration.name] and a structured JSON object containing the parameters and their values. # Optional. A predicted [FunctionCall] returned from the model that contains a string representing the [FunctionDeclaration.name] with the parameters and their values.
+          "args": { # Optional. Required. The function parameters and values in JSON object format. See [FunctionDeclaration.parameters] for parameter details.
+            "a_key": "", # Properties of the object.
+          },
+          "name": "A String", # Required. The name of the function to call. Matches [FunctionDeclaration.name].
+        },
+        "functionResponse": { # The result output from a [FunctionCall] that contains a string representing the [FunctionDeclaration.name] and a structured JSON object containing any output from the function is used as context to the model. This should contain the result of a [FunctionCall] made based on model prediction. # Optional. The result output of a [FunctionCall] that contains a string representing the [FunctionDeclaration.name] and a structured JSON object containing any output from the function call. It is used as context to the model.
+          "name": "A String", # Required. The name of the function to call. Matches [FunctionDeclaration.name] and [FunctionCall.name].
+          "response": { # Required. The function response in JSON object format. Use "output" key to specify function output and "error" key to specify error details (if any). If "output" and "error" keys are not specified, then whole "response" is treated as function output.
+            "a_key": "", # Properties of the object.
+          },
+        },
+        "inlineData": { # Content blob. It's preferred to send as text directly rather than raw bytes. # Optional. Inlined bytes data.
+          "data": "A String", # Required. Raw bytes.
+          "mimeType": "A String", # Required. The IANA standard MIME type of the source data.
+        },
+        "text": "A String", # Optional. Text part (can be code).
+        "videoMetadata": { # Metadata describes the input video content. # Optional. Video metadata. The metadata should only be specified while the video data is presented in inline_data or file_data.
+          "endOffset": "A String", # Optional. The end offset of the video.
+          "startOffset": "A String", # Optional. The start offset of the video.
+        },
+      },
+    ],
+    "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. Useful to set for multi-turn conversations, otherwise can be left blank or unset.
+  },
+  "facts": [ # Optional. Facts used to generate the text can also be used to corroborate the text.
+    { # The fact used in grounding.
+      "query": "A String", # Query that is used to retrieve this fact.
+      "summary": "A String", # If present, the summary/snippet of the fact.
+      "title": "A String", # If present, it refers to the title of this fact.
+      "uri": "A String", # If present, this uri links to the source of the fact.
+      "vectorDistance": 3.14, # If present, the distance between the query vector and this fact vector.
+    },
+  ],
+  "parameters": { # Parameters that can be overrided per request. # Optional. Parameters that can be set to override default settings per request.
+    "citationThreshold": 3.14, # Optional. Only return claims with citation score larger than the threshold.
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for CorroborateContent.
+  "claims": [ # Claims that are extracted from the input content and facts that support the claims.
+    { # Claim that is extracted from the input text and facts that support it.
+      "endIndex": 42, # Index in the input text where the claim ends (exclusive).
+      "factIndexes": [ # Indexes of the facts supporting this claim.
+        42,
+      ],
+      "score": 3.14, # Confidence score of this corroboration.
+      "startIndex": 42, # Index in the input text where the claim starts (inclusive).
+    },
+  ],
+  "corroborationScore": 3.14, # Confidence score of corroborating content. Value is [0,1] with 1 is the most confidence.
+}

evaluateInstances(location, body=None, x__xgafv=None)

Evaluates instances based on a given metric.
diff --git a/googleapiclient/discovery_cache/documents/aiplatform.v1.json b/googleapiclient/discovery_cache/documents/aiplatform.v1.json
index e0ef73e0f99..ad18835a4e1 100644
--- a/googleapiclient/discovery_cache/documents/aiplatform.v1.json
+++ b/googleapiclient/discovery_cache/documents/aiplatform.v1.json
@@ -17760,7 +17760,7 @@
 }
 }
 },
-"revision": "20240828",
+"revision": "20240830",
 "rootUrl": "https://aiplatform.googleapis.com/",
 "schemas": {
 "CloudAiLargeModelsVisionGenerateVideoResponse": {
@@ -20082,6 +20082,25 @@
 },
 "type": "object"
 },
+"GoogleCloudAiplatformV1CreateNotebookExecutionJobRequest": {
+"description": "Request message for [NotebookService.CreateNotebookExecutionJob]",
+"id": "GoogleCloudAiplatformV1CreateNotebookExecutionJobRequest",
+"properties": {
+"notebookExecutionJob": {
+"$ref": "GoogleCloudAiplatformV1NotebookExecutionJob",
+"description": "Required. The NotebookExecutionJob to create."
+},
+"notebookExecutionJobId": {
+"description": "Optional. User specified ID for the NotebookExecutionJob.",
+"type": "string"
+},
+"parent": {
+"description": "Required. The resource name of the Location to create the NotebookExecutionJob. Format: `projects/{project}/locations/{location}`",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudAiplatformV1CreateNotebookRuntimeTemplateOperationMetadata": {
 "description": "Metadata information for NotebookService.CreateNotebookRuntimeTemplate.",
 "id": "GoogleCloudAiplatformV1CreateNotebookRuntimeTemplateOperationMetadata",
@@ -32502,6 +32521,10 @@ false
 "readOnly": true,
 "type": "boolean"
 },
+"createNotebookExecutionJobRequest": {
+"$ref": "GoogleCloudAiplatformV1CreateNotebookExecutionJobRequest",
+"description": "Request for NotebookService.CreateNotebookExecutionJob."
+},
 "createPipelineJobRequest": {
 "$ref": "GoogleCloudAiplatformV1CreatePipelineJobRequest",
 "description": "Request for PipelineService.CreatePipelineJob. CreatePipelineJobRequest.parent field is required (format: projects/{project}/locations/{location})."
diff --git a/googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json b/googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json
index 5593732e89d..7483c02b46f 100644
--- a/googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json
@@ -894,6 +894,62 @@
 "resources": {
 "locations": {
 "methods": {
+"augmentPrompt": {
+"description": "Given an input prompt, it returns augmented prompt from vertex rag store to guide LLM towards generating grounded responses.",
+"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:augmentPrompt",
+"httpMethod": "POST",
+"id": "aiplatform.projects.locations.augmentPrompt",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The resource name of the Location from which to augment prompt. The users must have permission to make a call in the project. Format: `projects/{project}/locations/{location}`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta1/{+parent}:augmentPrompt",
+"request": {
+"$ref": "GoogleCloudAiplatformV1beta1AugmentPromptRequest"
+},
+"response": {
+"$ref": "GoogleCloudAiplatformV1beta1AugmentPromptResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"corroborateContent": {
+"description": "Given an input text, it returns a score that evaluates the factuality of the text. It also extracts and returns claims from the text and provides supporting facts.",
+"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:corroborateContent",
+"httpMethod": "POST",
+"id": "aiplatform.projects.locations.corroborateContent",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The resource name of the Location from which to corroborate text. The users must have permission to make a call in the project. Format: `projects/{project}/locations/{location}`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta1/{+parent}:corroborateContent",
+"request": {
+"$ref": "GoogleCloudAiplatformV1beta1CorroborateContentRequest"
+},
+"response": {
+"$ref": "GoogleCloudAiplatformV1beta1CorroborateContentResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "evaluateInstances": {
 "description": "Evaluates instances based on a given metric.",
 "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}:evaluateInstances",
@@ -21087,7 +21143,7 @@
 }
 }
 },
-"revision": "20240828",
+"revision": "20240830",
 "rootUrl": "https://aiplatform.googleapis.com/",
 "schemas": {
 "CloudAiLargeModelsVisionGenerateVideoResponse": {
@@ -21825,6 +21881,64 @@
 },
 "type": "object"
 },
+"GoogleCloudAiplatformV1beta1AugmentPromptRequest": {
+"description": "Request message for AugmentPrompt.",
+"id": "GoogleCloudAiplatformV1beta1AugmentPromptRequest",
+"properties": {
+"contents": {
+"description": "Optional. Input content to augment, only text format is supported for now.",
+"items": {
+"$ref": "GoogleCloudAiplatformV1beta1Content"
+},
+"type": "array"
+},
+"model": {
+"$ref": "GoogleCloudAiplatformV1beta1AugmentPromptRequestModel",
+"description": "Optional. Metadata of the backend deployed model."
+},
+"vertexRagStore": {
+"$ref": "GoogleCloudAiplatformV1beta1VertexRagStore",
+"description": "Optional. Retrieves contexts from the Vertex RagStore."
+}
+},
+"type": "object"
+},
+"GoogleCloudAiplatformV1beta1AugmentPromptRequestModel": {
+"description": "Metadata of the backend deployed model.",
+"id": "GoogleCloudAiplatformV1beta1AugmentPromptRequestModel",
+"properties": {
+"model": {
+"description": "Optional. The model that the user will send the augmented prompt for content generation.",
+"type": "string"
+},
+"modelVersion": {
+"description": "Optional. The model version of the backend deployed model.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudAiplatformV1beta1AugmentPromptResponse": {
+"description": "Response message for AugmentPrompt.",
+"id": "GoogleCloudAiplatformV1beta1AugmentPromptResponse",
+"properties": {
+"augmentedPrompt": {
+"description": "Augmented prompt, only text format is supported for now.",
+"items": {
+"$ref": "GoogleCloudAiplatformV1beta1Content"
+},
+"type": "array"
+},
+"facts": {
+"description": "Retrieved facts from RAG data sources.",
+"items": {
+"$ref": "GoogleCloudAiplatformV1beta1Fact"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "GoogleCloudAiplatformV1beta1AuthConfig": {
 "description": "Auth configuration to run the extension.",
 "id": "GoogleCloudAiplatformV1beta1AuthConfig",
@@ -23149,6 +23263,36 @@
 },
 "type": "object"
 },
+"GoogleCloudAiplatformV1beta1Claim": {
+"description": "Claim that is extracted from the input text and facts that support it.",
+"id": "GoogleCloudAiplatformV1beta1Claim",
+"properties": {
+"endIndex": {
+"description": "Index in the input text where the claim ends (exclusive).",
+"format": "int32",
+"type": "integer"
+},
+"factIndexes": {
+"description": "Indexes of the facts supporting this claim.",
+"items": {
+"format": "int32",
+"type": "integer"
+},
+"type": "array"
+},
+"score": {
+"description": "Confidence score of this corroboration.",
+"format": "float",
+"type": "number"
+},
+"startIndex": {
+"description": "Index in the input text where the claim starts (inclusive).",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "GoogleCloudAiplatformV1beta1CoherenceInput": {
 "description": "Input for coherence metric.",
 "id": "GoogleCloudAiplatformV1beta1CoherenceInput",
@@ -23506,6 +23650,59 @@
 },
 "type": "object"
 },
+"GoogleCloudAiplatformV1beta1CorroborateContentRequest": {
+"description": "Request message for CorroborateContent.",
+"id": "GoogleCloudAiplatformV1beta1CorroborateContentRequest",
+"properties": {
+"content": {
+"$ref": "GoogleCloudAiplatformV1beta1Content",
+"description": "Optional. Input content to corroborate, only text format is supported for now."
+},
+"facts": {
+"description": "Optional. Facts used to generate the text can also be used to corroborate the text.",
+"items": {
+"$ref": "GoogleCloudAiplatformV1beta1Fact"
+},
+"type": "array"
+},
+"parameters": {
+"$ref": "GoogleCloudAiplatformV1beta1CorroborateContentRequestParameters",
+"description": "Optional. Parameters that can be set to override default settings per request."
+}
+},
+"type": "object"
+},
+"GoogleCloudAiplatformV1beta1CorroborateContentRequestParameters": {
+"description": "Parameters that can be overrided per request.",
+"id": "GoogleCloudAiplatformV1beta1CorroborateContentRequestParameters",
+"properties": {
+"citationThreshold": {
+"description": "Optional. Only return claims with citation score larger than the threshold.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+},
+"GoogleCloudAiplatformV1beta1CorroborateContentResponse": {
+"description": "Response message for CorroborateContent.",
+"id": "GoogleCloudAiplatformV1beta1CorroborateContentResponse",
+"properties": {
+"claims": {
+"description": "Claims that are extracted from the input content and facts that support the claims.",
+"items": {
+"$ref": "GoogleCloudAiplatformV1beta1Claim"
+},
+"type": "array"
+},
+"corroborationScore": {
+"description": "Confidence score of corroborating content. Value is [0,1] with 1 is the most confidence.",
+"format": "float",
+"type": "number"
+}
+},
+"type": "object"
+},
 "GoogleCloudAiplatformV1beta1CountTokensRequest": {
 "description": "Request message for PredictionService.CountTokens.",
 "id": "GoogleCloudAiplatformV1beta1CountTokensRequest",
@@ -27041,6 +27238,34 @@
 },
 "type": "object"
 },
+"GoogleCloudAiplatformV1beta1Fact": {
+"description": "The fact used in grounding.",
+"id": "GoogleCloudAiplatformV1beta1Fact",
+"properties": {
+"query": {
+"description": "Query that is used to retrieve this fact.",
+"type": "string"
+},
+"summary": {
+"description": "If present, the summary/snippet of the fact.",
+"type": "string"
+},
+"title": {
+"description": "If present, it refers to the title of this fact.",
+"type": "string"
+},
+"uri": {
+"description": "If present, this uri links to the source of the fact.",
+"type": "string"
+},
+"vectorDistance": {
+"description": "If present, the distance between the query vector and this fact vector.",
+"format": "double",
+"type": "number"
+}
+},
+"type": "object"
+},
 "GoogleCloudAiplatformV1beta1Feature": {
 "description": "Feature Metadata information. For example, color is a feature that describes an apple.",
 "id": "GoogleCloudAiplatformV1beta1Feature",

From 0f6213f70c42f69c561a031e79fe98da2b5f765b Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:03 +0000
Subject: [PATCH 03/32] feat(apigee): update the api

#### apigee:v1

The following keys were added:
- resources.organizations.resources.environments.resources.deployments.methods.get (Total Keys: 25)
- resources.organizations.resources.environments.resources.deployments.methods.setIamPolicy (Total Keys: 12)
- resources.organizations.resources.environments.resources.deployments.methods.testIamPermissions (Total Keys: 12)
---
 ...rganizations.environments.deployments.html | 255 ++++++++++++++++++
 .../discovery_cache/documents/apigee.v1.json  | 114 +++++++-
 2 files changed, 368 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/apigee_v1.organizations.environments.deployments.html b/docs/dyn/apigee_v1.organizations.environments.deployments.html
index 0b20c6a8818..97304f96a91 100644
--- a/docs/dyn/apigee_v1.organizations.environments.deployments.html
+++ b/docs/dyn/apigee_v1.organizations.environments.deployments.html
@@ -77,15 +77,155 @@ Instance Methods
 
   close()
 Close httplib2 connections.
+
+  get(name, x__xgafv=None)
+Gets a particular deployment of Api proxy or a shared flow in an environment
+
+  getIamPolicy(resource, options_requestedPolicyVersion=None, x__xgafv=None)
+Gets the IAM policy on a deployment. For more information, see [Manage users, roles, and permissions using the API](https://cloud.google.com/apigee/docs/api-platform/system-administration/manage-users-roles). You must have the `apigee.deployments.getIamPolicy` permission to call this API.
 
   list(parent, sharedFlows=None, x__xgafv=None)
 Lists all deployments of API proxies or shared flows in an environment.
+
+  setIamPolicy(resource, body=None, x__xgafv=None)
+Sets the IAM policy on a deployment, if the policy already exists it will be replaced. For more information, see [Manage users, roles, and permissions using the API](https://cloud.google.com/apigee/docs/api-platform/system-administration/manage-users-roles). You must have the `apigee.deployments.setIamPolicy` permission to call this API.
+
+  testIamPermissions(resource, body=None, x__xgafv=None)
+Tests the permissions of a user on a deployment, and returns a subset of permissions that the user has on the deployment. If the deployment does not exist, an empty permission set is returned (a NOT_FOUND error is not returned).
 Method Details
 
     close()
   Close httplib2 connections.
 
 
+
+    get(name, x__xgafv=None)
+  Gets a particular deployment of Api proxy or a shared flow in an environment
+
+Args:
+  name: string, Required. Name of the api proxy or the shared flow deployment. Use the following structure in your request: `organizations/{org}/environments/{env}/deployments/{deployment}` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "apiProxy": "A String", # API proxy.
+  "deployStartTime": "A String", # Time the API proxy was marked `deployed` in the control plane in millisconds since epoch.
+  "environment": "A String", # Environment.
+  "errors": [ # Errors reported for this deployment. Populated only when state == ERROR. **Note**: This field is displayed only when viewing deployment status.
+    { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).
+      "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+      "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+        {
+          "a_key": "", # Properties of the object. Contains field @type with type URL.
+        },
+      ],
+      "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+    },
+  ],
+  "instances": [ # Status reported by each runtime instance. **Note**: This field is displayed only when viewing deployment status.
+    { # The status of a deployment as reported by a single instance.
+      "deployedRevisions": [ # Revisions currently deployed in MPs.
+        { # Revisions deployed in the MPs.
+          "percentage": 42, # Percentage of MP replicas reporting this revision.
+          "revision": "A String", # API proxy revision reported as deployed.
+        },
+      ],
+      "deployedRoutes": [ # Current routes deployed in the ingress routing table. A route which is missing will appear in `missing_routes`.
+        { # Route deployed in the ingress routing table.
+          "basepath": "A String", # Base path in the routing table.
+          "envgroup": "A String", # Environment group where this route is installed.
+          "environment": "A String", # Destination environment. This will be empty if the route is not yet reported.
+          "percentage": 42, # Percentage of ingress replicas reporting this route.
+        },
+      ],
+      "instance": "A String", # ID of the instance reporting the status.
+    },
+  ],
+  "pods": [ # Status reported by runtime pods. **Note**: **This field is deprecated**. Runtime versions 1.3 and above report instance level status rather than pod status.
+    {
+      "appVersion": "A String", # Version of the application running in the pod.
+      "deploymentStatus": "A String", # Status of the deployment. Valid values include: - `deployed`: Successful. - `error` : Failed. - `pending` : Pod has not yet reported on the deployment.
+      "deploymentStatusTime": "A String", # Time the deployment status was reported in milliseconds since epoch.
+      "deploymentTime": "A String", # Time the proxy was deployed in milliseconds since epoch.
+      "podName": "A String", # Name of the pod which is reporting the status.
+      "podStatus": "A String", # Overall status of the pod (not this specific deployment). Valid values include: - `active`: Up to date. - `stale` : Recently out of date. Pods that have not reported status in a long time are excluded from the output.
+      "podStatusTime": "A String", # Time the pod status was reported in milliseconds since epoch.
+      "statusCode": "A String", # Code associated with the deployment status.
+      "statusCodeDetails": "A String", # Human-readable message associated with the status code.
+    },
+  ],
+  "proxyDeploymentType": "A String", # Output only. The type of the deployment (standard or extensible) Deployed proxy revision will be marked as extensible in following 2 cases. 1. The deployed proxy revision uses extensible policies. 2. If a environment supports flowhooks and flow hook is configured.
+  "revision": "A String", # API proxy revision.
+  "routeConflicts": [ # Conflicts in the desired state routing configuration. The presence of conflicts does not cause the state to be `ERROR`, but it will mean that some of the deployment's base paths are not routed to its environment. If the conflicts change, the state will transition to `PROGRESSING` until the latest configuration is rolled out to all instances. **Note**: This field is displayed only when viewing deployment status.
+    { # Describes a routing conflict that may cause a deployment not to receive traffic at some base path.
+      "conflictingDeployment": { # Tuple representing a base path and the deployment containing it. # Existing base path/deployment causing the conflict.
+        "apiProxy": "A String", # Name of the deployed API proxy revision containing the base path.
+        "basepath": "A String", # Base path receiving traffic.
+        "environment": "A String", # Name of the environment in which the proxy is deployed.
+        "revision": "A String", # Name of the deployed API proxy revision containing the base path.
+      },
+      "description": "A String", # Human-readable description of this conflict.
+      "environmentGroup": "A String", # Name of the environment group in which this conflict exists.
+    },
+  ],
+  "serviceAccount": "A String", # The full resource name of Cloud IAM Service Account that this deployment is using, eg, `projects/-/serviceAccounts/{email}`.
+  "state": "A String", # Current state of the deployment. **Note**: This field is displayed only when viewing deployment status.
+}
+
+
+
+    getIamPolicy(resource, options_requestedPolicyVersion=None, x__xgafv=None)
+  Gets the IAM policy on a deployment. For more information, see [Manage users, roles, and permissions using the API](https://cloud.google.com/apigee/docs/api-platform/system-administration/manage-users-roles). You must have the `apigee.deployments.getIamPolicy` permission to call this API.
+
+Args:
+  resource: string, REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field. (required)
+  options_requestedPolicyVersion: integer, Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).
+  "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+    { # Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.
+      "auditLogConfigs": [ # The configuration for logging of each type of permission.
+        { # Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.
+          "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.
+            "A String",
+          ],
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.
+    },
+  ],
+  "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.
+    { # Associates `members`, or principals, with a `role`.
+      "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
+        "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
+        "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
+        "title": "A String", # Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
+      },
+      "members": [ # Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
+        "A String",
+      ],
+      "role": "A String", # Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
+    },
+  ],
+  "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.
+  "version": 42, # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+}
+
+
 
     list(parent, sharedFlows=None, x__xgafv=None)
   Lists all deployments of API proxies or shared flows in an environment.
@@ -171,4 +311,119 @@ Method Details
 }
 
 
+
+    setIamPolicy(resource, body=None, x__xgafv=None)
+  Sets the IAM policy on a deployment, if the policy already exists it will be replaced. For more information, see [Manage users, roles, and permissions using the API](https://cloud.google.com/apigee/docs/api-platform/system-administration/manage-users-roles). You must have the `apigee.deployments.setIamPolicy` permission to call this API.
+
+Args:
+  resource: string, REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for `SetIamPolicy` method.
+  "policy": { # An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/). # REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them.
+    "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+      { # Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.
+        "auditLogConfigs": [ # The configuration for logging of each type of permission.
+          { # Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.
+            "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.
+      },
+    ],
+    "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.
+      { # Associates `members`, or principals, with a `role`.
+        "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+          "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
+          "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
+          "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
+          "title": "A String", # Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
+        },
+        "members": [ # Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
+          "A String",
+        ],
+        "role": "A String", # Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
+      },
+    ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.
+    "version": 42, # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+  },
+  "updateMask": "A String", # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only the fields in the mask will be modified. If no mask is provided, the following default mask is used: `paths: "bindings, etag"`
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).
+  "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+    { # Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.
+      "auditLogConfigs": [ # The configuration for logging of each type of permission.
+        { # Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.
+          "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.
+            "A String",
+          ],
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.
+    },
+  ],
+  "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.
+    { # Associates `members`, or principals, with a `role`.
+      "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
+        "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
+        "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
+        "title": "A String", # Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
+      },
+      "members": [ # Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
+        "A String",
+      ],
+      "role": "A String", # Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
+    },
+  ],
+  "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.
+  "version": 42, # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+}
+
+
+
+    testIamPermissions(resource, body=None, x__xgafv=None)
+  Tests the permissions of a user on a deployment, and returns a subset of permissions that the user has on the deployment. If the deployment does not exist, an empty permission set is returned (a NOT_FOUND error is not returned).
+
+Args:
+  resource: string, REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for `TestIamPermissions` method.
+  "permissions": [ # The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or `storage.*`) are not allowed. For more information see [IAM Overview](https://cloud.google.com/iam/docs/overview#permissions).
+    "A String",
+  ],
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response message for `TestIamPermissions` method.
+  "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
+    "A String",
+  ],
+}
+
+
 
\ No newline at end of file
diff --git a/googleapiclient/discovery_cache/documents/apigee.v1.json b/googleapiclient/discovery_cache/documents/apigee.v1.json
index 7af9f873836..cfc2d1db229 100644
--- a/googleapiclient/discovery_cache/documents/apigee.v1.json
+++ b/googleapiclient/discovery_cache/documents/apigee.v1.json
@@ -5402,6 +5402,62 @@
 },
 "deployments": {
 "methods": {
+"get": {
+"description": "Gets a particular deployment of Api proxy or a shared flow in an environment",
+"flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/deployments/{deploymentsId}",
+"httpMethod": "GET",
+"id": "apigee.organizations.environments.deployments.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. Name of the api proxy or the shared flow deployment. Use the following structure in your request: `organizations/{org}/environments/{env}/deployments/{deployment}`",
+"location": "path",
+"pattern": "^organizations/[^/]+/environments/[^/]+/deployments/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"response": {
+"$ref": "GoogleCloudApigeeV1Deployment"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"getIamPolicy": {
+"description": "Gets the IAM policy on a deployment. For more information, see [Manage users, roles, and permissions using the API](https://cloud.google.com/apigee/docs/api-platform/system-administration/manage-users-roles). You must have the `apigee.deployments.getIamPolicy` permission to call this API.",
+"flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/deployments/{deploymentsId}:getIamPolicy",
+"httpMethod": "GET",
+"id": "apigee.organizations.environments.deployments.getIamPolicy",
+"parameterOrder": [
+"resource"
+],
+"parameters": {
+"options.requestedPolicyVersion": {
+"description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"resource": {
+"description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.",
+"location": "path",
+"pattern": "^organizations/[^/]+/environments/[^/]+/deployments/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+resource}:getIamPolicy",
+"response": {
+"$ref": "GoogleIamV1Policy"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "list": {
 "description": "Lists all deployments of API proxies or shared flows in an environment.",
 "flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/deployments",
@@ -5431,6 +5487,62 @@
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
 ]
+},
+"setIamPolicy": {
+"description": "Sets the IAM policy on a deployment, if the policy already exists it will be replaced. For more information, see [Manage users, roles, and permissions using the API](https://cloud.google.com/apigee/docs/api-platform/system-administration/manage-users-roles). You must have the `apigee.deployments.setIamPolicy` permission to call this API.",
+"flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/deployments/{deploymentsId}:setIamPolicy",
+"httpMethod": "POST",
+"id": "apigee.organizations.environments.deployments.setIamPolicy",
+"parameterOrder": [
+"resource"
+],
+"parameters": {
+"resource": {
+"description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.",
+"location": "path",
+"pattern": "^organizations/[^/]+/environments/[^/]+/deployments/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+resource}:setIamPolicy",
+"request": {
+"$ref": "GoogleIamV1SetIamPolicyRequest"
+},
+"response": {
+"$ref": "GoogleIamV1Policy"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"testIamPermissions": {
+"description": "Tests the permissions of a user on a deployment, and returns a subset of permissions that the user has on the deployment. If the deployment does not exist, an empty permission set is returned (a NOT_FOUND error is not returned).",
+"flatPath": "v1/organizations/{organizationsId}/environments/{environmentsId}/deployments/{deploymentsId}:testIamPermissions",
+"httpMethod": "POST",
+"id": "apigee.organizations.environments.deployments.testIamPermissions",
+"parameterOrder": [
+"resource"
+],
+"parameters": {
+"resource": {
+"description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.",
+"location": "path",
+"pattern": "^organizations/[^/]+/environments/[^/]+/deployments/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+resource}:testIamPermissions",
+"request": {
+"$ref": "GoogleIamV1TestIamPermissionsRequest"
+},
+"response": {
+"$ref": "GoogleIamV1TestIamPermissionsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
 }
 }
 },
@@ -10045,7 +10157,7 @@
 }
 }
 },
-"revision": "20240903",
+"revision": "20240905",
 "rootUrl": "https://apigee.googleapis.com/",
 "schemas": {
 "EdgeConfigstoreBundleBadBundle": {

From 056033d3c18e6c4b23da2e32dd9e2175afc1bc38 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:03 +0000
Subject: [PATCH 04/32] feat(beyondcorp): update the api

#### beyondcorp:v1alpha

The following keys were deleted:
- resources.organizations.resources.locations.resources.subscriptions.methods.cancel.scopes (Total Keys: 1)
- resources.organizations.resources.locations.resources.subscriptions.methods.create.scopes (Total Keys: 1)
- resources.organizations.resources.locations.resources.subscriptions.methods.get.scopes (Total Keys: 1)
- resources.organizations.resources.locations.resources.subscriptions.methods.list.scopes (Total Keys: 1)
- resources.organizations.resources.locations.resources.subscriptions.methods.patch.scopes (Total Keys: 1)
- resources.organizations.resources.locations.resources.subscriptions.methods.restart.scopes (Total Keys: 1)
- resources.projects.resources.locations.resources.global.resources.securityGateways.resources.hubs.methods.create (Total Keys: 16)
- resources.projects.resources.locations.resources.global.resources.securityGateways.resources.hubs.methods.patch (Total Keys: 17)
- resources.projects.resources.locations.resources.global.resources.securityGateways.resources.hubs.methods.testIamPermissions (Total Keys: 12)
- resources.projects.resources.locations.resources.securityGateways.resources.hubs.methods.delete (Total Keys: 15)
- resources.projects.resources.locations.resources.securityGateways.resources.hubs.methods.get (Total Keys: 11)
- resources.projects.resources.locations.resources.securityGateways.resources.hubs.methods.list (Total Keys: 20)
- schemas.GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication.properties.applicationMatchFilter.$ref (Total Keys: 1)
- schemas.GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilter (Total Keys: 11)
- schemas.GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub.properties.createTime (Total Keys: 3)
- schemas.GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub.properties.displayName.type (Total Keys: 1)
- schemas.GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub.properties.name.type (Total Keys: 1)
- schemas.GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub.properties.state (Total Keys: 2)
- schemas.GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub.properties.updateTime (Total Keys: 3)
- schemas.GoogleCloudBeyondcorpSecuritygatewaysV1alphaHubNatGatewayConfig (Total Keys: 6)
- schemas.GoogleCloudBeyondcorpSecuritygatewaysV1alphaListHubsResponse (Total Keys: 7)

The following keys were added:
- resources.projects.resources.locations.resources.securityGateways.methods.setPeering (Total Keys: 12)
- resources.projects.resources.locations.resources.securityGateways.resources.applications.methods.getIamPolicy (Total Keys: 14)
- resources.projects.resources.locations.resources.securityGateways.resources.applications.methods.setIamPolicy (Total Keys: 12)
- schemas.GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication.properties.endpointMatchers (Total Keys: 2)
- schemas.GoogleCloudBeyondcorpSecuritygatewaysV1alphaEndpointMatcher (Total Keys: 6)
- schemas.GoogleCloudBeyondcorpSecuritygatewaysV1alphaNatGatewayConfig (Total Keys: 5)
- schemas.GoogleCloudBeyondcorpSecuritygatewaysV1alphaPeering (Total Keys: 5)
- schemas.GoogleCloudBeyondcorpSecuritygatewaysV1alphaSecurityGateway.properties.hubs (Total Keys: 2)
- schemas.GoogleCloudBeyondcorpSecuritygatewaysV1alphaSetPeeringRequest (Total Keys: 6)

The following keys were changed:
- schemas.GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub.properties.natGatewayConfig.$ref (Total Keys: 1)
---
 ...global_.securityGateways.applications.html |  40 +-
 ...ts.locations.global_.securityGateways.html |   5 -
 ...cations.securityGateways.applications.html | 181 ++++++-
 ...a.projects.locations.securityGateways.html |  97 +++-
 .../documents/beyondcorp.v1alpha.json         | 504 ++++++------------
 5 files changed, 422 insertions(+), 405 deletions(-)

diff --git a/docs/dyn/beyondcorp_v1alpha.projects.locations.global_.securityGateways.applications.html b/docs/dyn/beyondcorp_v1alpha.projects.locations.global_.securityGateways.applications.html
index b1af548e0aa..387b857b111 100644
--- a/docs/dyn/beyondcorp_v1alpha.projects.locations.global_.securityGateways.applications.html
+++ b/docs/dyn/beyondcorp_v1alpha.projects.locations.global_.securityGateways.applications.html
@@ -102,24 +102,21 @@ Method Details
     The object takes the form of:
 
 { # A Beyondcorp Application resource information.
-  "applicationMatchFilter": { # Match Criteria for Application Filtering. # Required. Application filter conditions associated with an application.
-    "matchConditions": [ # Required. Match conditions for AND logic. An array of match conditions to allow for multiple matching criteria. The rule is considered a match if all the conditions are met. The conditions can be one of the following combination (FQDN), (FQDN & PORTS), (IP_ADDRESS), (IP_ADDRESS & PORTS) EXAMPLES: FQDN - ("*.abc.com"), ("xyz.abc.com") FQDN and PORTS - ("abc.com" and "22"), ("abc.com" and "22,33)" etc IP_ADDRESS - ("10.20.30.40"), ("100.20.30.40") IP_ADDRESS and PORTS - ("10.20.30.40" and "4"), ("10.20.30.40" and "4,5")
-      { # Match condition for idenfying the application.
-        "fqdn": "A String", # Optional. FQDN of the application.
-        "ipAddress": "A String", # Optional. IP Address of the application.
-        "ports": [ # Optional. Ports of the application.
-          42,
-        ],
-      },
-    ],
-  },
   "createTime": "A String", # Output only. Timestamp when the resource was created.
   "displayName": "A String", # Optional. An arbitrary user-provided name for the Route resource. Cannot exceed 64 characters.
+  "endpointMatchers": [ # Required. Endpoint matchers associated with an application. A combination of hostname and ports as endpoint matcher is used to match the application. Match conditions for OR logic. An array of match conditions to allow for multiple matching criteria. The rule is considered a match if one the conditions are met. The conditions can be one of the following combination (Hostname), (Hostname & Ports) EXAMPLES: Hostname - ("*.abc.com"), ("xyz.abc.com") Hostname and Ports - ("abc.com" and "22"), ("abc.com" and "22,33") etc
+    { # EndpointMatcher contains the information of the endpoint that will match the application.
+      "hostname": "A String", # Required. Hostname of the application.
+      "ports": [ # Optional. Ports of the application.
+        42,
+      ],
+    },
+  ],
   "name": "A String", # Identifier. Name of the resource.
   "updateTime": "A String", # Output only. Timestamp when the resource was last modified.
 }
 
-  applicationId: string, Optional. User-settable Hub resource ID. * Must start with a letter. * Must contain between 4-63 characters from `/a-z-/`. * Must end with a number or letter.
+  applicationId: string, Optional. User-settable Application resource ID. * Must start with a letter. * Must contain between 4-63 characters from `/a-z-/`. * Must end with a number or letter.
   requestId: string, Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request.
   x__xgafv: string, V1 error format.
     Allowed values
@@ -160,19 +157,16 @@ Method Details
     The object takes the form of:
 
 { # A Beyondcorp Application resource information.
-  "applicationMatchFilter": { # Match Criteria for Application Filtering. # Required. Application filter conditions associated with an application.
-    "matchConditions": [ # Required. Match conditions for AND logic. An array of match conditions to allow for multiple matching criteria. The rule is considered a match if all the conditions are met. The conditions can be one of the following combination (FQDN), (FQDN & PORTS), (IP_ADDRESS), (IP_ADDRESS & PORTS) EXAMPLES: FQDN - ("*.abc.com"), ("xyz.abc.com") FQDN and PORTS - ("abc.com" and "22"), ("abc.com" and "22,33)" etc IP_ADDRESS - ("10.20.30.40"), ("100.20.30.40") IP_ADDRESS and PORTS - ("10.20.30.40" and "4"), ("10.20.30.40" and "4,5")
-      { # Match condition for idenfying the application.
-        "fqdn": "A String", # Optional. FQDN of the application.
-        "ipAddress": "A String", # Optional. IP Address of the application.
-        "ports": [ # Optional. Ports of the application.
-          42,
-        ],
-      },
-    ],
-  },
   "createTime": "A String", # Output only. Timestamp when the resource was created.
   "displayName": "A String", # Optional. An arbitrary user-provided name for the Route resource. Cannot exceed 64 characters.
+  "endpointMatchers": [ # Required. Endpoint matchers associated with an application. A combination of hostname and ports as endpoint matcher is used to match the application. Match conditions for OR logic. An array of match conditions to allow for multiple matching criteria. The rule is considered a match if one the conditions are met. The conditions can be one of the following combination (Hostname), (Hostname & Ports) EXAMPLES: Hostname - ("*.abc.com"), ("xyz.abc.com") Hostname and Ports - ("abc.com" and "22"), ("abc.com" and "22,33") etc
+    { # EndpointMatcher contains the information of the endpoint that will match the application.
+      "hostname": "A String", # Required. Hostname of the application.
+      "ports": [ # Optional. Ports of the application.
+        42,
+      ],
+    },
+  ],
   "name": "A String", # Identifier. Name of the resource.
   "updateTime": "A String", # Output only. Timestamp when the resource was last modified.
 }
diff --git a/docs/dyn/beyondcorp_v1alpha.projects.locations.global_.securityGateways.html b/docs/dyn/beyondcorp_v1alpha.projects.locations.global_.securityGateways.html
index 54776542475..5c2c0be1e79 100644
--- a/docs/dyn/beyondcorp_v1alpha.projects.locations.global_.securityGateways.html
+++ b/docs/dyn/beyondcorp_v1alpha.projects.locations.global_.securityGateways.html
@@ -79,11 +79,6 @@ Instance Methods
 
 Returns the applications Resource.
 
-
-  hubs()
-
-Returns the hubs Resource.
-
 
   close()
 Close httplib2 connections.
diff --git a/docs/dyn/beyondcorp_v1alpha.projects.locations.securityGateways.applications.html b/docs/dyn/beyondcorp_v1alpha.projects.locations.securityGateways.applications.html
index 9f07a5b6eca..69f0353dbb7 100644
--- a/docs/dyn/beyondcorp_v1alpha.projects.locations.securityGateways.applications.html
+++ b/docs/dyn/beyondcorp_v1alpha.projects.locations.securityGateways.applications.html
@@ -83,12 +83,18 @@ Instance Methods
 
   get(name, x__xgafv=None)
 Gets details of a single Application.
+
+  getIamPolicy(resource, options_requestedPolicyVersion=None, x__xgafv=None)
+Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.
 
   list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)
 Lists Applications in a given project and location.
 
   list_next()
 Retrieves the next page of results.
+
+  setIamPolicy(resource, body=None, x__xgafv=None)
+Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
 Method Details
 
     close()
@@ -147,34 +153,79 @@ Method Details
   An object of the form:
 
     { # A Beyondcorp Application resource information.
-  "applicationMatchFilter": { # Match Criteria for Application Filtering. # Required. Application filter conditions associated with an application.
-    "matchConditions": [ # Required. Match conditions for AND logic. An array of match conditions to allow for multiple matching criteria. The rule is considered a match if all the conditions are met. The conditions can be one of the following combination (FQDN), (FQDN & PORTS), (IP_ADDRESS), (IP_ADDRESS & PORTS) EXAMPLES: FQDN - ("*.abc.com"), ("xyz.abc.com") FQDN and PORTS - ("abc.com" and "22"), ("abc.com" and "22,33)" etc IP_ADDRESS - ("10.20.30.40"), ("100.20.30.40") IP_ADDRESS and PORTS - ("10.20.30.40" and "4"), ("10.20.30.40" and "4,5")
-      { # Match condition for idenfying the application.
-        "fqdn": "A String", # Optional. FQDN of the application.
-        "ipAddress": "A String", # Optional. IP Address of the application.
-        "ports": [ # Optional. Ports of the application.
-          42,
-        ],
-      },
-    ],
-  },
   "createTime": "A String", # Output only. Timestamp when the resource was created.
   "displayName": "A String", # Optional. An arbitrary user-provided name for the Route resource. Cannot exceed 64 characters.
+  "endpointMatchers": [ # Required. Endpoint matchers associated with an application. A combination of hostname and ports as endpoint matcher is used to match the application. Match conditions for OR logic. An array of match conditions to allow for multiple matching criteria. The rule is considered a match if one the conditions are met. The conditions can be one of the following combination (Hostname), (Hostname & Ports) EXAMPLES: Hostname - ("*.abc.com"), ("xyz.abc.com") Hostname and Ports - ("abc.com" and "22"), ("abc.com" and "22,33") etc
+    { # EndpointMatcher contains the information of the endpoint that will match the application.
+      "hostname": "A String", # Required. Hostname of the application.
+      "ports": [ # Optional. Ports of the application.
+        42,
+      ],
+    },
+  ],
   "name": "A String", # Identifier. Name of the resource.
   "updateTime": "A String", # Output only. Timestamp when the resource was last modified.
 }

+ getIamPolicy(resource, options_requestedPolicyVersion=None, x__xgafv=None) +

Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.
+
+Args:
+  resource: string, REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field. (required)
+  options_requestedPolicyVersion: integer, Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).
+  "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+    { # Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.
+      "auditLogConfigs": [ # The configuration for logging of each type of permission.
+        { # Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.
+          "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.
+            "A String",
+          ],
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.
+    },
+  ],
+  "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.
+    { # Associates `members`, or principals, with a `role`.
+      "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
+        "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
+        "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
+        "title": "A String", # Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
+      },
+      "members": [ # Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
+        "A String",
+      ],
+      "role": "A String", # Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
+    },
+  ],
+  "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.
+  "version": 42, # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+}

list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)

Lists Applications in a given project and location.
 
 Args:
   parent: string, Required. The parent location to which the resources belong. `projects/{project_id}/locations/global/securityGateways/{security_gateway_id}` (required)
-  filter: string, Optional. A filter specifying constraints of a list operation. All fields in the Hub message are supported. For example, the following query will return the Hub with displayName "test-application" For more information, please refer to https://google.aip.dev/160.
+  filter: string, Optional. A filter specifying constraints of a list operation. All fields in the Application message are supported. For example, the following query will return the Application with displayName "test-application" For more information, please refer to https://google.aip.dev/160.
   orderBy: string, Optional. Specifies the ordering of results. See [Sorting order](https://cloud.google.com/apis/design/design_patterns#sorting_order) for more information.
   pageSize: integer, Optional. The maximum number of items to return. If not specified, a default value of 50 will be used by the service. Regardless of the page_size value, the response may include a partial list and a caller should only rely on response's next_page_token to determine if there are more instances left to be queried.
-  pageToken: string, Optional. The next_page_token value returned from a previous ListHubsRequest, if any.
+  pageToken: string, Optional. The next_page_token value returned from a previous ListApplicationsRequest, if any.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -186,19 +237,16 @@ Method Details
     { # Message for response to listing Applications.
   "applications": [ # A list of BeyondCorp Application in the project.
     { # A Beyondcorp Application resource information.
-      "applicationMatchFilter": { # Match Criteria for Application Filtering. # Required. Application filter conditions associated with an application.
-        "matchConditions": [ # Required. Match conditions for AND logic. An array of match conditions to allow for multiple matching criteria. The rule is considered a match if all the conditions are met. The conditions can be one of the following combination (FQDN), (FQDN & PORTS), (IP_ADDRESS), (IP_ADDRESS & PORTS) EXAMPLES: FQDN - ("*.abc.com"), ("xyz.abc.com") FQDN and PORTS - ("abc.com" and "22"), ("abc.com" and "22,33)" etc IP_ADDRESS - ("10.20.30.40"), ("100.20.30.40") IP_ADDRESS and PORTS - ("10.20.30.40" and "4"), ("10.20.30.40" and "4,5")
-          { # Match condition for idenfying the application.
-            "fqdn": "A String", # Optional. FQDN of the application.
-            "ipAddress": "A String", # Optional. IP Address of the application.
-            "ports": [ # Optional. Ports of the application.
-              42,
-            ],
-          },
-        ],
-      },
       "createTime": "A String", # Output only. Timestamp when the resource was created.
       "displayName": "A String", # Optional. An arbitrary user-provided name for the Route resource. Cannot exceed 64 characters.
+      "endpointMatchers": [ # Required. Endpoint matchers associated with an application. A combination of hostname and ports as endpoint matcher is used to match the application. Match conditions for OR logic. An array of match conditions to allow for multiple matching criteria. The rule is considered a match if one the conditions are met. The conditions can be one of the following combination (Hostname), (Hostname & Ports) EXAMPLES: Hostname - ("*.abc.com"), ("xyz.abc.com") Hostname and Ports - ("abc.com" and "22"), ("abc.com" and "22,33") etc
+        { # EndpointMatcher contains the information of the endpoint that will match the application.
+          "hostname": "A String", # Required. Hostname of the application.
+          "ports": [ # Optional. Ports of the application.
+            42,
+          ],
+        },
+      ],
       "name": "A String", # Identifier. Name of the resource.
       "updateTime": "A String", # Output only. Timestamp when the resource was last modified.
     },
@@ -224,4 +272,89 @@ Method Details

+ setIamPolicy(resource, body=None, x__xgafv=None) +

Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.
+
+Args:
+  resource: string, REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for `SetIamPolicy` method.
+  "policy": { # An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/). # REQUIRED: The complete policy to be applied to the `resource`. The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them.
+    "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+      { # Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.
+        "auditLogConfigs": [ # The configuration for logging of each type of permission.
+          { # Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.
+            "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.
+              "A String",
+            ],
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.
+      },
+    ],
+    "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.
+      { # Associates `members`, or principals, with a `role`.
+        "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+          "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
+          "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
+          "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
+          "title": "A String", # Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
+        },
+        "members": [ # Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
+          "A String",
+        ],
+        "role": "A String", # Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
+      },
+    ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.
+    "version": 42, # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+  },
+  "updateMask": "A String", # OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only the fields in the mask will be modified. If no mask is provided, the following default mask is used: `paths: "bindings, etag"`
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).
+  "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+    { # Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts `jose@example.com` from DATA_READ logging, and `aliya@example.com` from DATA_WRITE logging.
+      "auditLogConfigs": [ # The configuration for logging of each type of permission.
+        { # Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.
+          "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.
+            "A String",
+          ],
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.
+    },
+  ],
+  "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.
+    { # Associates `members`, or principals, with a `role`.
+      "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
+        "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
+        "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
+        "title": "A String", # Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
+      },
+      "members": [ # Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
+        "A String",
+      ],
+      "role": "A String", # Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
+    },
+  ],
+  "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.
+  "version": 42, # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+}

+ \ No newline at end of file diff --git a/docs/dyn/beyondcorp_v1alpha.projects.locations.securityGateways.html b/docs/dyn/beyondcorp_v1alpha.projects.locations.securityGateways.html index e1cfed07624..ea339f82a6a 100644 --- a/docs/dyn/beyondcorp_v1alpha.projects.locations.securityGateways.html +++ b/docs/dyn/beyondcorp_v1alpha.projects.locations.securityGateways.html @@ -79,11 +79,6 @@

Instance Methods

Returns the applications Resource.

- hubs() -

Returns the hubs Resource.

close()

Close httplib2 connections.

@@ -111,6 +106,9 @@

Instance Methods

setIamPolicy(resource, body=None, x__xgafv=None)

Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

+ setPeering(securityGateway, body=None, x__xgafv=None)

This is a custom method to allow customers to create a peering connections between Google network and customer networks. This is enabled only for the allowlisted customers.

testIamPermissions(resource, body=None, x__xgafv=None)

Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning.

@@ -135,6 +133,15 @@

Method Details

"externalIps": [ # Output only. IP addresses that will be used for establishing connection to the endpoints. "A String", ], + "hubs": { # Optional. Map of Hubs that represents regional data path deployment with GCP region as a key. + "a_key": { # The Hub message contains information pertaining to the regional data path deployments. + "natGatewayConfig": { # Represents the NAT Gateway configuration. # Optional. NAT gateway setup to ensure enough NAT IP addresses are available to handle the traffic needed to access the applications. Allows to explicitly enable or disable the NAT in the Hub along with the total IPs allocated to handle the capacity limits. + "natIps": [ # Output only. List of NAT IPs that will be used for establishing connection to the endpoints. + "A String", + ], + }, + }, + }, "name": "A String", # Identifier. Name of the resource. "state": "A String", # Output only. The operational state of the SecurityGateway. "updateTime": "A String", # Output only. Timestamp when the resource was last modified. } requestId: string, Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request timed out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). - updateMask: string, Required. Mutable fields include: display_name, gateway_regions. + updateMask: string, Required. Mutable fields include: display_name, hubs. x__xgafv: string, V1 error format. Allowed values 1 - v1 error format @@ -470,6 +504,57 @@

Method Details

} +

+ setPeering(securityGateway, body=None, x__xgafv=None) +

This is a custom method to allow customers to create a peering connections between Google network and customer networks. This is enabled only for the allowlisted customers.
+
+Args:
+ securityGateway: string, Required. BeyondCorp SecurityGateway name using the form: `projects/{project}/locations/{location}/securityGateways/{security_gateway}` (required)
+ body: object, The request body.
+ The object takes the form of:
+
+{ # Set Peering request for creating a VPC peering between Google network and customer networks.
+ "requestId": "A String", # Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
+ "validateOnly": True or False, # Optional. If set, validates request by executing a dry-run which would not alter the resource in any way.
+ "vpcPeerings": [ # Required. List of Peering connection information.
+ { # VPC Peering details.
+ "dnsZones": [ # Optional. List of DNS zones for DNS peering with the customer VPC network.
+ "A String",
+ ],
+ "targetVpcNetwork": "A String", # Required. The name of the Target VPC network name in the format: `projects/{project}/global/networks/{network}
+ },
+ ],
+}
+
+ x__xgafv: string, V1 error format.
+ Allowed values
+ 1 - v1 error format
+ 2 - v2 error format
+
+Returns:
+ An object of the form:
+
+ { # This resource represents a long-running operation that is the result of a network API call.
+ "done": True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
+ "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+ {
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ ],
+ "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+ },
+ "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+ "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
+ "response": { # The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+ "a_key": "", # Properties of the object. Contains field @type with type URL.
+ },
+}

testIamPermissions(resource, body=None, x__xgafv=None)

Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may "fail open" without warning.
diff --git a/googleapiclient/discovery_cache/documents/beyondcorp.v1alpha.json b/googleapiclient/discovery_cache/documents/beyondcorp.v1alpha.json
index ceb2b85f69a..a4f4f01b356 100644
--- a/googleapiclient/discovery_cache/documents/beyondcorp.v1alpha.json
+++ b/googleapiclient/discovery_cache/documents/beyondcorp.v1alpha.json
@@ -1264,10 +1264,7 @@
 "path": "v1alpha/{+name}:cancel",
 "response": {
 "$ref": "GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaCancelSubscriptionResponse"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
+}
 },
 "create": {
 "description": "Creates a new BeyondCorp Enterprise Subscription in a given organization. Location will always be global as BeyondCorp subscriptions are per organization.",
@@ -1292,10 +1289,7 @@
 },
 "response": {
 "$ref": "GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
+}
 },
 "get": {
 "description": "Gets details of a single Subscription.",
@@ -1317,10 +1311,7 @@
 "path": "v1alpha/{+name}",
 "response": {
 "$ref": "GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
+}
 },
 "list": {
 "description": "Lists Subscriptions in a given organization and location.",
@@ -1353,10 +1344,7 @@
 "path": "v1alpha/{+parent}/subscriptions",
 "response": {
 "$ref": "GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaListSubscriptionsResponse"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
+}
 },
 "patch": {
 "description": "Updates an existing BeyondCorp Enterprise Subscription in a given organization. Location will always be global as BeyondCorp subscriptions are per organization.",
@@ -1392,10 +1380,7 @@
 },
 "response": {
 "$ref": "GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaSubscription"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
+}
 },
 "restart": {
 "description": "Restarts an existing BeyondCorp Enterprise Subscription in a given organization, that is scheduled for cancellation. Location will always be global as BeyondCorp subscriptions are per organization. Returns the timestamp for when the cancellation will become effective",
@@ -1422,10 +1407,7 @@
 "path": "v1alpha/{+name}:restart",
 "response": {
 "$ref": "GoogleCloudBeyondcorpSaasplatformSubscriptionsV1alphaRestartSubscriptionResponse"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
+}
 }
 }
 }
@@ -3496,7 +3478,7 @@
 ],
 "parameters": {
 "applicationId": {
-"description": "Optional. User-settable Hub resource ID. * Must start with a letter. * Must contain between 4-63 characters from `/a-z-/`. * Must end with a number or letter.",
+"description": "Optional. User-settable Application resource ID. * Must start with a letter. * Must contain between 4-63 characters from `/a-z-/`. * Must end with a number or letter.",
 "location": "query",
 "type": "string"
 },
@@ -3592,115 +3574,6 @@
 ]
 }
 }
-},
-"hubs": {
-"methods": {
-"create": {
-"description": "Creates a new Hub in a given project and location.",
-"flatPath": "v1alpha/projects/{projectsId}/locations/global/securityGateways/{securityGatewaysId}/hubs",
-"httpMethod": "POST",
-"id": "beyondcorp.projects.locations.global.securityGateways.hubs.create",
-"parameterOrder": [
-"parent"
-],
-"parameters": {
-"hubId": {
-"description": "Optional. User-settable Hub resource ID. * Must start with a letter. * Must contain between 4-63 characters from `/a-z-/`. * Must end with a number or letter.",
-"location": "query",
-"type": "string"
-},
-"parent": {
-"description": "Required. The resource name of the parent SecurityGateway using the form: `projects/{project_id}/locations/global/securityGateways/{security_gateway_id}`",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/global/securityGateways/[^/]+$",
-"required": true,
-"type": "string"
-},
-"requestId": {
-"description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request.",
-"location": "query",
-"type": "string"
-}
-},
-"path": "v1alpha/{+parent}/hubs",
-"request": {
-"$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub"
-},
-"response": {
-"$ref": "GoogleLongrunningOperation"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
-},
-"patch": {
-"description": "Updates the parameters of a single Hub.",
-"flatPath": "v1alpha/projects/{projectsId}/locations/global/securityGateways/{securityGatewaysId}/hubs/{hubsId}",
-"httpMethod": "PATCH",
-"id": "beyondcorp.projects.locations.global.securityGateways.hubs.patch",
-"parameterOrder": [
-"name"
-],
-"parameters": {
-"name": {
-"description": "Identifier. Name of the resource.",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/global/securityGateways/[^/]+/hubs/[^/]+$",
-"required": true,
-"type": "string"
-},
-"requestId": {
-"description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request timed out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).",
-"location": "query",
-"type": "string"
-},
-"updateMask": {
-"description": "Required. Mutable fields include: display_name.",
-"format": "google-fieldmask",
-"location": "query",
-"type": "string"
-}
-},
-"path": "v1alpha/{+name}",
-"request": {
-"$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub"
-},
-"response": {
-"$ref": "GoogleLongrunningOperation"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
-},
-"testIamPermissions": {
-"description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.",
-"flatPath": "v1alpha/projects/{projectsId}/locations/global/securityGateways/{securityGatewaysId}/hubs/{hubsId}:testIamPermissions",
-"httpMethod": "POST",
-"id": "beyondcorp.projects.locations.global.securityGateways.hubs.testIamPermissions",
-"parameterOrder": [
-"resource"
-],
-"parameters": {
-"resource": {
-"description": "REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/global/securityGateways/[^/]+/hubs/[^/]+$",
-"required": true,
-"type": "string"
-}
-},
-"path": "v1alpha/{+resource}:testIamPermissions",
-"request": {
-"$ref": "GoogleIamV1TestIamPermissionsRequest"
-},
-"response": {
-"$ref": "GoogleIamV1TestIamPermissionsResponse"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
-}
-}
 }
 }
 }
@@ -4347,7 +4220,7 @@
 "type": "string"
 },
 "updateMask": {
-"description": "Required. Mutable fields include: display_name, gateway_regions.",
+"description": "Required. Mutable fields include: display_name, hubs.",
 "format": "google-fieldmask",
 "location": "query",
 "type": "string"
@@ -4392,6 +4265,34 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"setPeering": {
+"description": "This is a custom method to allow customers to create a peering connections between Google network and customer networks. This is enabled only for the allowlisted customers.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/securityGateways/{securityGatewaysId}:setPeering",
+"httpMethod": "POST",
+"id": "beyondcorp.projects.locations.securityGateways.setPeering",
+"parameterOrder": [
+"securityGateway"
+],
+"parameters": {
+"securityGateway": {
+"description": "Required. BeyondCorp SecurityGateway name using the form: `projects/{project}/locations/{location}/securityGateways/{security_gateway}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/securityGateways/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+securityGateway}:setPeering",
+"request": {
+"$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaSetPeeringRequest"
+},
+"response": {
+"$ref": "GoogleLongrunningOperation"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "testIamPermissions": {
 "description": "Returns permissions that a caller has on the specified resource. If the resource does not exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is designed to be used for building permission-aware UIs and command-line tools, not for authorization checking. This operation may \"fail open\" without warning.",
 "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/securityGateways/{securityGatewaysId}:testIamPermissions",
@@ -4484,6 +4385,37 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"getIamPolicy": {
+"description": "Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/securityGateways/{securityGatewaysId}/applications/{applicationsId}:getIamPolicy",
+"httpMethod": "GET",
+"id": "beyondcorp.projects.locations.securityGateways.applications.getIamPolicy",
+"parameterOrder": [
+"resource"
+],
+"parameters": {
+"options.requestedPolicyVersion": {
+"description": "Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests for policies with any conditional role bindings must specify version 3. Policies with no conditional role bindings may specify any valid value or leave the field unset. The policy in the response might use the policy version that you specified, or it might use a lower policy version. For example, if you specify version 3, but the policy has no conditional role bindings, the response uses version 1. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"resource": {
+"description": "REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/securityGateways/[^/]+/applications/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+resource}:getIamPolicy",
+"response": {
+"$ref": "GoogleIamV1Policy"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "list": {
 "description": "Lists Applications in a given project and location.",
 "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/securityGateways/{securityGatewaysId}/applications",
@@ -4494,7 +4426,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "Optional. A filter specifying constraints of a list operation. All fields in the Hub message are supported. For example, the following query will return the Hub with displayName \"test-application\" For more information, please refer to https://google.aip.dev/160.",
+"description": "Optional. A filter specifying constraints of a list operation. All fields in the Application message are supported. For example, the following query will return the Application with displayName \"test-application\" For more information, please refer to https://google.aip.dev/160.",
 "location": "query",
 "type": "string"
 },
@@ -4510,7 +4442,7 @@
 "type": "integer"
 },
 "pageToken": {
-"description": "Optional. The next_page_token value returned from a previous ListHubsRequest, if any.",
+"description": "Optional. The next_page_token value returned from a previous ListApplicationsRequest, if any.",
 "location": "query",
 "type": "string"
 },
@@ -4529,112 +4461,30 @@
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
 ]
-}
-}
-},
-"hubs": {
-"methods": {
-"delete": {
-"description": "Deletes a single Hub.",
-"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/securityGateways/{securityGatewaysId}/hubs/{hubsId}",
-"httpMethod": "DELETE",
-"id": "beyondcorp.projects.locations.securityGateways.hubs.delete",
-"parameterOrder": [
-"name"
-],
-"parameters": {
-"name": {
-"description": "Required. Name of the resource.",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/securityGateways/[^/]+/hubs/[^/]+$",
-"required": true,
-"type": "string"
-},
-"requestId": {
-"description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).",
-"location": "query",
-"type": "string"
-},
-"validateOnly": {
-"description": "Optional. If set, validates request by executing a dry-run which would not alter the resource in any way.",
-"location": "query",
-"type": "boolean"
-}
-},
-"path": "v1alpha/{+name}",
-"response": {
-"$ref": "GoogleLongrunningOperation"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
 },
-"get": {
-"description": "Gets details of a single Hub.",
-"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/securityGateways/{securityGatewaysId}/hubs/{hubsId}",
-"httpMethod": "GET",
-"id": "beyondcorp.projects.locations.securityGateways.hubs.get",
+"setIamPolicy": {
+"description": "Sets the access control policy on the specified resource. Replaces any existing policy. Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/securityGateways/{securityGatewaysId}/applications/{applicationsId}:setIamPolicy",
+"httpMethod": "POST",
+"id": "beyondcorp.projects.locations.securityGateways.applications.setIamPolicy",
 "parameterOrder": [
-"name"
+"resource"
 ],
 "parameters": {
-"name": {
-"description": "Required. The resource name of the Hub using the form: `projects/{project_id}/locations/global/securityGateway/{security_gateway_id}/hubs/{hub_id}`",
+"resource": {
+"description": "REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.",
 "location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/securityGateways/[^/]+/hubs/[^/]+$",
+"pattern": "^projects/[^/]+/locations/[^/]+/securityGateways/[^/]+/applications/[^/]+$",
 "required": true,
 "type": "string"
 }
 },
-"path": "v1alpha/{+name}",
-"response": {
-"$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
-},
-"list": {
-"description": "Lists Hubs in a given project and location.",
-"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/securityGateways/{securityGatewaysId}/hubs",
-"httpMethod": "GET",
-"id": "beyondcorp.projects.locations.securityGateways.hubs.list",
-"parameterOrder": [
-"parent"
-],
-"parameters": {
-"filter": {
-"description": "Optional. A filter specifying constraints of a list operation. All fields in the Hub message are supported. For example, the following query will return the Hub with displayName \"test-hub\" For more information, please refer to https://google.aip.dev/160.",
-"location": "query",
-"type": "string"
-},
-"orderBy": {
-"description": "Optional. Specifies the ordering of results. See [Sorting order](https://cloud.google.com/apis/design/design_patterns#sorting_order) for more information.",
-"location": "query",
-"type": "string"
-},
-"pageSize": {
-"description": "Optional. The maximum number of items to return. If not specified, a default value of 50 will be used by the service. Regardless of the page_size value, the response may include a partial list and a caller should only rely on response's next_page_token to determine if there are more instances left to be queried.",
-"format": "int32",
-"location": "query",
-"type": "integer"
-},
-"pageToken": {
-"description": "Optional. The next_page_token value returned from a previous ListHubsRequest, if any.",
-"location": "query",
-"type": "string"
-},
-"parent": {
-"description": "Required. The parent location to which the resources belong. `projects/{project_id}/locations/global/securityGateways/{security_gateway_id}`",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/securityGateways/[^/]+$",
-"required": true,
-"type": "string"
-}
+"path": "v1alpha/{+resource}:setIamPolicy",
+"request": {
+"$ref": "GoogleIamV1SetIamPolicyRequest"
 },
-"path": "v1alpha/{+parent}/hubs",
 "response": {
-"$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaListHubsResponse"
+"$ref": "GoogleIamV1Policy"
 },
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
@@ -4649,7 +4499,7 @@
 }
 }
 },
-"revision": "20240807",
+"revision": "20240904",
 "rootUrl": "https://beyondcorp.googleapis.com/",
 "schemas": {
 "AllocatedConnection": {
@@ -6827,10 +6677,6 @@
 "description": "A Beyondcorp Application resource information.",
 "id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplication",
 "properties": {
-"applicationMatchFilter": {
-"$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilter",
-"description": "Required. Application filter conditions associated with an application."
-},
 "createTime": {
 "description": "Output only. Timestamp when the resource was created.",
 "format": "google-datetime",
@@ -6841,6 +6687,13 @@
 "description": "Optional. An arbitrary user-provided name for the Route resource. Cannot exceed 64 characters.",
 "type": "string"
 },
+"endpointMatchers": {
+"description": "Required. Endpoint matchers associated with an application. A combination of hostname and ports as endpoint matcher is used to match the application. Match conditions for OR logic. An array of match conditions to allow for multiple matching criteria. The rule is considered a match if one the conditions are met. The conditions can be one of the following combination (Hostname), (Hostname & Ports) EXAMPLES: Hostname - (\"*.abc.com\"), (\"xyz.abc.com\") Hostname and Ports - (\"abc.com\" and \"22\"), (\"abc.com\" and \"22,33\") etc",
+"items": {
+"$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaEndpointMatcher"
+},
+"type": "array"
+},
 "name": {
 "description": "Identifier. Name of the resource.",
 "type": "string"
@@ -6854,30 +6707,12 @@
 },
 "type": "object"
 },
-"GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilter": {
-"description": "Match Criteria for Application Filtering.",
-"id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilter",
+"GoogleCloudBeyondcorpSecuritygatewaysV1alphaEndpointMatcher": {
+"description": "EndpointMatcher contains the information of the endpoint that will match the application.",
+"id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaEndpointMatcher",
 "properties": {
-"matchConditions": {
-"description": "Required. Match conditions for AND logic. An array of match conditions to allow for multiple matching criteria. The rule is considered a match if all the conditions are met. The conditions can be one of the following combination (FQDN), (FQDN & PORTS), (IP_ADDRESS), (IP_ADDRESS & PORTS) EXAMPLES: FQDN - (\"*.abc.com\"), (\"xyz.abc.com\") FQDN and PORTS - (\"abc.com\" and \"22\"), (\"abc.com\" and \"22,33)\" etc IP_ADDRESS - (\"10.20.30.40\"), (\"100.20.30.40\") IP_ADDRESS and PORTS - (\"10.20.30.40\" and \"4\"), (\"10.20.30.40\" and \"4,5\")",
-"items": {
-"$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilterMatchCondition"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilterMatchCondition": {
-"description": "Match condition for idenfying the application.",
-"id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaApplicationMatchFilterMatchCondition",
-"properties": {
-"fqdn": {
-"description": "Optional. FQDN of the application.",
-"type": "string"
-},
-"ipAddress": {
-"description": "Optional. IP Address of the application.",
+"hostname": {
+"description": "Required. Hostname of the application.",
 "type": "string"
 },
 "ports": {
@@ -6892,74 +6727,12 @@
 "type": "object"
 },
 "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub": {
-"description": "A Beyondcorp Hub resource information.",
+"description": "The Hub message contains information pertaining to the regional data path deployments.",
 "id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub",
 "properties": {
-"createTime": {
-"description": "Output only. Timestamp when the resource was created.",
-"format": "google-datetime",
-"readOnly": true,
-"type": "string"
-},
-"displayName": {
-"description": "Optional. An arbitrary user-provided name for the Hub. Cannot exceed 64 characters.",
-"type": "string"
-},
-"name": {
-"description": "Identifier. Name of the resource.",
-"type": "string"
-},
 "natGatewayConfig": {
-"$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHubNatGatewayConfig",
-"description": "Required. NAT gateway setup to ensure enough NAT IP addresses are available to handle the traffic needed to access the applications. Allows to explicitly enable or disable the NAT in the Hub along with the total IPs allocated to handle the capacity limits."
-},
-"state": {
-"description": "Output only. The operational state of the Hub.",
-"enum": [
-"STATE_UNSPECIFIED",
-"CREATING",
-"UPDATING",
-"DELETING",
-"RUNNING",
-"DOWN",
-"ERROR"
-],
-"enumDescriptions": [
-"Default value. This value is unused.",
-"Hub is being created.",
-"Hub is being updated.",
-"Hub is being deleted.",
-"Hub is running.",
-"Hub is down and may be restored in the future. This happens when CCFE sends ProjectState = OFF.",
-"Hub encountered an error and is in an indeterministic state."
-],
-"readOnly": true,
-"type": "string"
-},
-"updateTime": {
-"description": "Output only. Timestamp when the resource was last modified.",
-"format": "google-datetime",
-"readOnly": true,
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudBeyondcorpSecuritygatewaysV1alphaHubNatGatewayConfig": {
-"description": "Represents the NAT Gateway configuration.",
-"id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHubNatGatewayConfig",
-"properties": {
-"enableNatGateway": {
-"description": "Optional. Explicitly enable or disable the NAT Gateway. This is defaulted to false until NAT Gateway configuration is fully supported and any request with a disable option will be rejected.",
-"type": "boolean"
-},
-"natIps": {
-"description": "Output only. List of NAT IPs that will be used for establishing connection to the endpoints.",
-"items": {
-"type": "string"
-},
-"readOnly": true,
-"type": "array"
+"$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaNatGatewayConfig",
+"description": "Optional. NAT gateway setup to ensure enough NAT IP addresses are available to handle the traffic needed to access the applications. Allows to explicitly enable or disable the NAT in the Hub along with the total IPs allocated to handle the capacity limits."
 }
 },
 "type": "object"
@@ -6989,21 +6762,21 @@
 },
 "type": "object"
 },
-"GoogleCloudBeyondcorpSecuritygatewaysV1alphaListHubsResponse": {
-"description": "Message for response to listing Hubs.",
-"id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaListHubsResponse",
+"GoogleCloudBeyondcorpSecuritygatewaysV1alphaListSecurityGatewaysResponse": {
+"description": "Message for response to listing SecurityGateways.",
+"id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaListSecurityGatewaysResponse",
 "properties": {
-"hubs": {
-"description": "A list of BeyondCorp Hub in the project.",
-"items": {
-"$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub"
-},
-"type": "array"
-},
 "nextPageToken": {
 "description": "A token to retrieve the next page of results, or empty if there are no more results in the list.",
 "type": "string"
 },
+"securityGateways": {
+"description": "A list of BeyondCorp SecurityGateway in the project.",
+"items": {
+"$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaSecurityGateway"
+},
+"type": "array"
+},
 "unreachable": {
 "description": "A list of locations that could not be reached.",
 "items": {
@@ -7014,27 +6787,35 @@
 },
 "type": "object"
 },
-"GoogleCloudBeyondcorpSecuritygatewaysV1alphaListSecurityGatewaysResponse": {
-"description": "Message for response to listing SecurityGateways.",
-"id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaListSecurityGatewaysResponse",
+"GoogleCloudBeyondcorpSecuritygatewaysV1alphaNatGatewayConfig": {
+"description": "Represents the NAT Gateway configuration.",
+"id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaNatGatewayConfig",
 "properties": {
-"nextPageToken": {
-"description": "A token to retrieve the next page of results, or empty if there are no more results in the list.",
-"type": "string"
-},
-"securityGateways": {
-"description": "A list of BeyondCorp SecurityGateway in the project.",
+"natIps": {
+"description": "Output only. List of NAT IPs that will be used for establishing connection to the endpoints.",
 "items": {
-"$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaSecurityGateway"
+"type": "string"
 },
+"readOnly": true,
 "type": "array"
+}
 },
-"unreachable": {
-"description": "A list of locations that could not be reached.",
+"type": "object"
+},
+"GoogleCloudBeyondcorpSecuritygatewaysV1alphaPeering": {
+"description": "VPC Peering details.",
+"id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaPeering",
+"properties": {
+"dnsZones": {
+"description": "Optional. List of DNS zones for DNS peering with the customer VPC network.",
 "items": {
 "type": "string"
 },
 "type": "array"
+},
+"targetVpcNetwork": {
+"description": "Required. The name of the Target VPC network name in the format: `projects/{project}/global/networks/{network}",
+"type": "string"
 }
 },
 "type": "object"
@@ -7061,6 +6842,13 @@
 "readOnly": true,
 "type": "array"
 },
+"hubs": {
+"additionalProperties": {
+"$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaHub"
+},
+"description": "Optional. Map of Hubs that represents regional data path deployment with GCP region as a key.",
+"type": "object"
+},
 "name": {
 "description": "Identifier. Name of the resource.",
 "type": "string"
@@ -7141,6 +6929,28 @@
 },
 "type": "object"
 },
+"GoogleCloudBeyondcorpSecuritygatewaysV1alphaSetPeeringRequest": {
+"description": "Set Peering request for creating a VPC peering between Google network and customer networks.",
+"id": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaSetPeeringRequest",
+"properties": {
+"requestId": {
+"description": "Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).",
+"type": "string"
+},
+"validateOnly": {
+"description": "Optional. If set, validates request by executing a dry-run which would not alter the resource in any way.",
+"type": "boolean"
+},
+"vpcPeerings": {
+"description": "Required. List of Peering connection information.",
+"items": {
+"$ref": "GoogleCloudBeyondcorpSecuritygatewaysV1alphaPeering"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "GoogleCloudLocationListLocationsResponse": {
 "description": "The response message for Locations.ListLocations.",
 "id": "GoogleCloudLocationListLocationsResponse",

From d94ebee405b435ced71c73f07fee5a27e6670486 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:03 +0000
Subject: [PATCH 05/32] fix(bigquery): update the api

#### bigquery:v2

The following keys were changed:
- endpoints (Total Keys: 1)
---
 docs/dyn/bigquery_v2.datasets.html            | 32 ++++----
 docs/dyn/bigquery_v2.jobs.html                | 74 +++++++++----------
 docs/dyn/bigquery_v2.models.html              | 32 ++++----
 docs/dyn/bigquery_v2.tables.html              | 42 +++++------
 .../documents/bigquery.v2.json                | 51 +++++++------
 5 files changed, 119 insertions(+), 112 deletions(-)

diff --git a/docs/dyn/bigquery_v2.datasets.html b/docs/dyn/bigquery_v2.datasets.html
index c52ead555ab..2ece80093a2 100644
--- a/docs/dyn/bigquery_v2.datasets.html
+++ b/docs/dyn/bigquery_v2.datasets.html
@@ -216,10 +216,10 @@ Method Details
   },
   "location": "A String", # The geographic location where the dataset should reside. See https://cloud.google.com/bigquery/docs/locations for supported locations.
   "maxTimeTravelHours": "A String", # Optional. Defines the time travel window in hours. The value can be from 48 to 168 hours (2 to 7 days). The default value is 168 hours if this is not set.
-  "resourceTags": { # Optional. The [tags](/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example "123456789012/environment" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example "Production". See [Tag definitions](/iam/docs/tags-access-control#definitions) for more details.
+  "resourceTags": { # Optional. The [tags](https://cloud.google.com/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example "123456789012/environment" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example "Production". See [Tag definitions](https://cloud.google.com/iam/docs/tags-access-control#definitions) for more details.
     "a_key": "A String",
   },
-  "restrictions": { # Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
+  "restrictions": { # Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
     "type": "A String", # Output only. Specifies the type of dataset/table restriction.
   },
   "satisfiesPzi": True or False, # Output only. Reserved for future use.
@@ -318,10 +318,10 @@ Method Details
   },
   "location": "A String", # The geographic location where the dataset should reside. See https://cloud.google.com/bigquery/docs/locations for supported locations.
   "maxTimeTravelHours": "A String", # Optional. Defines the time travel window in hours. The value can be from 48 to 168 hours (2 to 7 days). The default value is 168 hours if this is not set.
-  "resourceTags": { # Optional. The [tags](/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example "123456789012/environment" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example "Production". See [Tag definitions](/iam/docs/tags-access-control#definitions) for more details.
+  "resourceTags": { # Optional. The [tags](https://cloud.google.com/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example "123456789012/environment" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example "Production". See [Tag definitions](https://cloud.google.com/iam/docs/tags-access-control#definitions) for more details.
     "a_key": "A String",
   },
-  "restrictions": { # Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
+  "restrictions": { # Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
     "type": "A String", # Output only. Specifies the type of dataset/table restriction.
   },
   "satisfiesPzi": True or False, # Output only. Reserved for future use.
@@ -418,10 +418,10 @@ Method Details
   },
   "location": "A String", # The geographic location where the dataset should reside. See https://cloud.google.com/bigquery/docs/locations for supported locations.
   "maxTimeTravelHours": "A String", # Optional. Defines the time travel window in hours. The value can be from 48 to 168 hours (2 to 7 days). The default value is 168 hours if this is not set.
-  "resourceTags": { # Optional. The [tags](/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example "123456789012/environment" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example "Production". See [Tag definitions](/iam/docs/tags-access-control#definitions) for more details.
+  "resourceTags": { # Optional. The [tags](https://cloud.google.com/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example "123456789012/environment" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example "Production". See [Tag definitions](https://cloud.google.com/iam/docs/tags-access-control#definitions) for more details.
     "a_key": "A String",
   },
-  "restrictions": { # Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
+  "restrictions": { # Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
     "type": "A String", # Output only. Specifies the type of dataset/table restriction.
   },
   "satisfiesPzi": True or False, # Output only. Reserved for future use.
@@ -578,10 +578,10 @@ Method Details
   },
   "location": "A String", # The geographic location where the dataset should reside. See https://cloud.google.com/bigquery/docs/locations for supported locations.
   "maxTimeTravelHours": "A String", # Optional. Defines the time travel window in hours. The value can be from 48 to 168 hours (2 to 7 days). The default value is 168 hours if this is not set.
-  "resourceTags": { # Optional. The [tags](/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example "123456789012/environment" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example "Production". See [Tag definitions](/iam/docs/tags-access-control#definitions) for more details.
+  "resourceTags": { # Optional. The [tags](https://cloud.google.com/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example "123456789012/environment" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example "Production". See [Tag definitions](https://cloud.google.com/iam/docs/tags-access-control#definitions) for more details.
     "a_key": "A String",
   },
-  "restrictions": { # Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
+  "restrictions": { # Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
     "type": "A String", # Output only. Specifies the type of dataset/table restriction.
   },
   "satisfiesPzi": True or False, # Output only. Reserved for future use.
@@ -678,10 +678,10 @@ Method Details
   },
   "location": "A String", # The geographic location where the dataset should reside. See https://cloud.google.com/bigquery/docs/locations for supported locations.
   "maxTimeTravelHours": "A String", # Optional. Defines the time travel window in hours. The value can be from 48 to 168 hours (2 to 7 days). The default value is 168 hours if this is not set.
-  "resourceTags": { # Optional. The [tags](/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example "123456789012/environment" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example "Production". See [Tag definitions](/iam/docs/tags-access-control#definitions) for more details.
+  "resourceTags": { # Optional. The [tags](https://cloud.google.com/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example "123456789012/environment" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example "Production". See [Tag definitions](https://cloud.google.com/iam/docs/tags-access-control#definitions) for more details.
     "a_key": "A String",
   },
-  "restrictions": { # Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
+  "restrictions": { # Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
     "type": "A String", # Output only. Specifies the type of dataset/table restriction.
   },
   "satisfiesPzi": True or False, # Output only. Reserved for future use.
@@ -793,10 +793,10 @@ Method Details
   },
   "location": "A String", # The geographic location where the dataset should reside. See https://cloud.google.com/bigquery/docs/locations for supported locations.
   "maxTimeTravelHours": "A String", # Optional. Defines the time travel window in hours. The value can be from 48 to 168 hours (2 to 7 days). The default value is 168 hours if this is not set.
-  "resourceTags": { # Optional. The [tags](/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example "123456789012/environment" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example "Production". See [Tag definitions](/iam/docs/tags-access-control#definitions) for more details.
+  "resourceTags": { # Optional. The [tags](https://cloud.google.com/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example "123456789012/environment" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example "Production". See [Tag definitions](https://cloud.google.com/iam/docs/tags-access-control#definitions) for more details.
     "a_key": "A String",
   },
-  "restrictions": { # Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
+  "restrictions": { # Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
     "type": "A String", # Output only. Specifies the type of dataset/table restriction.
   },
   "satisfiesPzi": True or False, # Output only. Reserved for future use.
@@ -896,10 +896,10 @@ Method Details
   },
   "location": "A String", # The geographic location where the dataset should reside. See https://cloud.google.com/bigquery/docs/locations for supported locations.
   "maxTimeTravelHours": "A String", # Optional. Defines the time travel window in hours. The value can be from 48 to 168 hours (2 to 7 days). The default value is 168 hours if this is not set.
-  "resourceTags": { # Optional. The [tags](/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example "123456789012/environment" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example "Production". See [Tag definitions](/iam/docs/tags-access-control#definitions) for more details.
+  "resourceTags": { # Optional. The [tags](https://cloud.google.com/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example "123456789012/environment" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example "Production". See [Tag definitions](https://cloud.google.com/iam/docs/tags-access-control#definitions) for more details.
     "a_key": "A String",
   },
-  "restrictions": { # Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
+  "restrictions": { # Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
     "type": "A String", # Output only. Specifies the type of dataset/table restriction.
   },
   "satisfiesPzi": True or False, # Output only. Reserved for future use.
@@ -996,10 +996,10 @@ Method Details
   },
   "location": "A String", # The geographic location where the dataset should reside. See https://cloud.google.com/bigquery/docs/locations for supported locations.
   "maxTimeTravelHours": "A String", # Optional. Defines the time travel window in hours. The value can be from 48 to 168 hours (2 to 7 days). The default value is 168 hours if this is not set.
-  "resourceTags": { # Optional. The [tags](/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example "123456789012/environment" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example "Production". See [Tag definitions](/iam/docs/tags-access-control#definitions) for more details.
+  "resourceTags": { # Optional. The [tags](https://cloud.google.com/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example "123456789012/environment" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example "Production". See [Tag definitions](https://cloud.google.com/iam/docs/tags-access-control#definitions) for more details.
     "a_key": "A String",
   },
-  "restrictions": { # Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
+  "restrictions": { # Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
     "type": "A String", # Output only. Specifies the type of dataset/table restriction.
   },
   "satisfiesPzi": True or False, # Output only. Reserved for future use.
diff --git a/docs/dyn/bigquery_v2.jobs.html b/docs/dyn/bigquery_v2.jobs.html
index ca6bff938dd..8a7b75217d9 100644
--- a/docs/dyn/bigquery_v2.jobs.html
+++ b/docs/dyn/bigquery_v2.jobs.html
@@ -160,7 +160,7 @@ Method Details
         ],
         "fieldDelimiter": "A String", # Optional. When extracting data in CSV format, this defines the delimiter to use between fields in the exported data. Default is ','. Not applicable when extracting models.
         "modelExtractOptions": { # Options related to model extraction. # Optional. Model extract options only applicable when extracting models.
-          "trialId": "A String", # The 1-based ID of the trial to be exported from a hyperparameter tuning model. If not specified, the trial with id = [Model](/bigquery/docs/reference/rest/v2/models#resource:-model).defaultTrialId is exported. This field is ignored for models not trained with hyperparameter tuning.
+          "trialId": "A String", # The 1-based ID of the trial to be exported from a hyperparameter tuning model. If not specified, the trial with id = [Model](https://cloud.google.com/bigquery/docs/reference/rest/v2/models#resource:-model).defaultTrialId is exported. This field is ignored for models not trained with hyperparameter tuning.
         },
         "printHeader": true, # Optional. Whether to print out a header row in the results. Default is true. Not applicable when extracting models.
         "sourceModel": { # Id path of a model. # A reference to the model being exported.
@@ -550,7 +550,7 @@ Method Details
     },
     "etag": "A String", # Output only. A hash of this resource.
     "id": "A String", # Output only. Opaque ID field of the job.
-    "jobCreationReason": { # Reason about why a Job was created from a [`jobs.query`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query) method when used with `JOB_CREATION_OPTIONAL` Job creation mode. For [`jobs.insert`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/insert) method calls it will always be `REQUESTED`. [Preview](/products/#product-launch-stages) # Output only. The reason why a Job was created. [Preview](/products/#product-launch-stages)
+    "jobCreationReason": { # Reason about why a Job was created from a [`jobs.query`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query) method when used with `JOB_CREATION_OPTIONAL` Job creation mode. For [`jobs.insert`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/insert) method calls it will always be `REQUESTED`. [Preview](https://cloud.google.com/products/#product-launch-stages) # Output only. The reason why a Job was created. [Preview](https://cloud.google.com/products/#product-launch-stages)
       "code": "A String", # Output only. Specifies the high level reason why a Job was created.
     },
     "jobReference": { # A job reference is a fully qualified identifier for referring to a job. # Optional. Reference describing the unique-per-user name of the job.
@@ -714,14 +714,14 @@ Method Details
                 "projectId": "A String", # Required. The ID of the project containing this table.
                 "tableId": "A String", # Required. The ID of the table. The ID can contain Unicode characters in category L (letter), M (mark), N (number), Pc (connector, including underscore), Pd (dash), and Zs (space). For more information, see [General Category](https://wikipedia.org/wiki/Unicode_character_property#General_Category). The maximum length is 1,024 characters. Certain operations allow suffixing of the table ID with a partition decorator, such as `sample_table$20190123`.
               },
-              "tableType": "A String", # [Table type](/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.type).
+              "tableType": "A String", # [Table type](https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.type).
               "unusedReason": "A String", # Reason for not using metadata caching for the table.
             },
           ],
         },
         "mlStatistics": { # Job statistics specific to a BigQuery ML training job. # Output only. Statistics of a BigQuery ML training job.
-          "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning job](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) sorted by trial_id.
-            { # Training info of a trial in [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
+          "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning job](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) sorted by trial_id.
+            { # Training info of a trial in [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
               "endTimeMs": "A String", # Ending time of the trial.
               "errorMessage": "A String", # Error message for FAILED and INFEASIBLE trial.
               "evalLoss": 3.14, # Loss computed on the eval data at the end of trial.
@@ -1127,7 +1127,7 @@ Method Details
               "trialId": "A String", # 1-based index of the trial.
             },
           ],
-          "iterationResults": [ # Results for all completed iterations. Empty for [hyperparameter tuning jobs](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview).
+          "iterationResults": [ # Results for all completed iterations. Empty for [hyperparameter tuning jobs](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview).
             { # Information about a single iteration of the training run.
               "arimaResult": { # (Auto-)arima fitting result. Wrap everything in ArimaResult for easier refactoring if we want to use model-specific iteration results. # Arima result.
                 "arimaModelInfo": [ # This message is repeated because there are multiple arima models fitted in auto-arima. For non-auto-arima model, its size is one.
@@ -1378,7 +1378,7 @@ Method Details
           "sparkJobId": "A String", # Output only. Spark job ID if a Spark job is created successfully.
           "sparkJobLocation": "A String", # Output only. Location where the Spark job is executed. A location is selected by BigQueury for jobs configured to run in a multi-region.
         },
-        "statementType": "A String", # Output only. The type of query statement, if valid. Possible values: * `SELECT`: [`SELECT`](/bigquery/docs/reference/standard-sql/query-syntax#select_list) statement. * `ASSERT`: [`ASSERT`](/bigquery/docs/reference/standard-sql/debugging-statements#assert) statement. * `INSERT`: [`INSERT`](/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) statement. * `UPDATE`: [`UPDATE`](/bigquery/docs/reference/standard-sql/query-syntax#update_statement) statement. * `DELETE`: [`DELETE`](/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `MERGE`: [`MERGE`](/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `CREATE_TABLE`: [`CREATE TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: [`CREATE TABLE AS SELECT`](/bigquery/docs/reference/standard-sql/data-definition-language#query_statement) statement. * `CREATE_VIEW`: [`CREATE VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) statement. * `CREATE_MODEL`: [`CREATE MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_model_statement) statement. * `CREATE_MATERIALIZED_VIEW`: [`CREATE MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#create_materialized_view_statement) statement. * `CREATE_FUNCTION`: [`CREATE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#create_function_statement) statement. * `CREATE_TABLE_FUNCTION`: [`CREATE TABLE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#create_table_function_statement) statement. * `CREATE_PROCEDURE`: [`CREATE PROCEDURE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_procedure) statement. * `CREATE_ROW_ACCESS_POLICY`: [`CREATE ROW ACCESS POLICY`](/bigquery/docs/reference/standard-sql/data-definition-language#create_row_access_policy_statement) statement. * `CREATE_SCHEMA`: [`CREATE SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#create_schema_statement) statement. * `CREATE_SNAPSHOT_TABLE`: [`CREATE SNAPSHOT TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_snapshot_table_statement) statement. * `CREATE_SEARCH_INDEX`: [`CREATE SEARCH INDEX`](/bigquery/docs/reference/standard-sql/data-definition-language#create_search_index_statement) statement. * `DROP_TABLE`: [`DROP TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_statement) statement. * `DROP_EXTERNAL_TABLE`: [`DROP EXTERNAL TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_external_table_statement) statement. * `DROP_VIEW`: [`DROP VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_statement) statement. * `DROP_MODEL`: [`DROP MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) statement. * `DROP_MATERIALIZED_VIEW`: [`DROP MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_materialized_view_statement) statement. * `DROP_FUNCTION` : [`DROP FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_function_statement) statement. * `DROP_TABLE_FUNCTION` : [`DROP TABLE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_function) statement. * `DROP_PROCEDURE`: [`DROP PROCEDURE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedure_statement) statement. * `DROP_SEARCH_INDEX`: [`DROP SEARCH INDEX`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_index) statement. * `DROP_SCHEMA`: [`DROP SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_statement) statement. * `DROP_SNAPSHOT_TABLE`: [`DROP SNAPSHOT TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot_table_statement) statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP [ALL] ROW ACCESS POLICY|POLICIES`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_access_policy_statement) statement. * `ALTER_TABLE`: [`ALTER TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_set_options_statement) statement. * `ALTER_VIEW`: [`ALTER VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_set_options_statement) statement. * `ALTER_MATERIALIZED_VIEW`: [`ALTER MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) statement. * `ALTER_SCHEMA`: [`ALTER SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema_set_options_statement) statement. * `SCRIPT`: [`SCRIPT`](/bigquery/docs/reference/standard-sql/procedural-language). * `TRUNCATE_TABLE`: [`TRUNCATE TABLE`](/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) statement. * `CREATE_EXTERNAL_TABLE`: [`CREATE EXTERNAL TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_external_table_statement) statement. * `EXPORT_DATA`: [`EXPORT DATA`](/bigquery/docs/reference/standard-sql/other-statements#export_data_statement) statement. * `EXPORT_MODEL`: [`EXPORT MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) statement. * `LOAD_DATA`: [`LOAD DATA`](/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) statement. * `CALL`: [`CALL`](/bigquery/docs/reference/standard-sql/procedural-language#call) statement.
+        "statementType": "A String", # Output only. The type of query statement, if valid. Possible values: * `SELECT`: [`SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#select_list) statement. * `ASSERT`: [`ASSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/debugging-statements#assert) statement. * `INSERT`: [`INSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) statement. * `UPDATE`: [`UPDATE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#update_statement) statement. * `DELETE`: [`DELETE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `MERGE`: [`MERGE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `CREATE_TABLE`: [`CREATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: [`CREATE TABLE AS SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#query_statement) statement. * `CREATE_VIEW`: [`CREATE VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) statement. * `CREATE_MODEL`: [`CREATE MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_model_statement) statement. * `CREATE_MATERIALIZED_VIEW`: [`CREATE MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_materialized_view_statement) statement. * `CREATE_FUNCTION`: [`CREATE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_function_statement) statement. * `CREATE_TABLE_FUNCTION`: [`CREATE TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_function_statement) statement. * `CREATE_PROCEDURE`: [`CREATE PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_procedure) statement. * `CREATE_ROW_ACCESS_POLICY`: [`CREATE ROW ACCESS POLICY`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_row_access_policy_statement) statement. * `CREATE_SCHEMA`: [`CREATE SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_schema_statement) statement. * `CREATE_SNAPSHOT_TABLE`: [`CREATE SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_snapshot_table_statement) statement. * `CREATE_SEARCH_INDEX`: [`CREATE SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_search_index_statement) statement. * `DROP_TABLE`: [`DROP TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_statement) statement. * `DROP_EXTERNAL_TABLE`: [`DROP EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_external_table_statement) statement. * `DROP_VIEW`: [`DROP VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_statement) statement. * `DROP_MODEL`: [`DROP MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) statement. * `DROP_MATERIALIZED_VIEW`: [`DROP MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_materialized_view_statement) statement. * `DROP_FUNCTION` : [`DROP FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_function_statement) statement. * `DROP_TABLE_FUNCTION` : [`DROP TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_function) statement. * `DROP_PROCEDURE`: [`DROP PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedure_statement) statement. * `DROP_SEARCH_INDEX`: [`DROP SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_index) statement. * `DROP_SCHEMA`: [`DROP SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_statement) statement. * `DROP_SNAPSHOT_TABLE`: [`DROP SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot_table_statement) statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP [ALL] ROW ACCESS POLICY|POLICIES`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_access_policy_statement) statement. * `ALTER_TABLE`: [`ALTER TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_set_options_statement) statement. * `ALTER_VIEW`: [`ALTER VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_set_options_statement) statement. * `ALTER_MATERIALIZED_VIEW`: [`ALTER MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) statement. * `ALTER_SCHEMA`: [`ALTER SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema_set_options_statement) statement. * `SCRIPT`: [`SCRIPT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language). * `TRUNCATE_TABLE`: [`TRUNCATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) statement. * `CREATE_EXTERNAL_TABLE`: [`CREATE EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_external_table_statement) statement. * `EXPORT_DATA`: [`EXPORT DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#export_data_statement) statement. * `EXPORT_MODEL`: [`EXPORT MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) statement. * `LOAD_DATA`: [`LOAD DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) statement. * `CALL`: [`CALL`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language#call) statement.
         "timeline": [ # Output only. Describes a timeline of job execution.
           { # Summary of the state of query execution at a given time.
             "activeUnits": "A String", # Total number of active workers. This does not correspond directly to slot usage. This is the largest value observed since the last sample.
@@ -1574,7 +1574,7 @@ Method Details
       ],
       "fieldDelimiter": "A String", # Optional. When extracting data in CSV format, this defines the delimiter to use between fields in the exported data. Default is ','. Not applicable when extracting models.
       "modelExtractOptions": { # Options related to model extraction. # Optional. Model extract options only applicable when extracting models.
-        "trialId": "A String", # The 1-based ID of the trial to be exported from a hyperparameter tuning model. If not specified, the trial with id = [Model](/bigquery/docs/reference/rest/v2/models#resource:-model).defaultTrialId is exported. This field is ignored for models not trained with hyperparameter tuning.
+        "trialId": "A String", # The 1-based ID of the trial to be exported from a hyperparameter tuning model. If not specified, the trial with id = [Model](https://cloud.google.com/bigquery/docs/reference/rest/v2/models#resource:-model).defaultTrialId is exported. This field is ignored for models not trained with hyperparameter tuning.
       },
       "printHeader": true, # Optional. Whether to print out a header row in the results. Default is true. Not applicable when extracting models.
       "sourceModel": { # Id path of a model. # A reference to the model being exported.
@@ -1964,7 +1964,7 @@ Method Details
   },
   "etag": "A String", # Output only. A hash of this resource.
   "id": "A String", # Output only. Opaque ID field of the job.
-  "jobCreationReason": { # Reason about why a Job was created from a [`jobs.query`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query) method when used with `JOB_CREATION_OPTIONAL` Job creation mode. For [`jobs.insert`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/insert) method calls it will always be `REQUESTED`. [Preview](/products/#product-launch-stages) # Output only. The reason why a Job was created. [Preview](/products/#product-launch-stages)
+  "jobCreationReason": { # Reason about why a Job was created from a [`jobs.query`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query) method when used with `JOB_CREATION_OPTIONAL` Job creation mode. For [`jobs.insert`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/insert) method calls it will always be `REQUESTED`. [Preview](https://cloud.google.com/products/#product-launch-stages) # Output only. The reason why a Job was created. [Preview](https://cloud.google.com/products/#product-launch-stages)
     "code": "A String", # Output only. Specifies the high level reason why a Job was created.
   },
   "jobReference": { # A job reference is a fully qualified identifier for referring to a job. # Optional. Reference describing the unique-per-user name of the job.
@@ -2128,14 +2128,14 @@ Method Details
               "projectId": "A String", # Required. The ID of the project containing this table.
               "tableId": "A String", # Required. The ID of the table. The ID can contain Unicode characters in category L (letter), M (mark), N (number), Pc (connector, including underscore), Pd (dash), and Zs (space). For more information, see [General Category](https://wikipedia.org/wiki/Unicode_character_property#General_Category). The maximum length is 1,024 characters. Certain operations allow suffixing of the table ID with a partition decorator, such as `sample_table$20190123`.
             },
-            "tableType": "A String", # [Table type](/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.type).
+            "tableType": "A String", # [Table type](https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.type).
             "unusedReason": "A String", # Reason for not using metadata caching for the table.
           },
         ],
       },
       "mlStatistics": { # Job statistics specific to a BigQuery ML training job. # Output only. Statistics of a BigQuery ML training job.
-        "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning job](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) sorted by trial_id.
-          { # Training info of a trial in [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
+        "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning job](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) sorted by trial_id.
+          { # Training info of a trial in [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
             "endTimeMs": "A String", # Ending time of the trial.
             "errorMessage": "A String", # Error message for FAILED and INFEASIBLE trial.
             "evalLoss": 3.14, # Loss computed on the eval data at the end of trial.
@@ -2541,7 +2541,7 @@ Method Details
             "trialId": "A String", # 1-based index of the trial.
           },
         ],
-        "iterationResults": [ # Results for all completed iterations. Empty for [hyperparameter tuning jobs](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview).
+        "iterationResults": [ # Results for all completed iterations. Empty for [hyperparameter tuning jobs](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview).
           { # Information about a single iteration of the training run.
             "arimaResult": { # (Auto-)arima fitting result. Wrap everything in ArimaResult for easier refactoring if we want to use model-specific iteration results. # Arima result.
               "arimaModelInfo": [ # This message is repeated because there are multiple arima models fitted in auto-arima. For non-auto-arima model, its size is one.
@@ -2792,7 +2792,7 @@ Method Details
         "sparkJobId": "A String", # Output only. Spark job ID if a Spark job is created successfully.
         "sparkJobLocation": "A String", # Output only. Location where the Spark job is executed. A location is selected by BigQueury for jobs configured to run in a multi-region.
       },
-      "statementType": "A String", # Output only. The type of query statement, if valid. Possible values: * `SELECT`: [`SELECT`](/bigquery/docs/reference/standard-sql/query-syntax#select_list) statement. * `ASSERT`: [`ASSERT`](/bigquery/docs/reference/standard-sql/debugging-statements#assert) statement. * `INSERT`: [`INSERT`](/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) statement. * `UPDATE`: [`UPDATE`](/bigquery/docs/reference/standard-sql/query-syntax#update_statement) statement. * `DELETE`: [`DELETE`](/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `MERGE`: [`MERGE`](/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `CREATE_TABLE`: [`CREATE TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: [`CREATE TABLE AS SELECT`](/bigquery/docs/reference/standard-sql/data-definition-language#query_statement) statement. * `CREATE_VIEW`: [`CREATE VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) statement. * `CREATE_MODEL`: [`CREATE MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_model_statement) statement. * `CREATE_MATERIALIZED_VIEW`: [`CREATE MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#create_materialized_view_statement) statement. * `CREATE_FUNCTION`: [`CREATE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#create_function_statement) statement. * `CREATE_TABLE_FUNCTION`: [`CREATE TABLE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#create_table_function_statement) statement. * `CREATE_PROCEDURE`: [`CREATE PROCEDURE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_procedure) statement. * `CREATE_ROW_ACCESS_POLICY`: [`CREATE ROW ACCESS POLICY`](/bigquery/docs/reference/standard-sql/data-definition-language#create_row_access_policy_statement) statement. * `CREATE_SCHEMA`: [`CREATE SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#create_schema_statement) statement. * `CREATE_SNAPSHOT_TABLE`: [`CREATE SNAPSHOT TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_snapshot_table_statement) statement. * `CREATE_SEARCH_INDEX`: [`CREATE SEARCH INDEX`](/bigquery/docs/reference/standard-sql/data-definition-language#create_search_index_statement) statement. * `DROP_TABLE`: [`DROP TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_statement) statement. * `DROP_EXTERNAL_TABLE`: [`DROP EXTERNAL TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_external_table_statement) statement. * `DROP_VIEW`: [`DROP VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_statement) statement. * `DROP_MODEL`: [`DROP MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) statement. * `DROP_MATERIALIZED_VIEW`: [`DROP MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_materialized_view_statement) statement. * `DROP_FUNCTION` : [`DROP FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_function_statement) statement. * `DROP_TABLE_FUNCTION` : [`DROP TABLE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_function) statement. * `DROP_PROCEDURE`: [`DROP PROCEDURE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedure_statement) statement. * `DROP_SEARCH_INDEX`: [`DROP SEARCH INDEX`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_index) statement. * `DROP_SCHEMA`: [`DROP SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_statement) statement. * `DROP_SNAPSHOT_TABLE`: [`DROP SNAPSHOT TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot_table_statement) statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP [ALL] ROW ACCESS POLICY|POLICIES`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_access_policy_statement) statement. * `ALTER_TABLE`: [`ALTER TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_set_options_statement) statement. * `ALTER_VIEW`: [`ALTER VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_set_options_statement) statement. * `ALTER_MATERIALIZED_VIEW`: [`ALTER MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) statement. * `ALTER_SCHEMA`: [`ALTER SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema_set_options_statement) statement. * `SCRIPT`: [`SCRIPT`](/bigquery/docs/reference/standard-sql/procedural-language). * `TRUNCATE_TABLE`: [`TRUNCATE TABLE`](/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) statement. * `CREATE_EXTERNAL_TABLE`: [`CREATE EXTERNAL TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_external_table_statement) statement. * `EXPORT_DATA`: [`EXPORT DATA`](/bigquery/docs/reference/standard-sql/other-statements#export_data_statement) statement. * `EXPORT_MODEL`: [`EXPORT MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) statement. * `LOAD_DATA`: [`LOAD DATA`](/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) statement. * `CALL`: [`CALL`](/bigquery/docs/reference/standard-sql/procedural-language#call) statement.
+      "statementType": "A String", # Output only. The type of query statement, if valid. Possible values: * `SELECT`: [`SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#select_list) statement. * `ASSERT`: [`ASSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/debugging-statements#assert) statement. * `INSERT`: [`INSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) statement. * `UPDATE`: [`UPDATE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#update_statement) statement. * `DELETE`: [`DELETE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `MERGE`: [`MERGE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `CREATE_TABLE`: [`CREATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: [`CREATE TABLE AS SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#query_statement) statement. * `CREATE_VIEW`: [`CREATE VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) statement. * `CREATE_MODEL`: [`CREATE MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_model_statement) statement. * `CREATE_MATERIALIZED_VIEW`: [`CREATE MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_materialized_view_statement) statement. * `CREATE_FUNCTION`: [`CREATE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_function_statement) statement. * `CREATE_TABLE_FUNCTION`: [`CREATE TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_function_statement) statement. * `CREATE_PROCEDURE`: [`CREATE PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_procedure) statement. * `CREATE_ROW_ACCESS_POLICY`: [`CREATE ROW ACCESS POLICY`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_row_access_policy_statement) statement. * `CREATE_SCHEMA`: [`CREATE SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_schema_statement) statement. * `CREATE_SNAPSHOT_TABLE`: [`CREATE SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_snapshot_table_statement) statement. * `CREATE_SEARCH_INDEX`: [`CREATE SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_search_index_statement) statement. * `DROP_TABLE`: [`DROP TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_statement) statement. * `DROP_EXTERNAL_TABLE`: [`DROP EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_external_table_statement) statement. * `DROP_VIEW`: [`DROP VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_statement) statement. * `DROP_MODEL`: [`DROP MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) statement. * `DROP_MATERIALIZED_VIEW`: [`DROP MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_materialized_view_statement) statement. * `DROP_FUNCTION` : [`DROP FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_function_statement) statement. * `DROP_TABLE_FUNCTION` : [`DROP TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_function) statement. * `DROP_PROCEDURE`: [`DROP PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedure_statement) statement. * `DROP_SEARCH_INDEX`: [`DROP SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_index) statement. * `DROP_SCHEMA`: [`DROP SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_statement) statement. * `DROP_SNAPSHOT_TABLE`: [`DROP SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot_table_statement) statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP [ALL] ROW ACCESS POLICY|POLICIES`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_access_policy_statement) statement. * `ALTER_TABLE`: [`ALTER TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_set_options_statement) statement. * `ALTER_VIEW`: [`ALTER VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_set_options_statement) statement. * `ALTER_MATERIALIZED_VIEW`: [`ALTER MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) statement. * `ALTER_SCHEMA`: [`ALTER SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema_set_options_statement) statement. * `SCRIPT`: [`SCRIPT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language). * `TRUNCATE_TABLE`: [`TRUNCATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) statement. * `CREATE_EXTERNAL_TABLE`: [`CREATE EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_external_table_statement) statement. * `EXPORT_DATA`: [`EXPORT DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#export_data_statement) statement. * `EXPORT_MODEL`: [`EXPORT MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) statement. * `LOAD_DATA`: [`LOAD DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) statement. * `CALL`: [`CALL`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language#call) statement.
       "timeline": [ # Output only. Describes a timeline of job execution.
         { # Summary of the state of query execution at a given time.
           "activeUnits": "A String", # Total number of active workers. This does not correspond directly to slot usage. This is the largest value observed since the last sample.
@@ -3069,7 +3069,7 @@ Method Details
       ],
       "fieldDelimiter": "A String", # Optional. When extracting data in CSV format, this defines the delimiter to use between fields in the exported data. Default is ','. Not applicable when extracting models.
       "modelExtractOptions": { # Options related to model extraction. # Optional. Model extract options only applicable when extracting models.
-        "trialId": "A String", # The 1-based ID of the trial to be exported from a hyperparameter tuning model. If not specified, the trial with id = [Model](/bigquery/docs/reference/rest/v2/models#resource:-model).defaultTrialId is exported. This field is ignored for models not trained with hyperparameter tuning.
+        "trialId": "A String", # The 1-based ID of the trial to be exported from a hyperparameter tuning model. If not specified, the trial with id = [Model](https://cloud.google.com/bigquery/docs/reference/rest/v2/models#resource:-model).defaultTrialId is exported. This field is ignored for models not trained with hyperparameter tuning.
       },
       "printHeader": true, # Optional. Whether to print out a header row in the results. Default is true. Not applicable when extracting models.
       "sourceModel": { # Id path of a model. # A reference to the model being exported.
@@ -3459,7 +3459,7 @@ Method Details
   },
   "etag": "A String", # Output only. A hash of this resource.
   "id": "A String", # Output only. Opaque ID field of the job.
-  "jobCreationReason": { # Reason about why a Job was created from a [`jobs.query`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query) method when used with `JOB_CREATION_OPTIONAL` Job creation mode. For [`jobs.insert`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/insert) method calls it will always be `REQUESTED`. [Preview](/products/#product-launch-stages) # Output only. The reason why a Job was created. [Preview](/products/#product-launch-stages)
+  "jobCreationReason": { # Reason about why a Job was created from a [`jobs.query`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query) method when used with `JOB_CREATION_OPTIONAL` Job creation mode. For [`jobs.insert`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/insert) method calls it will always be `REQUESTED`. [Preview](https://cloud.google.com/products/#product-launch-stages) # Output only. The reason why a Job was created. [Preview](https://cloud.google.com/products/#product-launch-stages)
     "code": "A String", # Output only. Specifies the high level reason why a Job was created.
   },
   "jobReference": { # A job reference is a fully qualified identifier for referring to a job. # Optional. Reference describing the unique-per-user name of the job.
@@ -3623,14 +3623,14 @@ Method Details
               "projectId": "A String", # Required. The ID of the project containing this table.
               "tableId": "A String", # Required. The ID of the table. The ID can contain Unicode characters in category L (letter), M (mark), N (number), Pc (connector, including underscore), Pd (dash), and Zs (space). For more information, see [General Category](https://wikipedia.org/wiki/Unicode_character_property#General_Category). The maximum length is 1,024 characters. Certain operations allow suffixing of the table ID with a partition decorator, such as `sample_table$20190123`.
             },
-            "tableType": "A String", # [Table type](/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.type).
+            "tableType": "A String", # [Table type](https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.type).
             "unusedReason": "A String", # Reason for not using metadata caching for the table.
           },
         ],
       },
       "mlStatistics": { # Job statistics specific to a BigQuery ML training job. # Output only. Statistics of a BigQuery ML training job.
-        "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning job](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) sorted by trial_id.
-          { # Training info of a trial in [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
+        "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning job](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) sorted by trial_id.
+          { # Training info of a trial in [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
             "endTimeMs": "A String", # Ending time of the trial.
             "errorMessage": "A String", # Error message for FAILED and INFEASIBLE trial.
             "evalLoss": 3.14, # Loss computed on the eval data at the end of trial.
@@ -4036,7 +4036,7 @@ Method Details
             "trialId": "A String", # 1-based index of the trial.
           },
         ],
-        "iterationResults": [ # Results for all completed iterations. Empty for [hyperparameter tuning jobs](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview).
+        "iterationResults": [ # Results for all completed iterations. Empty for [hyperparameter tuning jobs](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview).
           { # Information about a single iteration of the training run.
             "arimaResult": { # (Auto-)arima fitting result. Wrap everything in ArimaResult for easier refactoring if we want to use model-specific iteration results. # Arima result.
               "arimaModelInfo": [ # This message is repeated because there are multiple arima models fitted in auto-arima. For non-auto-arima model, its size is one.
@@ -4287,7 +4287,7 @@ Method Details
         "sparkJobId": "A String", # Output only. Spark job ID if a Spark job is created successfully.
         "sparkJobLocation": "A String", # Output only. Location where the Spark job is executed. A location is selected by BigQueury for jobs configured to run in a multi-region.
       },
-      "statementType": "A String", # Output only. The type of query statement, if valid. Possible values: * `SELECT`: [`SELECT`](/bigquery/docs/reference/standard-sql/query-syntax#select_list) statement. * `ASSERT`: [`ASSERT`](/bigquery/docs/reference/standard-sql/debugging-statements#assert) statement. * `INSERT`: [`INSERT`](/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) statement. * `UPDATE`: [`UPDATE`](/bigquery/docs/reference/standard-sql/query-syntax#update_statement) statement. * `DELETE`: [`DELETE`](/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `MERGE`: [`MERGE`](/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `CREATE_TABLE`: [`CREATE TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: [`CREATE TABLE AS SELECT`](/bigquery/docs/reference/standard-sql/data-definition-language#query_statement) statement. * `CREATE_VIEW`: [`CREATE VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) statement. * `CREATE_MODEL`: [`CREATE MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_model_statement) statement. * `CREATE_MATERIALIZED_VIEW`: [`CREATE MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#create_materialized_view_statement) statement. * `CREATE_FUNCTION`: [`CREATE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#create_function_statement) statement. * `CREATE_TABLE_FUNCTION`: [`CREATE TABLE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#create_table_function_statement) statement. * `CREATE_PROCEDURE`: [`CREATE PROCEDURE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_procedure) statement. * `CREATE_ROW_ACCESS_POLICY`: [`CREATE ROW ACCESS POLICY`](/bigquery/docs/reference/standard-sql/data-definition-language#create_row_access_policy_statement) statement. * `CREATE_SCHEMA`: [`CREATE SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#create_schema_statement) statement. * `CREATE_SNAPSHOT_TABLE`: [`CREATE SNAPSHOT TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_snapshot_table_statement) statement. * `CREATE_SEARCH_INDEX`: [`CREATE SEARCH INDEX`](/bigquery/docs/reference/standard-sql/data-definition-language#create_search_index_statement) statement. * `DROP_TABLE`: [`DROP TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_statement) statement. * `DROP_EXTERNAL_TABLE`: [`DROP EXTERNAL TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_external_table_statement) statement. * `DROP_VIEW`: [`DROP VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_statement) statement. * `DROP_MODEL`: [`DROP MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) statement. * `DROP_MATERIALIZED_VIEW`: [`DROP MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_materialized_view_statement) statement. * `DROP_FUNCTION` : [`DROP FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_function_statement) statement. * `DROP_TABLE_FUNCTION` : [`DROP TABLE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_function) statement. * `DROP_PROCEDURE`: [`DROP PROCEDURE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedure_statement) statement. * `DROP_SEARCH_INDEX`: [`DROP SEARCH INDEX`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_index) statement. * `DROP_SCHEMA`: [`DROP SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_statement) statement. * `DROP_SNAPSHOT_TABLE`: [`DROP SNAPSHOT TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot_table_statement) statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP [ALL] ROW ACCESS POLICY|POLICIES`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_access_policy_statement) statement. * `ALTER_TABLE`: [`ALTER TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_set_options_statement) statement. * `ALTER_VIEW`: [`ALTER VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_set_options_statement) statement. * `ALTER_MATERIALIZED_VIEW`: [`ALTER MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) statement. * `ALTER_SCHEMA`: [`ALTER SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema_set_options_statement) statement. * `SCRIPT`: [`SCRIPT`](/bigquery/docs/reference/standard-sql/procedural-language). * `TRUNCATE_TABLE`: [`TRUNCATE TABLE`](/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) statement. * `CREATE_EXTERNAL_TABLE`: [`CREATE EXTERNAL TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_external_table_statement) statement. * `EXPORT_DATA`: [`EXPORT DATA`](/bigquery/docs/reference/standard-sql/other-statements#export_data_statement) statement. * `EXPORT_MODEL`: [`EXPORT MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) statement. * `LOAD_DATA`: [`LOAD DATA`](/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) statement. * `CALL`: [`CALL`](/bigquery/docs/reference/standard-sql/procedural-language#call) statement.
+      "statementType": "A String", # Output only. The type of query statement, if valid. Possible values: * `SELECT`: [`SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#select_list) statement. * `ASSERT`: [`ASSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/debugging-statements#assert) statement. * `INSERT`: [`INSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) statement. * `UPDATE`: [`UPDATE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#update_statement) statement. * `DELETE`: [`DELETE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `MERGE`: [`MERGE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `CREATE_TABLE`: [`CREATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: [`CREATE TABLE AS SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#query_statement) statement. * `CREATE_VIEW`: [`CREATE VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) statement. * `CREATE_MODEL`: [`CREATE MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_model_statement) statement. * `CREATE_MATERIALIZED_VIEW`: [`CREATE MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_materialized_view_statement) statement. * `CREATE_FUNCTION`: [`CREATE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_function_statement) statement. * `CREATE_TABLE_FUNCTION`: [`CREATE TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_function_statement) statement. * `CREATE_PROCEDURE`: [`CREATE PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_procedure) statement. * `CREATE_ROW_ACCESS_POLICY`: [`CREATE ROW ACCESS POLICY`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_row_access_policy_statement) statement. * `CREATE_SCHEMA`: [`CREATE SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_schema_statement) statement. * `CREATE_SNAPSHOT_TABLE`: [`CREATE SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_snapshot_table_statement) statement. * `CREATE_SEARCH_INDEX`: [`CREATE SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_search_index_statement) statement. * `DROP_TABLE`: [`DROP TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_statement) statement. * `DROP_EXTERNAL_TABLE`: [`DROP EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_external_table_statement) statement. * `DROP_VIEW`: [`DROP VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_statement) statement. * `DROP_MODEL`: [`DROP MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) statement. * `DROP_MATERIALIZED_VIEW`: [`DROP MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_materialized_view_statement) statement. * `DROP_FUNCTION` : [`DROP FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_function_statement) statement. * `DROP_TABLE_FUNCTION` : [`DROP TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_function) statement. * `DROP_PROCEDURE`: [`DROP PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedure_statement) statement. * `DROP_SEARCH_INDEX`: [`DROP SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_index) statement. * `DROP_SCHEMA`: [`DROP SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_statement) statement. * `DROP_SNAPSHOT_TABLE`: [`DROP SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot_table_statement) statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP [ALL] ROW ACCESS POLICY|POLICIES`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_access_policy_statement) statement. * `ALTER_TABLE`: [`ALTER TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_set_options_statement) statement. * `ALTER_VIEW`: [`ALTER VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_set_options_statement) statement. * `ALTER_MATERIALIZED_VIEW`: [`ALTER MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) statement. * `ALTER_SCHEMA`: [`ALTER SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema_set_options_statement) statement. * `SCRIPT`: [`SCRIPT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language). * `TRUNCATE_TABLE`: [`TRUNCATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) statement. * `CREATE_EXTERNAL_TABLE`: [`CREATE EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_external_table_statement) statement. * `EXPORT_DATA`: [`EXPORT DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#export_data_statement) statement. * `EXPORT_MODEL`: [`EXPORT MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) statement. * `LOAD_DATA`: [`LOAD DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) statement. * `CALL`: [`CALL`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language#call) statement.
       "timeline": [ # Output only. Describes a timeline of job execution.
         { # Summary of the state of query execution at a given time.
           "activeUnits": "A String", # Total number of active workers. This does not correspond directly to slot usage. This is the largest value observed since the last sample.
@@ -4454,7 +4454,7 @@ Method Details
       ],
       "fieldDelimiter": "A String", # Optional. When extracting data in CSV format, this defines the delimiter to use between fields in the exported data. Default is ','. Not applicable when extracting models.
       "modelExtractOptions": { # Options related to model extraction. # Optional. Model extract options only applicable when extracting models.
-        "trialId": "A String", # The 1-based ID of the trial to be exported from a hyperparameter tuning model. If not specified, the trial with id = [Model](/bigquery/docs/reference/rest/v2/models#resource:-model).defaultTrialId is exported. This field is ignored for models not trained with hyperparameter tuning.
+        "trialId": "A String", # The 1-based ID of the trial to be exported from a hyperparameter tuning model. If not specified, the trial with id = [Model](https://cloud.google.com/bigquery/docs/reference/rest/v2/models#resource:-model).defaultTrialId is exported. This field is ignored for models not trained with hyperparameter tuning.
       },
       "printHeader": true, # Optional. Whether to print out a header row in the results. Default is true. Not applicable when extracting models.
       "sourceModel": { # Id path of a model. # A reference to the model being exported.
@@ -4844,7 +4844,7 @@ Method Details
   },
   "etag": "A String", # Output only. A hash of this resource.
   "id": "A String", # Output only. Opaque ID field of the job.
-  "jobCreationReason": { # Reason about why a Job was created from a [`jobs.query`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query) method when used with `JOB_CREATION_OPTIONAL` Job creation mode. For [`jobs.insert`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/insert) method calls it will always be `REQUESTED`. [Preview](/products/#product-launch-stages) # Output only. The reason why a Job was created. [Preview](/products/#product-launch-stages)
+  "jobCreationReason": { # Reason about why a Job was created from a [`jobs.query`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query) method when used with `JOB_CREATION_OPTIONAL` Job creation mode. For [`jobs.insert`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/insert) method calls it will always be `REQUESTED`. [Preview](https://cloud.google.com/products/#product-launch-stages) # Output only. The reason why a Job was created. [Preview](https://cloud.google.com/products/#product-launch-stages)
     "code": "A String", # Output only. Specifies the high level reason why a Job was created.
   },
   "jobReference": { # A job reference is a fully qualified identifier for referring to a job. # Optional. Reference describing the unique-per-user name of the job.
@@ -5008,14 +5008,14 @@ Method Details
               "projectId": "A String", # Required. The ID of the project containing this table.
               "tableId": "A String", # Required. The ID of the table. The ID can contain Unicode characters in category L (letter), M (mark), N (number), Pc (connector, including underscore), Pd (dash), and Zs (space). For more information, see [General Category](https://wikipedia.org/wiki/Unicode_character_property#General_Category). The maximum length is 1,024 characters. Certain operations allow suffixing of the table ID with a partition decorator, such as `sample_table$20190123`.
             },
-            "tableType": "A String", # [Table type](/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.type).
+            "tableType": "A String", # [Table type](https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.type).
             "unusedReason": "A String", # Reason for not using metadata caching for the table.
           },
         ],
       },
       "mlStatistics": { # Job statistics specific to a BigQuery ML training job. # Output only. Statistics of a BigQuery ML training job.
-        "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning job](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) sorted by trial_id.
-          { # Training info of a trial in [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
+        "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning job](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) sorted by trial_id.
+          { # Training info of a trial in [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
             "endTimeMs": "A String", # Ending time of the trial.
             "errorMessage": "A String", # Error message for FAILED and INFEASIBLE trial.
             "evalLoss": 3.14, # Loss computed on the eval data at the end of trial.
@@ -5421,7 +5421,7 @@ Method Details
             "trialId": "A String", # 1-based index of the trial.
           },
         ],
-        "iterationResults": [ # Results for all completed iterations. Empty for [hyperparameter tuning jobs](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview).
+        "iterationResults": [ # Results for all completed iterations. Empty for [hyperparameter tuning jobs](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview).
           { # Information about a single iteration of the training run.
             "arimaResult": { # (Auto-)arima fitting result. Wrap everything in ArimaResult for easier refactoring if we want to use model-specific iteration results. # Arima result.
               "arimaModelInfo": [ # This message is repeated because there are multiple arima models fitted in auto-arima. For non-auto-arima model, its size is one.
@@ -5672,7 +5672,7 @@ Method Details
         "sparkJobId": "A String", # Output only. Spark job ID if a Spark job is created successfully.
         "sparkJobLocation": "A String", # Output only. Location where the Spark job is executed. A location is selected by BigQueury for jobs configured to run in a multi-region.
       },
-      "statementType": "A String", # Output only. The type of query statement, if valid. Possible values: * `SELECT`: [`SELECT`](/bigquery/docs/reference/standard-sql/query-syntax#select_list) statement. * `ASSERT`: [`ASSERT`](/bigquery/docs/reference/standard-sql/debugging-statements#assert) statement. * `INSERT`: [`INSERT`](/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) statement. * `UPDATE`: [`UPDATE`](/bigquery/docs/reference/standard-sql/query-syntax#update_statement) statement. * `DELETE`: [`DELETE`](/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `MERGE`: [`MERGE`](/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `CREATE_TABLE`: [`CREATE TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: [`CREATE TABLE AS SELECT`](/bigquery/docs/reference/standard-sql/data-definition-language#query_statement) statement. * `CREATE_VIEW`: [`CREATE VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) statement. * `CREATE_MODEL`: [`CREATE MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_model_statement) statement. * `CREATE_MATERIALIZED_VIEW`: [`CREATE MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#create_materialized_view_statement) statement. * `CREATE_FUNCTION`: [`CREATE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#create_function_statement) statement. * `CREATE_TABLE_FUNCTION`: [`CREATE TABLE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#create_table_function_statement) statement. * `CREATE_PROCEDURE`: [`CREATE PROCEDURE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_procedure) statement. * `CREATE_ROW_ACCESS_POLICY`: [`CREATE ROW ACCESS POLICY`](/bigquery/docs/reference/standard-sql/data-definition-language#create_row_access_policy_statement) statement. * `CREATE_SCHEMA`: [`CREATE SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#create_schema_statement) statement. * `CREATE_SNAPSHOT_TABLE`: [`CREATE SNAPSHOT TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_snapshot_table_statement) statement. * `CREATE_SEARCH_INDEX`: [`CREATE SEARCH INDEX`](/bigquery/docs/reference/standard-sql/data-definition-language#create_search_index_statement) statement. * `DROP_TABLE`: [`DROP TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_statement) statement. * `DROP_EXTERNAL_TABLE`: [`DROP EXTERNAL TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_external_table_statement) statement. * `DROP_VIEW`: [`DROP VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_statement) statement. * `DROP_MODEL`: [`DROP MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) statement. * `DROP_MATERIALIZED_VIEW`: [`DROP MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_materialized_view_statement) statement. * `DROP_FUNCTION` : [`DROP FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_function_statement) statement. * `DROP_TABLE_FUNCTION` : [`DROP TABLE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_function) statement. * `DROP_PROCEDURE`: [`DROP PROCEDURE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedure_statement) statement. * `DROP_SEARCH_INDEX`: [`DROP SEARCH INDEX`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_index) statement. * `DROP_SCHEMA`: [`DROP SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_statement) statement. * `DROP_SNAPSHOT_TABLE`: [`DROP SNAPSHOT TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot_table_statement) statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP [ALL] ROW ACCESS POLICY|POLICIES`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_access_policy_statement) statement. * `ALTER_TABLE`: [`ALTER TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_set_options_statement) statement. * `ALTER_VIEW`: [`ALTER VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_set_options_statement) statement. * `ALTER_MATERIALIZED_VIEW`: [`ALTER MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) statement. * `ALTER_SCHEMA`: [`ALTER SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema_set_options_statement) statement. * `SCRIPT`: [`SCRIPT`](/bigquery/docs/reference/standard-sql/procedural-language). * `TRUNCATE_TABLE`: [`TRUNCATE TABLE`](/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) statement. * `CREATE_EXTERNAL_TABLE`: [`CREATE EXTERNAL TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_external_table_statement) statement. * `EXPORT_DATA`: [`EXPORT DATA`](/bigquery/docs/reference/standard-sql/other-statements#export_data_statement) statement. * `EXPORT_MODEL`: [`EXPORT MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) statement. * `LOAD_DATA`: [`LOAD DATA`](/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) statement. * `CALL`: [`CALL`](/bigquery/docs/reference/standard-sql/procedural-language#call) statement.
+      "statementType": "A String", # Output only. The type of query statement, if valid. Possible values: * `SELECT`: [`SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#select_list) statement. * `ASSERT`: [`ASSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/debugging-statements#assert) statement. * `INSERT`: [`INSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) statement. * `UPDATE`: [`UPDATE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#update_statement) statement. * `DELETE`: [`DELETE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `MERGE`: [`MERGE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `CREATE_TABLE`: [`CREATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: [`CREATE TABLE AS SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#query_statement) statement. * `CREATE_VIEW`: [`CREATE VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) statement. * `CREATE_MODEL`: [`CREATE MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_model_statement) statement. * `CREATE_MATERIALIZED_VIEW`: [`CREATE MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_materialized_view_statement) statement. * `CREATE_FUNCTION`: [`CREATE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_function_statement) statement. * `CREATE_TABLE_FUNCTION`: [`CREATE TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_function_statement) statement. * `CREATE_PROCEDURE`: [`CREATE PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_procedure) statement. * `CREATE_ROW_ACCESS_POLICY`: [`CREATE ROW ACCESS POLICY`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_row_access_policy_statement) statement. * `CREATE_SCHEMA`: [`CREATE SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_schema_statement) statement. * `CREATE_SNAPSHOT_TABLE`: [`CREATE SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_snapshot_table_statement) statement. * `CREATE_SEARCH_INDEX`: [`CREATE SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_search_index_statement) statement. * `DROP_TABLE`: [`DROP TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_statement) statement. * `DROP_EXTERNAL_TABLE`: [`DROP EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_external_table_statement) statement. * `DROP_VIEW`: [`DROP VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_statement) statement. * `DROP_MODEL`: [`DROP MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) statement. * `DROP_MATERIALIZED_VIEW`: [`DROP MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_materialized_view_statement) statement. * `DROP_FUNCTION` : [`DROP FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_function_statement) statement. * `DROP_TABLE_FUNCTION` : [`DROP TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_function) statement. * `DROP_PROCEDURE`: [`DROP PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedure_statement) statement. * `DROP_SEARCH_INDEX`: [`DROP SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_index) statement. * `DROP_SCHEMA`: [`DROP SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_statement) statement. * `DROP_SNAPSHOT_TABLE`: [`DROP SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot_table_statement) statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP [ALL] ROW ACCESS POLICY|POLICIES`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_access_policy_statement) statement. * `ALTER_TABLE`: [`ALTER TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_set_options_statement) statement. * `ALTER_VIEW`: [`ALTER VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_set_options_statement) statement. * `ALTER_MATERIALIZED_VIEW`: [`ALTER MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) statement. * `ALTER_SCHEMA`: [`ALTER SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema_set_options_statement) statement. * `SCRIPT`: [`SCRIPT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language). * `TRUNCATE_TABLE`: [`TRUNCATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) statement. * `CREATE_EXTERNAL_TABLE`: [`CREATE EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_external_table_statement) statement. * `EXPORT_DATA`: [`EXPORT DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#export_data_statement) statement. * `EXPORT_MODEL`: [`EXPORT MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) statement. * `LOAD_DATA`: [`LOAD DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) statement. * `CALL`: [`CALL`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language#call) statement.
       "timeline": [ # Output only. Describes a timeline of job execution.
         { # Summary of the state of query execution at a given time.
           "activeUnits": "A String", # Total number of active workers. This does not correspond directly to slot usage. This is the largest value observed since the last sample.
@@ -5862,7 +5862,7 @@ Method Details
           ],
           "fieldDelimiter": "A String", # Optional. When extracting data in CSV format, this defines the delimiter to use between fields in the exported data. Default is ','. Not applicable when extracting models.
           "modelExtractOptions": { # Options related to model extraction. # Optional. Model extract options only applicable when extracting models.
-            "trialId": "A String", # The 1-based ID of the trial to be exported from a hyperparameter tuning model. If not specified, the trial with id = [Model](/bigquery/docs/reference/rest/v2/models#resource:-model).defaultTrialId is exported. This field is ignored for models not trained with hyperparameter tuning.
+            "trialId": "A String", # The 1-based ID of the trial to be exported from a hyperparameter tuning model. If not specified, the trial with id = [Model](https://cloud.google.com/bigquery/docs/reference/rest/v2/models#resource:-model).defaultTrialId is exported. This field is ignored for models not trained with hyperparameter tuning.
           },
           "printHeader": true, # Optional. Whether to print out a header row in the results. Default is true. Not applicable when extracting models.
           "sourceModel": { # Id path of a model. # A reference to the model being exported.
@@ -6418,14 +6418,14 @@ Method Details
                   "projectId": "A String", # Required. The ID of the project containing this table.
                   "tableId": "A String", # Required. The ID of the table. The ID can contain Unicode characters in category L (letter), M (mark), N (number), Pc (connector, including underscore), Pd (dash), and Zs (space). For more information, see [General Category](https://wikipedia.org/wiki/Unicode_character_property#General_Category). The maximum length is 1,024 characters. Certain operations allow suffixing of the table ID with a partition decorator, such as `sample_table$20190123`.
                 },
-                "tableType": "A String", # [Table type](/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.type).
+                "tableType": "A String", # [Table type](https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.type).
                 "unusedReason": "A String", # Reason for not using metadata caching for the table.
               },
             ],
           },
           "mlStatistics": { # Job statistics specific to a BigQuery ML training job. # Output only. Statistics of a BigQuery ML training job.
-            "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning job](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) sorted by trial_id.
-              { # Training info of a trial in [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
+            "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning job](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) sorted by trial_id.
+              { # Training info of a trial in [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
                 "endTimeMs": "A String", # Ending time of the trial.
                 "errorMessage": "A String", # Error message for FAILED and INFEASIBLE trial.
                 "evalLoss": 3.14, # Loss computed on the eval data at the end of trial.
@@ -6831,7 +6831,7 @@ Method Details
                 "trialId": "A String", # 1-based index of the trial.
               },
             ],
-            "iterationResults": [ # Results for all completed iterations. Empty for [hyperparameter tuning jobs](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview).
+            "iterationResults": [ # Results for all completed iterations. Empty for [hyperparameter tuning jobs](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview).
               { # Information about a single iteration of the training run.
                 "arimaResult": { # (Auto-)arima fitting result. Wrap everything in ArimaResult for easier refactoring if we want to use model-specific iteration results. # Arima result.
                   "arimaModelInfo": [ # This message is repeated because there are multiple arima models fitted in auto-arima. For non-auto-arima model, its size is one.
@@ -7082,7 +7082,7 @@ Method Details
             "sparkJobId": "A String", # Output only. Spark job ID if a Spark job is created successfully.
             "sparkJobLocation": "A String", # Output only. Location where the Spark job is executed. A location is selected by BigQueury for jobs configured to run in a multi-region.
           },
-          "statementType": "A String", # Output only. The type of query statement, if valid. Possible values: * `SELECT`: [`SELECT`](/bigquery/docs/reference/standard-sql/query-syntax#select_list) statement. * `ASSERT`: [`ASSERT`](/bigquery/docs/reference/standard-sql/debugging-statements#assert) statement. * `INSERT`: [`INSERT`](/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) statement. * `UPDATE`: [`UPDATE`](/bigquery/docs/reference/standard-sql/query-syntax#update_statement) statement. * `DELETE`: [`DELETE`](/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `MERGE`: [`MERGE`](/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `CREATE_TABLE`: [`CREATE TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: [`CREATE TABLE AS SELECT`](/bigquery/docs/reference/standard-sql/data-definition-language#query_statement) statement. * `CREATE_VIEW`: [`CREATE VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) statement. * `CREATE_MODEL`: [`CREATE MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_model_statement) statement. * `CREATE_MATERIALIZED_VIEW`: [`CREATE MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#create_materialized_view_statement) statement. * `CREATE_FUNCTION`: [`CREATE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#create_function_statement) statement. * `CREATE_TABLE_FUNCTION`: [`CREATE TABLE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#create_table_function_statement) statement. * `CREATE_PROCEDURE`: [`CREATE PROCEDURE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_procedure) statement. * `CREATE_ROW_ACCESS_POLICY`: [`CREATE ROW ACCESS POLICY`](/bigquery/docs/reference/standard-sql/data-definition-language#create_row_access_policy_statement) statement. * `CREATE_SCHEMA`: [`CREATE SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#create_schema_statement) statement. * `CREATE_SNAPSHOT_TABLE`: [`CREATE SNAPSHOT TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_snapshot_table_statement) statement. * `CREATE_SEARCH_INDEX`: [`CREATE SEARCH INDEX`](/bigquery/docs/reference/standard-sql/data-definition-language#create_search_index_statement) statement. * `DROP_TABLE`: [`DROP TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_statement) statement. * `DROP_EXTERNAL_TABLE`: [`DROP EXTERNAL TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_external_table_statement) statement. * `DROP_VIEW`: [`DROP VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_statement) statement. * `DROP_MODEL`: [`DROP MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) statement. * `DROP_MATERIALIZED_VIEW`: [`DROP MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_materialized_view_statement) statement. * `DROP_FUNCTION` : [`DROP FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_function_statement) statement. * `DROP_TABLE_FUNCTION` : [`DROP TABLE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_function) statement. * `DROP_PROCEDURE`: [`DROP PROCEDURE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedure_statement) statement. * `DROP_SEARCH_INDEX`: [`DROP SEARCH INDEX`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_index) statement. * `DROP_SCHEMA`: [`DROP SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_statement) statement. * `DROP_SNAPSHOT_TABLE`: [`DROP SNAPSHOT TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot_table_statement) statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP [ALL] ROW ACCESS POLICY|POLICIES`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_access_policy_statement) statement. * `ALTER_TABLE`: [`ALTER TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_set_options_statement) statement. * `ALTER_VIEW`: [`ALTER VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_set_options_statement) statement. * `ALTER_MATERIALIZED_VIEW`: [`ALTER MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) statement. * `ALTER_SCHEMA`: [`ALTER SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema_set_options_statement) statement. * `SCRIPT`: [`SCRIPT`](/bigquery/docs/reference/standard-sql/procedural-language). * `TRUNCATE_TABLE`: [`TRUNCATE TABLE`](/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) statement. * `CREATE_EXTERNAL_TABLE`: [`CREATE EXTERNAL TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_external_table_statement) statement. * `EXPORT_DATA`: [`EXPORT DATA`](/bigquery/docs/reference/standard-sql/other-statements#export_data_statement) statement. * `EXPORT_MODEL`: [`EXPORT MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) statement. * `LOAD_DATA`: [`LOAD DATA`](/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) statement. * `CALL`: [`CALL`](/bigquery/docs/reference/standard-sql/procedural-language#call) statement.
+          "statementType": "A String", # Output only. The type of query statement, if valid. Possible values: * `SELECT`: [`SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#select_list) statement. * `ASSERT`: [`ASSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/debugging-statements#assert) statement. * `INSERT`: [`INSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) statement. * `UPDATE`: [`UPDATE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#update_statement) statement. * `DELETE`: [`DELETE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `MERGE`: [`MERGE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `CREATE_TABLE`: [`CREATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: [`CREATE TABLE AS SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#query_statement) statement. * `CREATE_VIEW`: [`CREATE VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) statement. * `CREATE_MODEL`: [`CREATE MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_model_statement) statement. * `CREATE_MATERIALIZED_VIEW`: [`CREATE MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_materialized_view_statement) statement. * `CREATE_FUNCTION`: [`CREATE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_function_statement) statement. * `CREATE_TABLE_FUNCTION`: [`CREATE TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_function_statement) statement. * `CREATE_PROCEDURE`: [`CREATE PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_procedure) statement. * `CREATE_ROW_ACCESS_POLICY`: [`CREATE ROW ACCESS POLICY`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_row_access_policy_statement) statement. * `CREATE_SCHEMA`: [`CREATE SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_schema_statement) statement. * `CREATE_SNAPSHOT_TABLE`: [`CREATE SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_snapshot_table_statement) statement. * `CREATE_SEARCH_INDEX`: [`CREATE SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_search_index_statement) statement. * `DROP_TABLE`: [`DROP TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_statement) statement. * `DROP_EXTERNAL_TABLE`: [`DROP EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_external_table_statement) statement. * `DROP_VIEW`: [`DROP VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_statement) statement. * `DROP_MODEL`: [`DROP MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) statement. * `DROP_MATERIALIZED_VIEW`: [`DROP MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_materialized_view_statement) statement. * `DROP_FUNCTION` : [`DROP FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_function_statement) statement. * `DROP_TABLE_FUNCTION` : [`DROP TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_function) statement. * `DROP_PROCEDURE`: [`DROP PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedure_statement) statement. * `DROP_SEARCH_INDEX`: [`DROP SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_index) statement. * `DROP_SCHEMA`: [`DROP SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_statement) statement. * `DROP_SNAPSHOT_TABLE`: [`DROP SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot_table_statement) statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP [ALL] ROW ACCESS POLICY|POLICIES`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_access_policy_statement) statement. * `ALTER_TABLE`: [`ALTER TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_set_options_statement) statement. * `ALTER_VIEW`: [`ALTER VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_set_options_statement) statement. * `ALTER_MATERIALIZED_VIEW`: [`ALTER MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) statement. * `ALTER_SCHEMA`: [`ALTER SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema_set_options_statement) statement. * `SCRIPT`: [`SCRIPT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language). * `TRUNCATE_TABLE`: [`TRUNCATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) statement. * `CREATE_EXTERNAL_TABLE`: [`CREATE EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_external_table_statement) statement. * `EXPORT_DATA`: [`EXPORT DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#export_data_statement) statement. * `EXPORT_MODEL`: [`EXPORT MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) statement. * `LOAD_DATA`: [`LOAD DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) statement. * `CALL`: [`CALL`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language#call) statement.
           "timeline": [ # Output only. Describes a timeline of job execution.
             { # Summary of the state of query execution at a given time.
               "activeUnits": "A String", # Total number of active workers. This does not correspond directly to slot usage. This is the largest value observed since the last sample.
@@ -7249,7 +7249,7 @@ Method Details
   "formatOptions": { # Options for data format adjustments. # Optional. Output format adjustments.
     "useInt64Timestamp": True or False, # Optional. Output timestamp as usec int64. Default is false.
   },
-  "jobCreationMode": "A String", # Optional. If not set, jobs are always required. If set, the query request will follow the behavior described JobCreationMode. [Preview](/products/#product-launch-stages)
+  "jobCreationMode": "A String", # Optional. If not set, jobs are always required. If set, the query request will follow the behavior described JobCreationMode. [Preview](https://cloud.google.com/products/#product-launch-stages)
   "kind": "bigquery#queryRequest", # The resource type of the request.
   "labels": { # Optional. The labels associated with this query. Labels can be used to organize and group query jobs. Label keys and values can be no longer than 63 characters, can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. Label keys must start with a letter and each label in the list must have a different key.
     "a_key": "A String",
@@ -7320,7 +7320,7 @@ Method Details
     },
   ],
   "jobComplete": True or False, # Whether the query has completed or not. If rows or totalRows are present, this will always be true. If this is false, totalRows will not be available.
-  "jobCreationReason": { # Reason about why a Job was created from a [`jobs.query`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query) method when used with `JOB_CREATION_OPTIONAL` Job creation mode. For [`jobs.insert`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/insert) method calls it will always be `REQUESTED`. [Preview](/products/#product-launch-stages) # Optional. The reason why a Job was created. Only relevant when a job_reference is present in the response. If job_reference is not present it will always be unset. [Preview](/products/#product-launch-stages)
+  "jobCreationReason": { # Reason about why a Job was created from a [`jobs.query`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query) method when used with `JOB_CREATION_OPTIONAL` Job creation mode. For [`jobs.insert`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/insert) method calls it will always be `REQUESTED`. [Preview](https://cloud.google.com/products/#product-launch-stages) # Optional. The reason why a Job was created. Only relevant when a job_reference is present in the response. If job_reference is not present it will always be unset. [Preview](https://cloud.google.com/products/#product-launch-stages)
     "code": "A String", # Output only. Specifies the high level reason why a Job was created.
   },
   "jobReference": { # A job reference is a fully qualified identifier for referring to a job. # Reference to the Job that was created to run the query. This field will be present even if the original request timed out, in which case GetQueryResults can be used to read the results once the query has completed. Since this API only returns the first page of results, subsequent pages can be fetched via the same mechanism (GetQueryResults). If job_creation_mode was set to `JOB_CREATION_OPTIONAL` and the query completes without creating a job, this field will be empty.
@@ -7331,7 +7331,7 @@ Method Details
   "kind": "bigquery#queryResponse", # The resource type.
   "numDmlAffectedRows": "A String", # Output only. The number of rows affected by a DML statement. Present only for DML statements INSERT, UPDATE or DELETE.
   "pageToken": "A String", # A token used for paging results. A non-empty token indicates that additional results are available. To see additional results, query the [`jobs.getQueryResults`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/getQueryResults) method. For more information, see [Paging through table data](https://cloud.google.com/bigquery/docs/paging-results).
-  "queryId": "A String", # Auto-generated ID for the query. [Preview](/products/#product-launch-stages)
+  "queryId": "A String", # Auto-generated ID for the query. [Preview](https://cloud.google.com/products/#product-launch-stages)
   "rows": [ # An object with as many results as can be contained within the maximum permitted reply size. To get any additional rows, you can call GetQueryResults and specify the jobReference returned above.
     {
       "f": [ # Represents a single row in the result set, consisting of one or more fields.
diff --git a/docs/dyn/bigquery_v2.models.html b/docs/dyn/bigquery_v2.models.html
index f6ffbcc32f7..989e4660da6 100644
--- a/docs/dyn/bigquery_v2.models.html
+++ b/docs/dyn/bigquery_v2.models.html
@@ -132,7 +132,7 @@ Method Details
     {
   "bestTrialId": "A String", # The best trial_id across all training runs.
   "creationTime": "A String", # Output only. The time when this model was created, in millisecs since the epoch.
-  "defaultTrialId": "A String", # Output only. The default trial_id to use in TVFs when the trial_id is not passed in. For single-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the best trial ID. For multi-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the smallest trial ID among all Pareto optimal trials.
+  "defaultTrialId": "A String", # Output only. The default trial_id to use in TVFs when the trial_id is not passed in. For single-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the best trial ID. For multi-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the smallest trial ID among all Pareto optimal trials.
   "description": "A String", # Optional. A user-friendly description of this model.
   "encryptionConfiguration": { # Configuration for Cloud KMS encryption settings. # Custom encryption configuration (e.g., Cloud KMS keys). This shows the encryption configuration of the model data while stored in BigQuery storage. This field can be used with PatchModel to update encryption key for an already encrypted model.
     "kmsKeyName": "A String", # Optional. Describes the Cloud KMS encryption key that will be used to protect destination BigQuery table. The BigQuery Service Account associated with your project requires access to this encryption key.
@@ -358,8 +358,8 @@ Method Details
       },
     },
   },
-  "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) model sorted by trial_id.
-    { # Training info of a trial in [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
+  "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) model sorted by trial_id.
+    { # Training info of a trial in [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
       "endTimeMs": "A String", # Ending time of the trial.
       "errorMessage": "A String", # Error message for FAILED and INFEASIBLE trial.
       "evalLoss": 3.14, # Loss computed on the eval data at the end of trial.
@@ -782,7 +782,7 @@ Method Details
     "projectId": "A String", # Required. The ID of the project containing this model.
   },
   "modelType": "A String", # Output only. Type of the model resource.
-  "optimalTrialIds": [ # Output only. For single-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it only contains the best trial. For multi-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it contains all Pareto optimal trials sorted by trial_id.
+  "optimalTrialIds": [ # Output only. For single-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it only contains the best trial. For multi-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it contains all Pareto optimal trials sorted by trial_id.
     "A String",
   ],
   "remoteModelInfo": { # Remote Model Info # Output only. Remote model info
@@ -1196,7 +1196,7 @@ Method Details
     {
       "bestTrialId": "A String", # The best trial_id across all training runs.
       "creationTime": "A String", # Output only. The time when this model was created, in millisecs since the epoch.
-      "defaultTrialId": "A String", # Output only. The default trial_id to use in TVFs when the trial_id is not passed in. For single-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the best trial ID. For multi-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the smallest trial ID among all Pareto optimal trials.
+      "defaultTrialId": "A String", # Output only. The default trial_id to use in TVFs when the trial_id is not passed in. For single-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the best trial ID. For multi-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the smallest trial ID among all Pareto optimal trials.
       "description": "A String", # Optional. A user-friendly description of this model.
       "encryptionConfiguration": { # Configuration for Cloud KMS encryption settings. # Custom encryption configuration (e.g., Cloud KMS keys). This shows the encryption configuration of the model data while stored in BigQuery storage. This field can be used with PatchModel to update encryption key for an already encrypted model.
         "kmsKeyName": "A String", # Optional. Describes the Cloud KMS encryption key that will be used to protect destination BigQuery table. The BigQuery Service Account associated with your project requires access to this encryption key.
@@ -1422,8 +1422,8 @@ Method Details
           },
         },
       },
-      "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) model sorted by trial_id.
-        { # Training info of a trial in [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
+      "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) model sorted by trial_id.
+        { # Training info of a trial in [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
           "endTimeMs": "A String", # Ending time of the trial.
           "errorMessage": "A String", # Error message for FAILED and INFEASIBLE trial.
           "evalLoss": 3.14, # Loss computed on the eval data at the end of trial.
@@ -1846,7 +1846,7 @@ Method Details
         "projectId": "A String", # Required. The ID of the project containing this model.
       },
       "modelType": "A String", # Output only. Type of the model resource.
-      "optimalTrialIds": [ # Output only. For single-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it only contains the best trial. For multi-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it contains all Pareto optimal trials sorted by trial_id.
+      "optimalTrialIds": [ # Output only. For single-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it only contains the best trial. For multi-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it contains all Pareto optimal trials sorted by trial_id.
         "A String",
       ],
       "remoteModelInfo": { # Remote Model Info # Output only. Remote model info
@@ -2269,7 +2269,7 @@ Method Details
 {
   "bestTrialId": "A String", # The best trial_id across all training runs.
   "creationTime": "A String", # Output only. The time when this model was created, in millisecs since the epoch.
-  "defaultTrialId": "A String", # Output only. The default trial_id to use in TVFs when the trial_id is not passed in. For single-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the best trial ID. For multi-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the smallest trial ID among all Pareto optimal trials.
+  "defaultTrialId": "A String", # Output only. The default trial_id to use in TVFs when the trial_id is not passed in. For single-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the best trial ID. For multi-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the smallest trial ID among all Pareto optimal trials.
   "description": "A String", # Optional. A user-friendly description of this model.
   "encryptionConfiguration": { # Configuration for Cloud KMS encryption settings. # Custom encryption configuration (e.g., Cloud KMS keys). This shows the encryption configuration of the model data while stored in BigQuery storage. This field can be used with PatchModel to update encryption key for an already encrypted model.
     "kmsKeyName": "A String", # Optional. Describes the Cloud KMS encryption key that will be used to protect destination BigQuery table. The BigQuery Service Account associated with your project requires access to this encryption key.
@@ -2495,8 +2495,8 @@ Method Details
       },
     },
   },
-  "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) model sorted by trial_id.
-    { # Training info of a trial in [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
+  "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) model sorted by trial_id.
+    { # Training info of a trial in [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
       "endTimeMs": "A String", # Ending time of the trial.
       "errorMessage": "A String", # Error message for FAILED and INFEASIBLE trial.
       "evalLoss": 3.14, # Loss computed on the eval data at the end of trial.
@@ -2919,7 +2919,7 @@ Method Details
     "projectId": "A String", # Required. The ID of the project containing this model.
   },
   "modelType": "A String", # Output only. Type of the model resource.
-  "optimalTrialIds": [ # Output only. For single-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it only contains the best trial. For multi-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it contains all Pareto optimal trials sorted by trial_id.
+  "optimalTrialIds": [ # Output only. For single-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it only contains the best trial. For multi-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it contains all Pareto optimal trials sorted by trial_id.
     "A String",
   ],
   "remoteModelInfo": { # Remote Model Info # Output only. Remote model info
@@ -3321,7 +3321,7 @@ Method Details
     {
   "bestTrialId": "A String", # The best trial_id across all training runs.
   "creationTime": "A String", # Output only. The time when this model was created, in millisecs since the epoch.
-  "defaultTrialId": "A String", # Output only. The default trial_id to use in TVFs when the trial_id is not passed in. For single-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the best trial ID. For multi-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the smallest trial ID among all Pareto optimal trials.
+  "defaultTrialId": "A String", # Output only. The default trial_id to use in TVFs when the trial_id is not passed in. For single-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the best trial ID. For multi-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the smallest trial ID among all Pareto optimal trials.
   "description": "A String", # Optional. A user-friendly description of this model.
   "encryptionConfiguration": { # Configuration for Cloud KMS encryption settings. # Custom encryption configuration (e.g., Cloud KMS keys). This shows the encryption configuration of the model data while stored in BigQuery storage. This field can be used with PatchModel to update encryption key for an already encrypted model.
     "kmsKeyName": "A String", # Optional. Describes the Cloud KMS encryption key that will be used to protect destination BigQuery table. The BigQuery Service Account associated with your project requires access to this encryption key.
@@ -3547,8 +3547,8 @@ Method Details
       },
     },
   },
-  "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) model sorted by trial_id.
-    { # Training info of a trial in [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
+  "hparamTrials": [ # Output only. Trials of a [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) model sorted by trial_id.
+    { # Training info of a trial in [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.
       "endTimeMs": "A String", # Ending time of the trial.
       "errorMessage": "A String", # Error message for FAILED and INFEASIBLE trial.
       "evalLoss": 3.14, # Loss computed on the eval data at the end of trial.
@@ -3971,7 +3971,7 @@ Method Details
     "projectId": "A String", # Required. The ID of the project containing this model.
   },
   "modelType": "A String", # Output only. Type of the model resource.
-  "optimalTrialIds": [ # Output only. For single-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it only contains the best trial. For multi-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it contains all Pareto optimal trials sorted by trial_id.
+  "optimalTrialIds": [ # Output only. For single-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it only contains the best trial. For multi-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it contains all Pareto optimal trials sorted by trial_id.
     "A String",
   ],
   "remoteModelInfo": { # Remote Model Info # Output only. Remote model info
diff --git a/docs/dyn/bigquery_v2.tables.html b/docs/dyn/bigquery_v2.tables.html
index d379174309e..eaa5919f04d 100644
--- a/docs/dyn/bigquery_v2.tables.html
+++ b/docs/dyn/bigquery_v2.tables.html
@@ -187,7 +187,7 @@ Method Details
     },
     "storageDescriptor": { # Contains information about how a table's data is stored and accessed by open source query engines. # Optional. A storage descriptor containing information about the physical storage of this table.
       "inputFormat": "A String", # Optional. Specifies the fully qualified class name of the InputFormat (e.g. "org.apache.hadoop.hive.ql.io.orc.OrcInputFormat"). The maximum length is 128 characters.
-      "locationUri": "A String", # Optional. The physical location of the table (e.g. 'gs://spark-dataproc-data/pangea-data/case_sensitive/' or 'gs://spark-dataproc-data/pangea-data/*'). The maximum length is 2056 bytes.
+      "locationUri": "A String", # Optional. The physical location of the table (e.g. `gs://spark-dataproc-data/pangea-data/case_sensitive/` or `gs://spark-dataproc-data/pangea-data/*`). The maximum length is 2056 bytes.
       "outputFormat": "A String", # Optional. Specifies the fully qualified class name of the OutputFormat (e.g. "org.apache.hadoop.hive.ql.io.orc.OrcOutputFormat"). The maximum length is 128 characters.
       "serdeInfo": { # Serializer and deserializer information. # Optional. Serializer and deserializer information.
         "name": "A String", # Optional. Name of the SerDe. The maximum length is 256 characters.
@@ -414,7 +414,7 @@ Method Details
   "resourceTags": { # [Optional] The tags associated with this table. Tag keys are globally unique. See additional information on [tags](https://cloud.google.com/iam/docs/tags-access-control#definitions). An object containing a list of "key": value pairs. The key is the namespaced friendly name of the tag key, e.g. "12345/environment" where 12345 is parent id. The value is the friendly short name of the tag value, e.g. "production".
     "a_key": "A String",
   },
-  "restrictions": { # Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
+  "restrictions": { # Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
     "type": "A String", # Output only. Specifies the type of dataset/table restriction.
   },
   "schema": { # Schema of a table # Optional. Describes the schema of this table.
@@ -522,7 +522,7 @@ Method Details
     "requirePartitionFilter": false, # If set to true, queries over this table require a partition filter that can be used for partition elimination to be specified. This field is deprecated; please set the field with the same name on the table itself instead. This field needs a wrapper because we want to output the default value, false, if the user explicitly set it.
     "type": "A String", # Required. The supported types are DAY, HOUR, MONTH, and YEAR, which will generate one partition per day, hour, month, and year, respectively.
   },
-  "type": "A String", # Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.
+  "type": "A String", # Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](https://cloud.google.com/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.
   "view": { # Describes the definition of a logical view. # Optional. The view definition.
     "foreignDefinitions": [ # Optional. Foreign view representations.
       { # A view can be represented in multiple ways. Each representation has its own dialect. This message stores the metadata required for these representations.
@@ -669,7 +669,7 @@ Method Details
     },
     "storageDescriptor": { # Contains information about how a table's data is stored and accessed by open source query engines. # Optional. A storage descriptor containing information about the physical storage of this table.
       "inputFormat": "A String", # Optional. Specifies the fully qualified class name of the InputFormat (e.g. "org.apache.hadoop.hive.ql.io.orc.OrcInputFormat"). The maximum length is 128 characters.
-      "locationUri": "A String", # Optional. The physical location of the table (e.g. 'gs://spark-dataproc-data/pangea-data/case_sensitive/' or 'gs://spark-dataproc-data/pangea-data/*'). The maximum length is 2056 bytes.
+      "locationUri": "A String", # Optional. The physical location of the table (e.g. `gs://spark-dataproc-data/pangea-data/case_sensitive/` or `gs://spark-dataproc-data/pangea-data/*`). The maximum length is 2056 bytes.
       "outputFormat": "A String", # Optional. Specifies the fully qualified class name of the OutputFormat (e.g. "org.apache.hadoop.hive.ql.io.orc.OrcOutputFormat"). The maximum length is 128 characters.
       "serdeInfo": { # Serializer and deserializer information. # Optional. Serializer and deserializer information.
         "name": "A String", # Optional. Name of the SerDe. The maximum length is 256 characters.
@@ -896,7 +896,7 @@ Method Details
   "resourceTags": { # [Optional] The tags associated with this table. Tag keys are globally unique. See additional information on [tags](https://cloud.google.com/iam/docs/tags-access-control#definitions). An object containing a list of "key": value pairs. The key is the namespaced friendly name of the tag key, e.g. "12345/environment" where 12345 is parent id. The value is the friendly short name of the tag value, e.g. "production".
     "a_key": "A String",
   },
-  "restrictions": { # Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
+  "restrictions": { # Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
     "type": "A String", # Output only. Specifies the type of dataset/table restriction.
   },
   "schema": { # Schema of a table # Optional. Describes the schema of this table.
@@ -1004,7 +1004,7 @@ Method Details
     "requirePartitionFilter": false, # If set to true, queries over this table require a partition filter that can be used for partition elimination to be specified. This field is deprecated; please set the field with the same name on the table itself instead. This field needs a wrapper because we want to output the default value, false, if the user explicitly set it.
     "type": "A String", # Required. The supported types are DAY, HOUR, MONTH, and YEAR, which will generate one partition per day, hour, month, and year, respectively.
   },
-  "type": "A String", # Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.
+  "type": "A String", # Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](https://cloud.google.com/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.
   "view": { # Describes the definition of a logical view. # Optional. The view definition.
     "foreignDefinitions": [ # Optional. Foreign view representations.
       { # A view can be represented in multiple ways. Each representation has its own dialect. This message stores the metadata required for these representations.
@@ -1092,7 +1092,7 @@ Method Details
     },
     "storageDescriptor": { # Contains information about how a table's data is stored and accessed by open source query engines. # Optional. A storage descriptor containing information about the physical storage of this table.
       "inputFormat": "A String", # Optional. Specifies the fully qualified class name of the InputFormat (e.g. "org.apache.hadoop.hive.ql.io.orc.OrcInputFormat"). The maximum length is 128 characters.
-      "locationUri": "A String", # Optional. The physical location of the table (e.g. 'gs://spark-dataproc-data/pangea-data/case_sensitive/' or 'gs://spark-dataproc-data/pangea-data/*'). The maximum length is 2056 bytes.
+      "locationUri": "A String", # Optional. The physical location of the table (e.g. `gs://spark-dataproc-data/pangea-data/case_sensitive/` or `gs://spark-dataproc-data/pangea-data/*`). The maximum length is 2056 bytes.
       "outputFormat": "A String", # Optional. Specifies the fully qualified class name of the OutputFormat (e.g. "org.apache.hadoop.hive.ql.io.orc.OrcOutputFormat"). The maximum length is 128 characters.
       "serdeInfo": { # Serializer and deserializer information. # Optional. Serializer and deserializer information.
         "name": "A String", # Optional. Name of the SerDe. The maximum length is 256 characters.
@@ -1319,7 +1319,7 @@ Method Details
   "resourceTags": { # [Optional] The tags associated with this table. Tag keys are globally unique. See additional information on [tags](https://cloud.google.com/iam/docs/tags-access-control#definitions). An object containing a list of "key": value pairs. The key is the namespaced friendly name of the tag key, e.g. "12345/environment" where 12345 is parent id. The value is the friendly short name of the tag value, e.g. "production".
     "a_key": "A String",
   },
-  "restrictions": { # Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
+  "restrictions": { # Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
     "type": "A String", # Output only. Specifies the type of dataset/table restriction.
   },
   "schema": { # Schema of a table # Optional. Describes the schema of this table.
@@ -1427,7 +1427,7 @@ Method Details
     "requirePartitionFilter": false, # If set to true, queries over this table require a partition filter that can be used for partition elimination to be specified. This field is deprecated; please set the field with the same name on the table itself instead. This field needs a wrapper because we want to output the default value, false, if the user explicitly set it.
     "type": "A String", # Required. The supported types are DAY, HOUR, MONTH, and YEAR, which will generate one partition per day, hour, month, and year, respectively.
   },
-  "type": "A String", # Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.
+  "type": "A String", # Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](https://cloud.google.com/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.
   "view": { # Describes the definition of a logical view. # Optional. The view definition.
     "foreignDefinitions": [ # Optional. Foreign view representations.
       { # A view can be represented in multiple ways. Each representation has its own dialect. This message stores the metadata required for these representations.
@@ -1623,7 +1623,7 @@ Method Details
     },
     "storageDescriptor": { # Contains information about how a table's data is stored and accessed by open source query engines. # Optional. A storage descriptor containing information about the physical storage of this table.
       "inputFormat": "A String", # Optional. Specifies the fully qualified class name of the InputFormat (e.g. "org.apache.hadoop.hive.ql.io.orc.OrcInputFormat"). The maximum length is 128 characters.
-      "locationUri": "A String", # Optional. The physical location of the table (e.g. 'gs://spark-dataproc-data/pangea-data/case_sensitive/' or 'gs://spark-dataproc-data/pangea-data/*'). The maximum length is 2056 bytes.
+      "locationUri": "A String", # Optional. The physical location of the table (e.g. `gs://spark-dataproc-data/pangea-data/case_sensitive/` or `gs://spark-dataproc-data/pangea-data/*`). The maximum length is 2056 bytes.
       "outputFormat": "A String", # Optional. Specifies the fully qualified class name of the OutputFormat (e.g. "org.apache.hadoop.hive.ql.io.orc.OrcOutputFormat"). The maximum length is 128 characters.
       "serdeInfo": { # Serializer and deserializer information. # Optional. Serializer and deserializer information.
         "name": "A String", # Optional. Name of the SerDe. The maximum length is 256 characters.
@@ -1850,7 +1850,7 @@ Method Details
   "resourceTags": { # [Optional] The tags associated with this table. Tag keys are globally unique. See additional information on [tags](https://cloud.google.com/iam/docs/tags-access-control#definitions). An object containing a list of "key": value pairs. The key is the namespaced friendly name of the tag key, e.g. "12345/environment" where 12345 is parent id. The value is the friendly short name of the tag value, e.g. "production".
     "a_key": "A String",
   },
-  "restrictions": { # Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
+  "restrictions": { # Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
     "type": "A String", # Output only. Specifies the type of dataset/table restriction.
   },
   "schema": { # Schema of a table # Optional. Describes the schema of this table.
@@ -1958,7 +1958,7 @@ Method Details
     "requirePartitionFilter": false, # If set to true, queries over this table require a partition filter that can be used for partition elimination to be specified. This field is deprecated; please set the field with the same name on the table itself instead. This field needs a wrapper because we want to output the default value, false, if the user explicitly set it.
     "type": "A String", # Required. The supported types are DAY, HOUR, MONTH, and YEAR, which will generate one partition per day, hour, month, and year, respectively.
   },
-  "type": "A String", # Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.
+  "type": "A String", # Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](https://cloud.google.com/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.
   "view": { # Describes the definition of a logical view. # Optional. The view definition.
     "foreignDefinitions": [ # Optional. Foreign view representations.
       { # A view can be represented in multiple ways. Each representation has its own dialect. This message stores the metadata required for these representations.
@@ -2047,7 +2047,7 @@ Method Details
     },
     "storageDescriptor": { # Contains information about how a table's data is stored and accessed by open source query engines. # Optional. A storage descriptor containing information about the physical storage of this table.
       "inputFormat": "A String", # Optional. Specifies the fully qualified class name of the InputFormat (e.g. "org.apache.hadoop.hive.ql.io.orc.OrcInputFormat"). The maximum length is 128 characters.
-      "locationUri": "A String", # Optional. The physical location of the table (e.g. 'gs://spark-dataproc-data/pangea-data/case_sensitive/' or 'gs://spark-dataproc-data/pangea-data/*'). The maximum length is 2056 bytes.
+      "locationUri": "A String", # Optional. The physical location of the table (e.g. `gs://spark-dataproc-data/pangea-data/case_sensitive/` or `gs://spark-dataproc-data/pangea-data/*`). The maximum length is 2056 bytes.
       "outputFormat": "A String", # Optional. Specifies the fully qualified class name of the OutputFormat (e.g. "org.apache.hadoop.hive.ql.io.orc.OrcOutputFormat"). The maximum length is 128 characters.
       "serdeInfo": { # Serializer and deserializer information. # Optional. Serializer and deserializer information.
         "name": "A String", # Optional. Name of the SerDe. The maximum length is 256 characters.
@@ -2274,7 +2274,7 @@ Method Details
   "resourceTags": { # [Optional] The tags associated with this table. Tag keys are globally unique. See additional information on [tags](https://cloud.google.com/iam/docs/tags-access-control#definitions). An object containing a list of "key": value pairs. The key is the namespaced friendly name of the tag key, e.g. "12345/environment" where 12345 is parent id. The value is the friendly short name of the tag value, e.g. "production".
     "a_key": "A String",
   },
-  "restrictions": { # Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
+  "restrictions": { # Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
     "type": "A String", # Output only. Specifies the type of dataset/table restriction.
   },
   "schema": { # Schema of a table # Optional. Describes the schema of this table.
@@ -2382,7 +2382,7 @@ Method Details
     "requirePartitionFilter": false, # If set to true, queries over this table require a partition filter that can be used for partition elimination to be specified. This field is deprecated; please set the field with the same name on the table itself instead. This field needs a wrapper because we want to output the default value, false, if the user explicitly set it.
     "type": "A String", # Required. The supported types are DAY, HOUR, MONTH, and YEAR, which will generate one partition per day, hour, month, and year, respectively.
   },
-  "type": "A String", # Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.
+  "type": "A String", # Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](https://cloud.google.com/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.
   "view": { # Describes the definition of a logical view. # Optional. The view definition.
     "foreignDefinitions": [ # Optional. Foreign view representations.
       { # A view can be represented in multiple ways. Each representation has its own dialect. This message stores the metadata required for these representations.
@@ -2589,7 +2589,7 @@ Method Details
     },
     "storageDescriptor": { # Contains information about how a table's data is stored and accessed by open source query engines. # Optional. A storage descriptor containing information about the physical storage of this table.
       "inputFormat": "A String", # Optional. Specifies the fully qualified class name of the InputFormat (e.g. "org.apache.hadoop.hive.ql.io.orc.OrcInputFormat"). The maximum length is 128 characters.
-      "locationUri": "A String", # Optional. The physical location of the table (e.g. 'gs://spark-dataproc-data/pangea-data/case_sensitive/' or 'gs://spark-dataproc-data/pangea-data/*'). The maximum length is 2056 bytes.
+      "locationUri": "A String", # Optional. The physical location of the table (e.g. `gs://spark-dataproc-data/pangea-data/case_sensitive/` or `gs://spark-dataproc-data/pangea-data/*`). The maximum length is 2056 bytes.
       "outputFormat": "A String", # Optional. Specifies the fully qualified class name of the OutputFormat (e.g. "org.apache.hadoop.hive.ql.io.orc.OrcOutputFormat"). The maximum length is 128 characters.
       "serdeInfo": { # Serializer and deserializer information. # Optional. Serializer and deserializer information.
         "name": "A String", # Optional. Name of the SerDe. The maximum length is 256 characters.
@@ -2816,7 +2816,7 @@ Method Details
   "resourceTags": { # [Optional] The tags associated with this table. Tag keys are globally unique. See additional information on [tags](https://cloud.google.com/iam/docs/tags-access-control#definitions). An object containing a list of "key": value pairs. The key is the namespaced friendly name of the tag key, e.g. "12345/environment" where 12345 is parent id. The value is the friendly short name of the tag value, e.g. "production".
     "a_key": "A String",
   },
-  "restrictions": { # Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
+  "restrictions": { # Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
     "type": "A String", # Output only. Specifies the type of dataset/table restriction.
   },
   "schema": { # Schema of a table # Optional. Describes the schema of this table.
@@ -2924,7 +2924,7 @@ Method Details
     "requirePartitionFilter": false, # If set to true, queries over this table require a partition filter that can be used for partition elimination to be specified. This field is deprecated; please set the field with the same name on the table itself instead. This field needs a wrapper because we want to output the default value, false, if the user explicitly set it.
     "type": "A String", # Required. The supported types are DAY, HOUR, MONTH, and YEAR, which will generate one partition per day, hour, month, and year, respectively.
   },
-  "type": "A String", # Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.
+  "type": "A String", # Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](https://cloud.google.com/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.
   "view": { # Describes the definition of a logical view. # Optional. The view definition.
     "foreignDefinitions": [ # Optional. Foreign view representations.
       { # A view can be represented in multiple ways. Each representation has its own dialect. This message stores the metadata required for these representations.
@@ -3013,7 +3013,7 @@ Method Details
     },
     "storageDescriptor": { # Contains information about how a table's data is stored and accessed by open source query engines. # Optional. A storage descriptor containing information about the physical storage of this table.
       "inputFormat": "A String", # Optional. Specifies the fully qualified class name of the InputFormat (e.g. "org.apache.hadoop.hive.ql.io.orc.OrcInputFormat"). The maximum length is 128 characters.
-      "locationUri": "A String", # Optional. The physical location of the table (e.g. 'gs://spark-dataproc-data/pangea-data/case_sensitive/' or 'gs://spark-dataproc-data/pangea-data/*'). The maximum length is 2056 bytes.
+      "locationUri": "A String", # Optional. The physical location of the table (e.g. `gs://spark-dataproc-data/pangea-data/case_sensitive/` or `gs://spark-dataproc-data/pangea-data/*`). The maximum length is 2056 bytes.
       "outputFormat": "A String", # Optional. Specifies the fully qualified class name of the OutputFormat (e.g. "org.apache.hadoop.hive.ql.io.orc.OrcOutputFormat"). The maximum length is 128 characters.
       "serdeInfo": { # Serializer and deserializer information. # Optional. Serializer and deserializer information.
         "name": "A String", # Optional. Name of the SerDe. The maximum length is 256 characters.
@@ -3240,7 +3240,7 @@ Method Details
   "resourceTags": { # [Optional] The tags associated with this table. Tag keys are globally unique. See additional information on [tags](https://cloud.google.com/iam/docs/tags-access-control#definitions). An object containing a list of "key": value pairs. The key is the namespaced friendly name of the tag key, e.g. "12345/environment" where 12345 is parent id. The value is the friendly short name of the tag value, e.g. "production".
     "a_key": "A String",
   },
-  "restrictions": { # Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
+  "restrictions": { # Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.
     "type": "A String", # Output only. Specifies the type of dataset/table restriction.
   },
   "schema": { # Schema of a table # Optional. Describes the schema of this table.
@@ -3348,7 +3348,7 @@ Method Details
     "requirePartitionFilter": false, # If set to true, queries over this table require a partition filter that can be used for partition elimination to be specified. This field is deprecated; please set the field with the same name on the table itself instead. This field needs a wrapper because we want to output the default value, false, if the user explicitly set it.
     "type": "A String", # Required. The supported types are DAY, HOUR, MONTH, and YEAR, which will generate one partition per day, hour, month, and year, respectively.
   },
-  "type": "A String", # Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.
+  "type": "A String", # Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](https://cloud.google.com/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.
   "view": { # Describes the definition of a logical view. # Optional. The view definition.
     "foreignDefinitions": [ # Optional. Foreign view representations.
       { # A view can be represented in multiple ways. Each representation has its own dialect. This message stores the metadata required for these representations.
diff --git a/googleapiclient/discovery_cache/documents/bigquery.v2.json b/googleapiclient/discovery_cache/documents/bigquery.v2.json
index 3b34232dc11..8aab8db39aa 100644
--- a/googleapiclient/discovery_cache/documents/bigquery.v2.json
+++ b/googleapiclient/discovery_cache/documents/bigquery.v2.json
@@ -41,6 +41,11 @@
 },
 {
 "description": "Regional Endpoint",
+"endpointUrl": "https://bigquery.europe-west8.rep.googleapis.com/",
+"location": "europe-west8"
+},
+{
+"description": "Regional Endpoint",
 "endpointUrl": "https://bigquery.europe-west9.rep.googleapis.com/",
 "location": "europe-west9"
 },
@@ -1935,7 +1940,7 @@
 }
 }
 },
-"revision": "20240815",
+"revision": "20240905",
 "rootUrl": "https://bigquery.googleapis.com/",
 "schemas": {
 "AggregateClassificationMetrics": {
@@ -3269,12 +3274,12 @@
 "additionalProperties": {
 "type": "string"
 },
-"description": "Optional. The [tags](/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example \"123456789012/environment\" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example \"Production\". See [Tag definitions](/iam/docs/tags-access-control#definitions) for more details.",
+"description": "Optional. The [tags](https://cloud.google.com/bigquery/docs/tags) attached to this dataset. Tag keys are globally unique. Tag key is expected to be in the namespaced format, for example \"123456789012/environment\" where 123456789012 is the ID of the parent organization or project resource for this tag key. Tag value is expected to be the short name, for example \"Production\". See [Tag definitions](https://cloud.google.com/iam/docs/tags-access-control#definitions) for more details.",
 "type": "object"
 },
 "restrictions": {
 "$ref": "RestrictionConfig",
-"description": "Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.",
+"description": "Optional. Output only. Restriction config for all tables and dataset. If set, restrict certain accesses on the dataset and all its tables based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.",
 "readOnly": true
 },
 "satisfiesPzi": {
@@ -4516,7 +4521,7 @@
 "type": "object"
 },
 "HparamTuningTrial": {
-"description": "Training info of a trial in [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.",
+"description": "Training info of a trial in [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models.",
 "id": "HparamTuningTrial",
 "properties": {
 "endTimeMs": {
@@ -4614,6 +4619,7 @@
 "NOT_SUPPORTED_IN_STANDARD_EDITION",
 "INDEX_SUPPRESSED_BY_FUNCTION_OPTION",
 "QUERY_CACHE_HIT",
+"STALE_INDEX",
 "INTERNAL_ERROR",
 "OTHER_REASON"
 ],
@@ -4636,6 +4642,7 @@
 "Indicates that search indexes can not be used for search query with STANDARD edition.",
 "Indicates that an option in the search function that cannot make use of the index has been selected.",
 "Indicates that the query was cached, and thus the search index was not used.",
+"The index cannot be used in the search query because it is stale.",
 "Indicates an internal error that causes the search index to be unused.",
 "Indicates that the reason search indexes cannot be used in the query is not covered by any of the other IndexUnusedReason options."
 ],
@@ -4810,7 +4817,7 @@
 },
 "jobCreationReason": {
 "$ref": "JobCreationReason",
-"description": "Output only. The reason why a Job was created. [Preview](/products/#product-launch-stages)",
+"description": "Output only. The reason why a Job was created. [Preview](https://cloud.google.com/products/#product-launch-stages)",
 "readOnly": true
 },
 "jobReference": {
@@ -5370,7 +5377,7 @@
 "type": "object"
 },
 "JobCreationReason": {
-"description": "Reason about why a Job was created from a [`jobs.query`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query) method when used with `JOB_CREATION_OPTIONAL` Job creation mode. For [`jobs.insert`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/insert) method calls it will always be `REQUESTED`. [Preview](/products/#product-launch-stages)",
+"description": "Reason about why a Job was created from a [`jobs.query`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query) method when used with `JOB_CREATION_OPTIONAL` Job creation mode. For [`jobs.insert`](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/insert) method calls it will always be `REQUESTED`. [Preview](https://cloud.google.com/products/#product-launch-stages)",
 "id": "JobCreationReason",
 "properties": {
 "code": {
@@ -5854,7 +5861,7 @@
 "readOnly": true
 },
 "statementType": {
-"description": "Output only. The type of query statement, if valid. Possible values: * `SELECT`: [`SELECT`](/bigquery/docs/reference/standard-sql/query-syntax#select_list) statement. * `ASSERT`: [`ASSERT`](/bigquery/docs/reference/standard-sql/debugging-statements#assert) statement. * `INSERT`: [`INSERT`](/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) statement. * `UPDATE`: [`UPDATE`](/bigquery/docs/reference/standard-sql/query-syntax#update_statement) statement. * `DELETE`: [`DELETE`](/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `MERGE`: [`MERGE`](/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `CREATE_TABLE`: [`CREATE TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: [`CREATE TABLE AS SELECT`](/bigquery/docs/reference/standard-sql/data-definition-language#query_statement) statement. * `CREATE_VIEW`: [`CREATE VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) statement. * `CREATE_MODEL`: [`CREATE MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_model_statement) statement. * `CREATE_MATERIALIZED_VIEW`: [`CREATE MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#create_materialized_view_statement) statement. * `CREATE_FUNCTION`: [`CREATE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#create_function_statement) statement. * `CREATE_TABLE_FUNCTION`: [`CREATE TABLE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#create_table_function_statement) statement. * `CREATE_PROCEDURE`: [`CREATE PROCEDURE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_procedure) statement. * `CREATE_ROW_ACCESS_POLICY`: [`CREATE ROW ACCESS POLICY`](/bigquery/docs/reference/standard-sql/data-definition-language#create_row_access_policy_statement) statement. * `CREATE_SCHEMA`: [`CREATE SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#create_schema_statement) statement. * `CREATE_SNAPSHOT_TABLE`: [`CREATE SNAPSHOT TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_snapshot_table_statement) statement. * `CREATE_SEARCH_INDEX`: [`CREATE SEARCH INDEX`](/bigquery/docs/reference/standard-sql/data-definition-language#create_search_index_statement) statement. * `DROP_TABLE`: [`DROP TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_statement) statement. * `DROP_EXTERNAL_TABLE`: [`DROP EXTERNAL TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_external_table_statement) statement. * `DROP_VIEW`: [`DROP VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_statement) statement. * `DROP_MODEL`: [`DROP MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) statement. * `DROP_MATERIALIZED_VIEW`: [`DROP MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_materialized_view_statement) statement. * `DROP_FUNCTION` : [`DROP FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_function_statement) statement. * `DROP_TABLE_FUNCTION` : [`DROP TABLE FUNCTION`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_function) statement. * `DROP_PROCEDURE`: [`DROP PROCEDURE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedure_statement) statement. * `DROP_SEARCH_INDEX`: [`DROP SEARCH INDEX`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_index) statement. * `DROP_SCHEMA`: [`DROP SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_statement) statement. * `DROP_SNAPSHOT_TABLE`: [`DROP SNAPSHOT TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot_table_statement) statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP [ALL] ROW ACCESS POLICY|POLICIES`](/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_access_policy_statement) statement. * `ALTER_TABLE`: [`ALTER TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_set_options_statement) statement. * `ALTER_VIEW`: [`ALTER VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_set_options_statement) statement. * `ALTER_MATERIALIZED_VIEW`: [`ALTER MATERIALIZED VIEW`](/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) statement. * `ALTER_SCHEMA`: [`ALTER SCHEMA`](/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema_set_options_statement) statement. * `SCRIPT`: [`SCRIPT`](/bigquery/docs/reference/standard-sql/procedural-language). * `TRUNCATE_TABLE`: [`TRUNCATE TABLE`](/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) statement. * `CREATE_EXTERNAL_TABLE`: [`CREATE EXTERNAL TABLE`](/bigquery/docs/reference/standard-sql/data-definition-language#create_external_table_statement) statement. * `EXPORT_DATA`: [`EXPORT DATA`](/bigquery/docs/reference/standard-sql/other-statements#export_data_statement) statement. * `EXPORT_MODEL`: [`EXPORT MODEL`](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) statement. * `LOAD_DATA`: [`LOAD DATA`](/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) statement. * `CALL`: [`CALL`](/bigquery/docs/reference/standard-sql/procedural-language#call) statement.",
+"description": "Output only. The type of query statement, if valid. Possible values: * `SELECT`: [`SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#select_list) statement. * `ASSERT`: [`ASSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/debugging-statements#assert) statement. * `INSERT`: [`INSERT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#insert_statement) statement. * `UPDATE`: [`UPDATE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax#update_statement) statement. * `DELETE`: [`DELETE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `MERGE`: [`MERGE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-manipulation-language) statement. * `CREATE_TABLE`: [`CREATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_statement) statement, without `AS SELECT`. * `CREATE_TABLE_AS_SELECT`: [`CREATE TABLE AS SELECT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#query_statement) statement. * `CREATE_VIEW`: [`CREATE VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_view_statement) statement. * `CREATE_MODEL`: [`CREATE MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-create#create_model_statement) statement. * `CREATE_MATERIALIZED_VIEW`: [`CREATE MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_materialized_view_statement) statement. * `CREATE_FUNCTION`: [`CREATE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_function_statement) statement. * `CREATE_TABLE_FUNCTION`: [`CREATE TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_table_function_statement) statement. * `CREATE_PROCEDURE`: [`CREATE PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_procedure) statement. * `CREATE_ROW_ACCESS_POLICY`: [`CREATE ROW ACCESS POLICY`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_row_access_policy_statement) statement. * `CREATE_SCHEMA`: [`CREATE SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_schema_statement) statement. * `CREATE_SNAPSHOT_TABLE`: [`CREATE SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_snapshot_table_statement) statement. * `CREATE_SEARCH_INDEX`: [`CREATE SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_search_index_statement) statement. * `DROP_TABLE`: [`DROP TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_statement) statement. * `DROP_EXTERNAL_TABLE`: [`DROP EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_external_table_statement) statement. * `DROP_VIEW`: [`DROP VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_view_statement) statement. * `DROP_MODEL`: [`DROP MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-drop-model) statement. * `DROP_MATERIALIZED_VIEW`: [`DROP MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_materialized_view_statement) statement. * `DROP_FUNCTION` : [`DROP FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_function_statement) statement. * `DROP_TABLE_FUNCTION` : [`DROP TABLE FUNCTION`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_table_function) statement. * `DROP_PROCEDURE`: [`DROP PROCEDURE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_procedure_statement) statement. * `DROP_SEARCH_INDEX`: [`DROP SEARCH INDEX`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_search_index) statement. * `DROP_SCHEMA`: [`DROP SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_schema_statement) statement. * `DROP_SNAPSHOT_TABLE`: [`DROP SNAPSHOT TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_snapshot_table_statement) statement. * `DROP_ROW_ACCESS_POLICY`: [`DROP [ALL] ROW ACCESS POLICY|POLICIES`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#drop_row_access_policy_statement) statement. * `ALTER_TABLE`: [`ALTER TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_table_set_options_statement) statement. * `ALTER_VIEW`: [`ALTER VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_view_set_options_statement) statement. * `ALTER_MATERIALIZED_VIEW`: [`ALTER MATERIALIZED VIEW`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#alter_materialized_view_set_options_statement) statement. * `ALTER_SCHEMA`: [`ALTER SCHEMA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#aalter_schema_set_options_statement) statement. * `SCRIPT`: [`SCRIPT`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language). * `TRUNCATE_TABLE`: [`TRUNCATE TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/dml-syntax#truncate_table_statement) statement. * `CREATE_EXTERNAL_TABLE`: [`CREATE EXTERNAL TABLE`](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-definition-language#create_external_table_statement) statement. * `EXPORT_DATA`: [`EXPORT DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#export_data_statement) statement. * `EXPORT_MODEL`: [`EXPORT MODEL`](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-export-model) statement. * `LOAD_DATA`: [`LOAD DATA`](https://cloud.google.com/bigquery/docs/reference/standard-sql/other-statements#load_data_statement) statement. * `CALL`: [`CALL`](https://cloud.google.com/bigquery/docs/reference/standard-sql/procedural-language#call) statement.",
 "readOnly": true,
 "type": "string"
 },
@@ -6370,7 +6377,7 @@
 "id": "MlStatistics",
 "properties": {
 "hparamTrials": {
-"description": "Output only. Trials of a [hyperparameter tuning job](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) sorted by trial_id.",
+"description": "Output only. Trials of a [hyperparameter tuning job](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) sorted by trial_id.",
 "items": {
 "$ref": "HparamTuningTrial"
 },
@@ -6378,7 +6385,7 @@
 "type": "array"
 },
 "iterationResults": {
-"description": "Results for all completed iterations. Empty for [hyperparameter tuning jobs](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview).",
+"description": "Results for all completed iterations. Empty for [hyperparameter tuning jobs](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview).",
 "items": {
 "$ref": "IterationResult"
 },
@@ -6459,7 +6466,7 @@
 "enumDescriptions": [
 "Unspecified training type.",
 "Single training with fixed parameter space.",
-"[Hyperparameter tuning training](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview)."
+"[Hyperparameter tuning training](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview)."
 ],
 "readOnly": true,
 "type": "string"
@@ -6483,7 +6490,7 @@
 "type": "string"
 },
 "defaultTrialId": {
-"description": "Output only. The default trial_id to use in TVFs when the trial_id is not passed in. For single-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the best trial ID. For multi-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the smallest trial ID among all Pareto optimal trials.",
+"description": "Output only. The default trial_id to use in TVFs when the trial_id is not passed in. For single-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the best trial ID. For multi-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, this is the smallest trial ID among all Pareto optimal trials.",
 "format": "int64",
 "readOnly": true,
 "type": "string"
@@ -6524,7 +6531,7 @@
 "readOnly": true
 },
 "hparamTrials": {
-"description": "Output only. Trials of a [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) model sorted by trial_id.",
+"description": "Output only. Trials of a [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) model sorted by trial_id.",
 "items": {
 "$ref": "HparamTuningTrial"
 },
@@ -6621,7 +6628,7 @@
 "type": "string"
 },
 "optimalTrialIds": {
-"description": "Output only. For single-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it only contains the best trial. For multi-objective [hyperparameter tuning](/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it contains all Pareto optimal trials sorted by trial_id.",
+"description": "Output only. For single-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it only contains the best trial. For multi-objective [hyperparameter tuning](https://cloud.google.com/bigquery-ml/docs/reference/standard-sql/bigqueryml-syntax-hp-tuning-overview) models, it contains all Pareto optimal trials sorted by trial_id.",
 "items": {
 "format": "int64",
 "type": "string"
@@ -6688,7 +6695,7 @@
 "id": "ModelExtractOptions",
 "properties": {
 "trialId": {
-"description": "The 1-based ID of the trial to be exported from a hyperparameter tuning model. If not specified, the trial with id = [Model](/bigquery/docs/reference/rest/v2/models#resource:-model).defaultTrialId is exported. This field is ignored for models not trained with hyperparameter tuning.",
+"description": "The 1-based ID of the trial to be exported from a hyperparameter tuning model. If not specified, the trial with id = [Model](https://cloud.google.com/bigquery/docs/reference/rest/v2/models#resource:-model).defaultTrialId is exported. This field is ignored for models not trained with hyperparameter tuning.",
 "format": "int64",
 "type": "string"
 }
@@ -7109,7 +7116,7 @@
 "description": "Optional. Output format adjustments."
 },
 "jobCreationMode": {
-"description": "Optional. If not set, jobs are always required. If set, the query request will follow the behavior described JobCreationMode. [Preview](/products/#product-launch-stages)",
+"description": "Optional. If not set, jobs are always required. If set, the query request will follow the behavior described JobCreationMode. [Preview](https://cloud.google.com/products/#product-launch-stages)",
 "enum": [
 "JOB_CREATION_MODE_UNSPECIFIED",
 "JOB_CREATION_REQUIRED",
@@ -7216,7 +7223,7 @@
 },
 "jobCreationReason": {
 "$ref": "JobCreationReason",
-"description": "Optional. The reason why a Job was created. Only relevant when a job_reference is present in the response. If job_reference is not present it will always be unset. [Preview](/products/#product-launch-stages)"
+"description": "Optional. The reason why a Job was created. Only relevant when a job_reference is present in the response. If job_reference is not present it will always be unset. [Preview](https://cloud.google.com/products/#product-launch-stages)"
 },
 "jobReference": {
 "$ref": "JobReference",
@@ -7238,7 +7245,7 @@
 "type": "string"
 },
 "queryId": {
-"description": "Auto-generated ID for the query. [Preview](/products/#product-launch-stages)",
+"description": "Auto-generated ID for the query. [Preview](https://cloud.google.com/products/#product-launch-stages)",
 "type": "string"
 },
 "rows": {
@@ -7502,7 +7509,7 @@
 ],
 "enumDescriptions": [
 "Should never be used.",
-"Restrict data egress. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details."
+"Restrict data egress. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details."
 ],
 "readOnly": true,
 "type": "string"
@@ -8266,7 +8273,7 @@
 "type": "string"
 },
 "locationUri": {
-"description": "Optional. The physical location of the table (e.g. 'gs://spark-dataproc-data/pangea-data/case_sensitive/' or 'gs://spark-dataproc-data/pangea-data/*'). The maximum length is 2056 bytes.",
+"description": "Optional. The physical location of the table (e.g. `gs://spark-dataproc-data/pangea-data/case_sensitive/` or `gs://spark-dataproc-data/pangea-data/*`). The maximum length is 2056 bytes.",
 "type": "string"
 },
 "outputFormat": {
@@ -8565,7 +8572,7 @@
 },
 "restrictions": {
 "$ref": "RestrictionConfig",
-"description": "Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](/bigquery/docs/analytics-hub-introduction#data_egress) for more details.",
+"description": "Optional. Output only. Restriction config for table. If set, restrict certain accesses on the table based on the config. See [Data egress](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#data_egress) for more details.",
 "readOnly": true
 },
 "schema": {
@@ -8604,7 +8611,7 @@
 "description": "If specified, configures time-based partitioning for this table."
 },
 "type": {
-"description": "Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.",
+"description": "Output only. Describes the table type. The following values are supported: * `TABLE`: A normal BigQuery table. * `VIEW`: A virtual table defined by a SQL query. * `EXTERNAL`: A table that references data stored in an external storage system, such as Google Cloud Storage. * `MATERIALIZED_VIEW`: A precomputed view defined by a SQL query. * `SNAPSHOT`: An immutable BigQuery table that preserves the contents of a base table at a particular time. See additional information on [table snapshots](https://cloud.google.com/bigquery/docs/table-snapshots-intro). The default value is `TABLE`.",
 "readOnly": true,
 "type": "string"
 },
@@ -9035,7 +9042,7 @@
 "description": "Metadata caching eligible table referenced in the query."
 },
 "tableType": {
-"description": "[Table type](/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.type).",
+"description": "[Table type](https://cloud.google.com/bigquery/docs/reference/rest/v2/tables#Table.FIELDS.type).",
 "type": "string"
 },
 "unusedReason": {

From 60470398583dc25927f117c1f52c09613c4e54fd Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:03 +0000
Subject: [PATCH 06/32] feat(bigtableadmin): update the api

#### bigtableadmin:v2

The following keys were added:
- schemas.Backup.properties.backupType.type (Total Keys: 1)
- schemas.Backup.properties.hotToStandardTime (Total Keys: 2)
- schemas.MultiClusterRoutingUseAny.properties.rowAffinity.$ref (Total Keys: 1)
- schemas.RowAffinity (Total Keys: 2)
---
 ...min_v2.projects.instances.appProfiles.html | 10 ++++++
 ...2.projects.instances.clusters.backups.html | 10 ++++++
 .../documents/bigtableadmin.v2.json           | 31 ++++++++++++++++++-
 3 files changed, 50 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/bigtableadmin_v2.projects.instances.appProfiles.html b/docs/dyn/bigtableadmin_v2.projects.instances.appProfiles.html
index 12762d88162..2fe3ad212ae 100644
--- a/docs/dyn/bigtableadmin_v2.projects.instances.appProfiles.html
+++ b/docs/dyn/bigtableadmin_v2.projects.instances.appProfiles.html
@@ -120,6 +120,8 @@ Method Details
     "clusterIds": [ # The set of clusters to route to. The order is ignored; clusters will be tried in order of distance. If left empty, all clusters are eligible.
       "A String",
     ],
+    "rowAffinity": { # If enabled, the AFE will route the request based on the row key of the request, rather than randomly. Instead, each row key will be assigned to a cluster, and will stick to that cluster. If clusters are added or removed, then this may affect which row keys stick to which clusters. To avoid this, users can specify a group cluster. # Row affinity sticky routing based on the row key of the request. Requests that span multiple rows are routed non-deterministically.
+    },
   },
   "name": "A String", # The unique name of the app profile. Values are of the form `projects/{project}/instances/{instance}/appProfiles/_a-zA-Z0-9*`.
   "priority": "A String", # This field has been deprecated in favor of `standard_isolation.priority`. If you set this field, `standard_isolation.priority` will be set instead. The priority of requests sent using this app profile.
@@ -152,6 +154,8 @@ Method Details
     "clusterIds": [ # The set of clusters to route to. The order is ignored; clusters will be tried in order of distance. If left empty, all clusters are eligible.
       "A String",
     ],
+    "rowAffinity": { # If enabled, the AFE will route the request based on the row key of the request, rather than randomly. Instead, each row key will be assigned to a cluster, and will stick to that cluster. If clusters are added or removed, then this may affect which row keys stick to which clusters. To avoid this, users can specify a group cluster. # Row affinity sticky routing based on the row key of the request. Requests that span multiple rows are routed non-deterministically.
+    },
   },
   "name": "A String", # The unique name of the app profile. Values are of the form `projects/{project}/instances/{instance}/appProfiles/_a-zA-Z0-9*`.
   "priority": "A String", # This field has been deprecated in favor of `standard_isolation.priority`. If you set this field, `standard_isolation.priority` will be set instead. The priority of requests sent using this app profile.
@@ -208,6 +212,8 @@ Method Details
     "clusterIds": [ # The set of clusters to route to. The order is ignored; clusters will be tried in order of distance. If left empty, all clusters are eligible.
       "A String",
     ],
+    "rowAffinity": { # If enabled, the AFE will route the request based on the row key of the request, rather than randomly. Instead, each row key will be assigned to a cluster, and will stick to that cluster. If clusters are added or removed, then this may affect which row keys stick to which clusters. To avoid this, users can specify a group cluster. # Row affinity sticky routing based on the row key of the request. Requests that span multiple rows are routed non-deterministically.
+    },
   },
   "name": "A String", # The unique name of the app profile. Values are of the form `projects/{project}/instances/{instance}/appProfiles/_a-zA-Z0-9*`.
   "priority": "A String", # This field has been deprecated in favor of `standard_isolation.priority`. If you set this field, `standard_isolation.priority` will be set instead. The priority of requests sent using this app profile.
@@ -249,6 +255,8 @@ Method Details
         "clusterIds": [ # The set of clusters to route to. The order is ignored; clusters will be tried in order of distance. If left empty, all clusters are eligible.
           "A String",
         ],
+        "rowAffinity": { # If enabled, the AFE will route the request based on the row key of the request, rather than randomly. Instead, each row key will be assigned to a cluster, and will stick to that cluster. If clusters are added or removed, then this may affect which row keys stick to which clusters. To avoid this, users can specify a group cluster. # Row affinity sticky routing based on the row key of the request. Requests that span multiple rows are routed non-deterministically.
+        },
       },
       "name": "A String", # The unique name of the app profile. Values are of the form `projects/{project}/instances/{instance}/appProfiles/_a-zA-Z0-9*`.
       "priority": "A String", # This field has been deprecated in favor of `standard_isolation.priority`. If you set this field, `standard_isolation.priority` will be set instead. The priority of requests sent using this app profile.
@@ -301,6 +309,8 @@ Method Details
     "clusterIds": [ # The set of clusters to route to. The order is ignored; clusters will be tried in order of distance. If left empty, all clusters are eligible.
       "A String",
     ],
+    "rowAffinity": { # If enabled, the AFE will route the request based on the row key of the request, rather than randomly. Instead, each row key will be assigned to a cluster, and will stick to that cluster. If clusters are added or removed, then this may affect which row keys stick to which clusters. To avoid this, users can specify a group cluster. # Row affinity sticky routing based on the row key of the request. Requests that span multiple rows are routed non-deterministically.
+    },
   },
   "name": "A String", # The unique name of the app profile. Values are of the form `projects/{project}/instances/{instance}/appProfiles/_a-zA-Z0-9*`.
   "priority": "A String", # This field has been deprecated in favor of `standard_isolation.priority`. If you set this field, `standard_isolation.priority` will be set instead. The priority of requests sent using this app profile.
diff --git a/docs/dyn/bigtableadmin_v2.projects.instances.clusters.backups.html b/docs/dyn/bigtableadmin_v2.projects.instances.clusters.backups.html
index b92a501992c..32d3f8373d8 100644
--- a/docs/dyn/bigtableadmin_v2.projects.instances.clusters.backups.html
+++ b/docs/dyn/bigtableadmin_v2.projects.instances.clusters.backups.html
@@ -167,6 +167,7 @@ Method Details
     The object takes the form of:
 
 { # A backup of a Cloud Bigtable table.
+  "backupType": "A String", # Indicates the backup type of the backup.
   "encryptionInfo": { # Encryption information for a given resource. If this resource is protected with customer managed encryption, the in-use Cloud Key Management Service (Cloud KMS) key version is specified along with its status. # Output only. The encryption information for the backup.
     "encryptionStatus": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. The status of encrypt/decrypt calls on underlying data for this resource. Regardless of status, the existing data is always encrypted at rest.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
@@ -182,6 +183,7 @@ Method Details
   },
   "endTime": "A String", # Output only. `end_time` is the time that the backup was finished. The row data in the backup will be no newer than this timestamp.
   "expireTime": "A String", # Required. The expiration time of the backup. When creating a backup or updating its `expire_time`, the value must be greater than the backup creation time by: - At least 6 hours - At most 90 days Once the `expire_time` has passed, Cloud Bigtable will delete the backup.
+  "hotToStandardTime": "A String", # The time at which the hot backup will be converted to a standard backup. Once the `hot_to_standard_time` has passed, Cloud Bigtable will convert the hot backup to a standard backup. This value must be greater than the backup creation time by: - At least 24 hours This field only applies for hot backups. When creating or updating a standard backup, attempting to set this field will fail the request.
   "name": "A String", # A globally unique identifier for the backup which cannot be changed. Values are of the form `projects/{project}/instances/{instance}/clusters/{cluster}/ backups/_a-zA-Z0-9*` The final segment of the name must be between 1 and 50 characters in length. The backup is stored in the cluster identified by the prefix of the backup name of the form `projects/{project}/instances/{instance}/clusters/{cluster}`.
   "sizeBytes": "A String", # Output only. Size of the backup in bytes.
   "sourceBackup": "A String", # Output only. Name of the backup from which this backup was copied. If a backup is not created by copying a backup, this field will be empty. Values are of the form: projects//instances//clusters//backups/
@@ -253,6 +255,7 @@ Method Details
   An object of the form:
 
     { # A backup of a Cloud Bigtable table.
+  "backupType": "A String", # Indicates the backup type of the backup.
   "encryptionInfo": { # Encryption information for a given resource. If this resource is protected with customer managed encryption, the in-use Cloud Key Management Service (Cloud KMS) key version is specified along with its status. # Output only. The encryption information for the backup.
     "encryptionStatus": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. The status of encrypt/decrypt calls on underlying data for this resource. Regardless of status, the existing data is always encrypted at rest.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
@@ -268,6 +271,7 @@ Method Details
   },
   "endTime": "A String", # Output only. `end_time` is the time that the backup was finished. The row data in the backup will be no newer than this timestamp.
   "expireTime": "A String", # Required. The expiration time of the backup. When creating a backup or updating its `expire_time`, the value must be greater than the backup creation time by: - At least 6 hours - At most 90 days Once the `expire_time` has passed, Cloud Bigtable will delete the backup.
+  "hotToStandardTime": "A String", # The time at which the hot backup will be converted to a standard backup. Once the `hot_to_standard_time` has passed, Cloud Bigtable will convert the hot backup to a standard backup. This value must be greater than the backup creation time by: - At least 24 hours This field only applies for hot backups. When creating or updating a standard backup, attempting to set this field will fail the request.
   "name": "A String", # A globally unique identifier for the backup which cannot be changed. Values are of the form `projects/{project}/instances/{instance}/clusters/{cluster}/ backups/_a-zA-Z0-9*` The final segment of the name must be between 1 and 50 characters in length. The backup is stored in the cluster identified by the prefix of the backup name of the form `projects/{project}/instances/{instance}/clusters/{cluster}`.
   "sizeBytes": "A String", # Output only. Size of the backup in bytes.
   "sourceBackup": "A String", # Output only. Name of the backup from which this backup was copied. If a backup is not created by copying a backup, this field will be empty. Values are of the form: projects//instances//clusters//backups/
@@ -354,6 +358,7 @@ Method Details
     { # The response for ListBackups.
   "backups": [ # The list of matching backups.
     { # A backup of a Cloud Bigtable table.
+      "backupType": "A String", # Indicates the backup type of the backup.
       "encryptionInfo": { # Encryption information for a given resource. If this resource is protected with customer managed encryption, the in-use Cloud Key Management Service (Cloud KMS) key version is specified along with its status. # Output only. The encryption information for the backup.
         "encryptionStatus": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. The status of encrypt/decrypt calls on underlying data for this resource. Regardless of status, the existing data is always encrypted at rest.
           "code": 42, # The status code, which should be an enum value of google.rpc.Code.
@@ -369,6 +374,7 @@ Method Details
       },
       "endTime": "A String", # Output only. `end_time` is the time that the backup was finished. The row data in the backup will be no newer than this timestamp.
       "expireTime": "A String", # Required. The expiration time of the backup. When creating a backup or updating its `expire_time`, the value must be greater than the backup creation time by: - At least 6 hours - At most 90 days Once the `expire_time` has passed, Cloud Bigtable will delete the backup.
+      "hotToStandardTime": "A String", # The time at which the hot backup will be converted to a standard backup. Once the `hot_to_standard_time` has passed, Cloud Bigtable will convert the hot backup to a standard backup. This value must be greater than the backup creation time by: - At least 24 hours This field only applies for hot backups. When creating or updating a standard backup, attempting to set this field will fail the request.
       "name": "A String", # A globally unique identifier for the backup which cannot be changed. Values are of the form `projects/{project}/instances/{instance}/clusters/{cluster}/ backups/_a-zA-Z0-9*` The final segment of the name must be between 1 and 50 characters in length. The backup is stored in the cluster identified by the prefix of the backup name of the form `projects/{project}/instances/{instance}/clusters/{cluster}`.
       "sizeBytes": "A String", # Output only. Size of the backup in bytes.
       "sourceBackup": "A String", # Output only. Name of the backup from which this backup was copied. If a backup is not created by copying a backup, this field will be empty. Values are of the form: projects//instances//clusters//backups/
@@ -405,6 +411,7 @@ Method Details
     The object takes the form of:
 
 { # A backup of a Cloud Bigtable table.
+  "backupType": "A String", # Indicates the backup type of the backup.
   "encryptionInfo": { # Encryption information for a given resource. If this resource is protected with customer managed encryption, the in-use Cloud Key Management Service (Cloud KMS) key version is specified along with its status. # Output only. The encryption information for the backup.
     "encryptionStatus": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. The status of encrypt/decrypt calls on underlying data for this resource. Regardless of status, the existing data is always encrypted at rest.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
@@ -420,6 +427,7 @@ Method Details
   },
   "endTime": "A String", # Output only. `end_time` is the time that the backup was finished. The row data in the backup will be no newer than this timestamp.
   "expireTime": "A String", # Required. The expiration time of the backup. When creating a backup or updating its `expire_time`, the value must be greater than the backup creation time by: - At least 6 hours - At most 90 days Once the `expire_time` has passed, Cloud Bigtable will delete the backup.
+  "hotToStandardTime": "A String", # The time at which the hot backup will be converted to a standard backup. Once the `hot_to_standard_time` has passed, Cloud Bigtable will convert the hot backup to a standard backup. This value must be greater than the backup creation time by: - At least 24 hours This field only applies for hot backups. When creating or updating a standard backup, attempting to set this field will fail the request.
   "name": "A String", # A globally unique identifier for the backup which cannot be changed. Values are of the form `projects/{project}/instances/{instance}/clusters/{cluster}/ backups/_a-zA-Z0-9*` The final segment of the name must be between 1 and 50 characters in length. The backup is stored in the cluster identified by the prefix of the backup name of the form `projects/{project}/instances/{instance}/clusters/{cluster}`.
   "sizeBytes": "A String", # Output only. Size of the backup in bytes.
   "sourceBackup": "A String", # Output only. Name of the backup from which this backup was copied. If a backup is not created by copying a backup, this field will be empty. Values are of the form: projects//instances//clusters//backups/
@@ -438,6 +446,7 @@ Method Details
   An object of the form:
 
     { # A backup of a Cloud Bigtable table.
+  "backupType": "A String", # Indicates the backup type of the backup.
   "encryptionInfo": { # Encryption information for a given resource. If this resource is protected with customer managed encryption, the in-use Cloud Key Management Service (Cloud KMS) key version is specified along with its status. # Output only. The encryption information for the backup.
     "encryptionStatus": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. The status of encrypt/decrypt calls on underlying data for this resource. Regardless of status, the existing data is always encrypted at rest.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
@@ -453,6 +462,7 @@ Method Details
   },
   "endTime": "A String", # Output only. `end_time` is the time that the backup was finished. The row data in the backup will be no newer than this timestamp.
   "expireTime": "A String", # Required. The expiration time of the backup. When creating a backup or updating its `expire_time`, the value must be greater than the backup creation time by: - At least 6 hours - At most 90 days Once the `expire_time` has passed, Cloud Bigtable will delete the backup.
+  "hotToStandardTime": "A String", # The time at which the hot backup will be converted to a standard backup. Once the `hot_to_standard_time` has passed, Cloud Bigtable will convert the hot backup to a standard backup. This value must be greater than the backup creation time by: - At least 24 hours This field only applies for hot backups. When creating or updating a standard backup, attempting to set this field will fail the request.
   "name": "A String", # A globally unique identifier for the backup which cannot be changed. Values are of the form `projects/{project}/instances/{instance}/clusters/{cluster}/ backups/_a-zA-Z0-9*` The final segment of the name must be between 1 and 50 characters in length. The backup is stored in the cluster identified by the prefix of the backup name of the form `projects/{project}/instances/{instance}/clusters/{cluster}`.
   "sizeBytes": "A String", # Output only. Size of the backup in bytes.
   "sourceBackup": "A String", # Output only. Name of the backup from which this backup was copied. If a backup is not created by copying a backup, this field will be empty. Values are of the form: projects//instances//clusters//backups/
diff --git a/googleapiclient/discovery_cache/documents/bigtableadmin.v2.json b/googleapiclient/discovery_cache/documents/bigtableadmin.v2.json
index 5599cd57d3c..f9c4c023d24 100644
--- a/googleapiclient/discovery_cache/documents/bigtableadmin.v2.json
+++ b/googleapiclient/discovery_cache/documents/bigtableadmin.v2.json
@@ -2194,7 +2194,7 @@
 }
 }
 },
-"revision": "20240824",
+"revision": "20240904",
 "rootUrl": "https://bigtableadmin.googleapis.com/",
 "schemas": {
 "AppProfile": {
@@ -2375,6 +2375,20 @@
 "description": "A backup of a Cloud Bigtable table.",
 "id": "Backup",
 "properties": {
+"backupType": {
+"description": "Indicates the backup type of the backup.",
+"enum": [
+"BACKUP_TYPE_UNSPECIFIED",
+"STANDARD",
+"HOT"
+],
+"enumDescriptions": [
+"Not specified.",
+"The default type for Cloud Bigtable managed backups. Supported for backups created in both HDD and SSD instances. Requires optimization when restored to a table in an SSD instance.",
+"A backup type with faster restore to SSD performance. Only supported for backups created in SSD instances. A new SSD table restored from a hot backup reaches production performance more quickly than a standard backup."
+],
+"type": "string"
+},
 "encryptionInfo": {
 "$ref": "EncryptionInfo",
 "description": "Output only. The encryption information for the backup.",
@@ -2391,6 +2405,11 @@
 "format": "google-datetime",
 "type": "string"
 },
+"hotToStandardTime": {
+"description": "The time at which the hot backup will be converted to a standard backup. Once the `hot_to_standard_time` has passed, Cloud Bigtable will convert the hot backup to a standard backup. This value must be greater than the backup creation time by: - At least 24 hours This field only applies for hot backups. When creating or updating a standard backup, attempting to set this field will fail the request.",
+"format": "google-datetime",
+"type": "string"
+},
 "name": {
 "description": "A globally unique identifier for the backup which cannot be changed. Values are of the form `projects/{project}/instances/{instance}/clusters/{cluster}/ backups/_a-zA-Z0-9*` The final segment of the name must be between 1 and 50 characters in length. The backup is stored in the cluster identified by the prefix of the backup name of the form `projects/{project}/instances/{instance}/clusters/{cluster}`.",
 "type": "string"
@@ -3775,6 +3794,10 @@
 "type": "string"
 },
 "type": "array"
+},
+"rowAffinity": {
+"$ref": "RowAffinity",
+"description": "Row affinity sticky routing based on the row key of the request. Requests that span multiple rows are routed non-deterministically."
 }
 },
 "type": "object"
@@ -4007,6 +4030,12 @@
 },
 "type": "object"
 },
+"RowAffinity": {
+"description": "If enabled, the AFE will route the request based on the row key of the request, rather than randomly. Instead, each row key will be assigned to a cluster, and will stick to that cluster. If clusters are added or removed, then this may affect which row keys stick to which clusters. To avoid this, users can specify a group cluster.",
+"id": "RowAffinity",
+"properties": {},
+"type": "object"
+},
 "SetIamPolicyRequest": {
 "description": "Request message for `SetIamPolicy` method.",
 "id": "SetIamPolicyRequest",

From 1fc953d50d7dc45053ed2fd8d7bb82a1caf7088d Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:03 +0000
Subject: [PATCH 07/32] fix(chat): update the api

#### chat:v1

The following keys were changed:
- resources.spaces.methods.create.scopes (Total Keys: 1)
- resources.spaces.methods.delete.scopes (Total Keys: 1)
- resources.spaces.methods.get.scopes (Total Keys: 1)
- resources.spaces.methods.patch.scopes (Total Keys: 1)
- resources.spaces.resources.members.methods.create.scopes (Total Keys: 1)
- resources.spaces.resources.members.methods.delete.scopes (Total Keys: 1)
- resources.spaces.resources.members.methods.patch.scopes (Total Keys: 1)
---
 docs/dyn/chat_v1.spaces.messages.html         | 32 ++++++-------
 docs/dyn/chat_v1.spaces.spaceEvents.html      | 48 +++++++++----------
 .../discovery_cache/documents/chat.v1.json    | 30 ++++++++++--
 3 files changed, 65 insertions(+), 45 deletions(-)

diff --git a/docs/dyn/chat_v1.spaces.messages.html b/docs/dyn/chat_v1.spaces.messages.html
index dbe542077db..b7c93f4b0d2 100644
--- a/docs/dyn/chat_v1.spaces.messages.html
+++ b/docs/dyn/chat_v1.spaces.messages.html
@@ -1126,7 +1126,7 @@ Method Details
     { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
       "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
       "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-        "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+        "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
           "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
           "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
           "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -1834,7 +1834,7 @@ Method Details
     "url": "A String", # Output only. The URL that was matched.
   },
   "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-  "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+  "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
     "displayName": "A String", # Output only. The user's display name.
     "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
     "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -2910,7 +2910,7 @@ Method Details
     { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
       "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
       "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-        "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+        "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
           "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
           "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
           "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -3618,7 +3618,7 @@ Method Details
     "url": "A String", # Output only. The URL that was matched.
   },
   "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-  "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+  "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
     "displayName": "A String", # Output only. The user's display name.
     "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
     "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -4712,7 +4712,7 @@ Method Details
     { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
       "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
       "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-        "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+        "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
           "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
           "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
           "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -5420,7 +5420,7 @@ Method Details
     "url": "A String", # Output only. The URL that was matched.
   },
   "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-  "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+  "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
     "displayName": "A String", # Output only. The user's display name.
     "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
     "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -6502,7 +6502,7 @@ Method Details
         { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
           "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
           "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-            "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+            "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
               "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
               "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
               "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -7210,7 +7210,7 @@ Method Details
         "url": "A String", # Output only. The URL that was matched.
       },
       "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-      "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+      "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
         "displayName": "A String", # Output only. The user's display name.
         "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
         "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -8297,7 +8297,7 @@ Method Details
     { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
       "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
       "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-        "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+        "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
           "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
           "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
           "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -9005,7 +9005,7 @@ Method Details
     "url": "A String", # Output only. The URL that was matched.
   },
   "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-  "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+  "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
     "displayName": "A String", # Output only. The user's display name.
     "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
     "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -10075,7 +10075,7 @@ Method Details
     { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
       "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
       "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-        "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+        "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
           "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
           "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
           "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -10783,7 +10783,7 @@ Method Details
     "url": "A String", # Output only. The URL that was matched.
   },
   "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-  "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+  "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
     "displayName": "A String", # Output only. The user's display name.
     "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
     "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -11853,7 +11853,7 @@ Method Details
     { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
       "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
       "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-        "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+        "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
           "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
           "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
           "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -12561,7 +12561,7 @@ Method Details
     "url": "A String", # Output only. The URL that was matched.
   },
   "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-  "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+  "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
     "displayName": "A String", # Output only. The user's display name.
     "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
     "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -13631,7 +13631,7 @@ Method Details
     { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
       "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
       "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-        "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+        "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
           "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
           "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
           "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -14339,7 +14339,7 @@ Method Details
     "url": "A String", # Output only. The URL that was matched.
   },
   "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-  "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+  "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
     "displayName": "A String", # Output only. The user's display name.
     "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
     "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
diff --git a/docs/dyn/chat_v1.spaces.spaceEvents.html b/docs/dyn/chat_v1.spaces.spaceEvents.html
index 2881d6ccfee..0437d287c80 100644
--- a/docs/dyn/chat_v1.spaces.spaceEvents.html
+++ b/docs/dyn/chat_v1.spaces.spaceEvents.html
@@ -1241,7 +1241,7 @@ Method Details
             { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
               "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
               "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-                "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+                "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
                   "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
                   "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
                   "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -1949,7 +1949,7 @@ Method Details
             "url": "A String", # Output only. The URL that was matched.
           },
           "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-          "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+          "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
             "displayName": "A String", # Output only. The user's display name.
             "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
             "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -3014,7 +3014,7 @@ Method Details
             { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
               "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
               "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-                "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+                "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
                   "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
                   "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
                   "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -3722,7 +3722,7 @@ Method Details
             "url": "A String", # Output only. The URL that was matched.
           },
           "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-          "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+          "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
             "displayName": "A String", # Output only. The user's display name.
             "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
             "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -4787,7 +4787,7 @@ Method Details
             { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
               "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
               "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-                "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+                "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
                   "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
                   "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
                   "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -5495,7 +5495,7 @@ Method Details
             "url": "A String", # Output only. The URL that was matched.
           },
           "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-          "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+          "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
             "displayName": "A String", # Output only. The user's display name.
             "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
             "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -6558,7 +6558,7 @@ Method Details
         { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
           "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
           "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-            "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+            "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
               "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
               "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
               "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -7266,7 +7266,7 @@ Method Details
         "url": "A String", # Output only. The URL that was matched.
       },
       "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-      "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+      "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
         "displayName": "A String", # Output only. The user's display name.
         "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
         "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -8327,7 +8327,7 @@ Method Details
         { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
           "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
           "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-            "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+            "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
               "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
               "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
               "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -9035,7 +9035,7 @@ Method Details
         "url": "A String", # Output only. The URL that was matched.
       },
       "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-      "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+      "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
         "displayName": "A String", # Output only. The user's display name.
         "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
         "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -10096,7 +10096,7 @@ Method Details
         { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
           "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
           "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-            "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+            "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
               "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
               "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
               "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -10804,7 +10804,7 @@ Method Details
         "url": "A String", # Output only. The URL that was matched.
       },
       "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-      "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+      "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
         "displayName": "A String", # Output only. The user's display name.
         "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
         "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -12164,7 +12164,7 @@ Method Details
                 { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
                   "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
                   "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-                    "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+                    "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
                       "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
                       "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
                       "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -12872,7 +12872,7 @@ Method Details
                 "url": "A String", # Output only. The URL that was matched.
               },
               "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-              "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+              "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
                 "displayName": "A String", # Output only. The user's display name.
                 "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
                 "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -13937,7 +13937,7 @@ Method Details
                 { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
                   "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
                   "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-                    "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+                    "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
                       "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
                       "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
                       "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -14645,7 +14645,7 @@ Method Details
                 "url": "A String", # Output only. The URL that was matched.
               },
               "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-              "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+              "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
                 "displayName": "A String", # Output only. The user's display name.
                 "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
                 "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -15710,7 +15710,7 @@ Method Details
                 { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
                   "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
                   "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-                    "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+                    "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
                       "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
                       "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
                       "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -16418,7 +16418,7 @@ Method Details
                 "url": "A String", # Output only. The URL that was matched.
               },
               "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-              "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+              "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
                 "displayName": "A String", # Output only. The user's display name.
                 "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
                 "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -17481,7 +17481,7 @@ Method Details
             { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
               "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
               "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-                "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+                "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
                   "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
                   "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
                   "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -18189,7 +18189,7 @@ Method Details
             "url": "A String", # Output only. The URL that was matched.
           },
           "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-          "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+          "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
             "displayName": "A String", # Output only. The user's display name.
             "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
             "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -19250,7 +19250,7 @@ Method Details
             { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
               "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
               "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-                "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+                "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
                   "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
                   "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
                   "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -19958,7 +19958,7 @@ Method Details
             "url": "A String", # Output only. The URL that was matched.
           },
           "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-          "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+          "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
             "displayName": "A String", # Output only. The user's display name.
             "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
             "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
@@ -21019,7 +21019,7 @@ Method Details
             { # Output only. Annotations associated with the plain-text body of the message. To add basic formatting to a text message, see [Format text messages](https://developers.google.com/workspace/chat/format-messages). Example plain-text message body: ``` Hello @FooBot how are you!" ``` The corresponding annotations metadata: ``` "annotations":[{ "type":"USER_MENTION", "startIndex":6, "length":7, "userMention": { "user": { "name":"users/{user}", "displayName":"FooBot", "avatarUrl":"https://goo.gl/aeDtrS", "type":"BOT" }, "type":"MENTION" } }] ```
               "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to.
               "richLinkMetadata": { # A rich link to a resource. # The metadata for a rich link.
-                "chatSpaceLinkData": { # Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview). # Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview).
+                "chatSpaceLinkData": { # Data for Chat space links. # Data for a chat space link.
                   "message": "A String", # The message of the linked Chat space resource. Format: `spaces/{space}/messages/{message}`
                   "space": "A String", # The space of the linked Chat space resource. Format: `spaces/{space}`
                   "thread": "A String", # The thread of the linked Chat space resource. Format: `spaces/{space}/threads/{thread}`
@@ -21727,7 +21727,7 @@ Method Details
             "url": "A String", # Output only. The URL that was matched.
           },
           "name": "A String", # Resource name of the message. Format: `spaces/{space}/messages/{message}` Where `{space}` is the ID of the space where the message is posted and `{message}` is a system-assigned ID for the message. For example, `spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB`. If you set a custom ID when you create a message, you can use this ID to specify the message in a request by replacing `{message}` with the value from the `clientAssignedMessageId` field. For example, `spaces/AAAAAAAAAAA/messages/client-custom-name`. For details, see [Name a message](https://developers.google.com/workspace/chat/create-messages#name_a_created_message).
-          "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
+          "privateMessageViewer": { # A user in Google Chat. When returned as an output from a request, if your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), the output for a `User` resource only populates the user's `name` and `type`. # Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private).
             "displayName": "A String", # Output only. The user's display name.
             "domainId": "A String", # Unique identifier of the user's Google Workspace domain.
             "isAnonymous": True or False, # Output only. When `true`, the user is deleted or their profile is not visible.
diff --git a/googleapiclient/discovery_cache/documents/chat.v1.json b/googleapiclient/discovery_cache/documents/chat.v1.json
index 7f804d932e3..157dbce3b75 100644
--- a/googleapiclient/discovery_cache/documents/chat.v1.json
+++ b/googleapiclient/discovery_cache/documents/chat.v1.json
@@ -17,6 +17,18 @@
 "https://www.googleapis.com/auth/chat.admin.spaces.readonly": {
 "description": "View display name, description, and other metadata for all Google Chat conversations owned by your organization"
 },
+"https://www.googleapis.com/auth/chat.app.delete": {
+"description": "On their own behalf, apps in Google Chat can delete conversations and spaces and remove access to associated files"
+},
+"https://www.googleapis.com/auth/chat.app.memberships": {
+"description": "On their own behalf, apps in Google Chat can see, add, update, and remove members from conversations and spaces"
+},
+"https://www.googleapis.com/auth/chat.app.spaces": {
+"description": "On their own behalf, apps in Google Chat can create conversations and spaces and see or update their metadata (including history settings and access settings)"
+},
+"https://www.googleapis.com/auth/chat.app.spaces.create": {
+"description": "On their own behalf, apps in Google Chat can create conversations and spaces"
+},
 "https://www.googleapis.com/auth/chat.bot": {
 "description": "Private Service: https://www.googleapis.com/auth/chat.bot"
 },
@@ -298,6 +310,8 @@
 "$ref": "Space"
 },
 "scopes": [
+"https://www.googleapis.com/auth/chat.app.spaces",
+"https://www.googleapis.com/auth/chat.app.spaces.create",
 "https://www.googleapis.com/auth/chat.import",
 "https://www.googleapis.com/auth/chat.spaces",
 "https://www.googleapis.com/auth/chat.spaces.create"
@@ -331,6 +345,7 @@
 },
 "scopes": [
 "https://www.googleapis.com/auth/chat.admin.delete",
+"https://www.googleapis.com/auth/chat.app.delete",
 "https://www.googleapis.com/auth/chat.delete",
 "https://www.googleapis.com/auth/chat.import"
 ]
@@ -387,6 +402,7 @@
 "scopes": [
 "https://www.googleapis.com/auth/chat.admin.spaces",
 "https://www.googleapis.com/auth/chat.admin.spaces.readonly",
+"https://www.googleapis.com/auth/chat.app.spaces",
 "https://www.googleapis.com/auth/chat.bot",
 "https://www.googleapis.com/auth/chat.spaces",
 "https://www.googleapis.com/auth/chat.spaces.readonly"
@@ -463,6 +479,7 @@
 },
 "scopes": [
 "https://www.googleapis.com/auth/chat.admin.spaces",
+"https://www.googleapis.com/auth/chat.app.spaces",
 "https://www.googleapis.com/auth/chat.import",
 "https://www.googleapis.com/auth/chat.spaces"
 ]
@@ -564,6 +581,7 @@
 },
 "scopes": [
 "https://www.googleapis.com/auth/chat.admin.memberships",
+"https://www.googleapis.com/auth/chat.app.memberships",
 "https://www.googleapis.com/auth/chat.import",
 "https://www.googleapis.com/auth/chat.memberships",
 "https://www.googleapis.com/auth/chat.memberships.app"
@@ -597,6 +615,7 @@
 },
 "scopes": [
 "https://www.googleapis.com/auth/chat.admin.memberships",
+"https://www.googleapis.com/auth/chat.app.memberships",
 "https://www.googleapis.com/auth/chat.import",
 "https://www.googleapis.com/auth/chat.memberships",
 "https://www.googleapis.com/auth/chat.memberships.app"
@@ -734,6 +753,7 @@
 },
 "scopes": [
 "https://www.googleapis.com/auth/chat.admin.memberships",
+"https://www.googleapis.com/auth/chat.app.memberships",
 "https://www.googleapis.com/auth/chat.import",
 "https://www.googleapis.com/auth/chat.memberships"
 ]
@@ -1324,7 +1344,7 @@
 }
 }
 },
-"revision": "20240829",
+"revision": "20240908",
 "rootUrl": "https://chat.googleapis.com/",
 "schemas": {
 "AccessSettings": {
@@ -1737,7 +1757,7 @@
 "type": "object"
 },
 "ChatSpaceLinkData": {
-"description": "Data for Chat space links. [Developer Preview](https://developers.google.com/workspace/preview).",
+"description": "Data for Chat space links.",
 "id": "ChatSpaceLinkData",
 "properties": {
 "message": {
@@ -3835,7 +3855,7 @@
 },
 "privateMessageViewer": {
 "$ref": "User",
-"description": "Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. Link previews and attachments aren't supported for private messages. Only Chat apps can send private messages. If your Chat app [authenticates as a user](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) to send a message, the message can't be private and must omit this field. For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private)."
+"description": "Immutable. Input for creating a message, otherwise output only. The user that can view the message. When set, the message is private and only visible to the specified user and the Chat app. To include this field in your request, you must call the Chat API using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and omit the following: * [Attachments](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages.attachments) * [Accessory widgets](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages#Message.AccessoryWidget) For details, see [Send a message privately](https://developers.google.com/workspace/chat/create-messages#private)."
 },
 "quotedMessageMetadata": {
 "$ref": "QuotedMessageMetadata",
@@ -4067,7 +4087,7 @@
 "properties": {
 "chatSpaceLinkData": {
 "$ref": "ChatSpaceLinkData",
-"description": "Data for a chat space link. [Developer Preview](https://developers.google.com/workspace/preview)."
+"description": "Data for a chat space link."
 },
 "driveLinkData": {
 "$ref": "DriveLinkData",
@@ -4083,7 +4103,7 @@
 "enumDescriptions": [
 "Default value for the enum. Don't use.",
 "A Google Drive rich link type.",
-"A Chat space rich link type. For example, a space smart chip. [Developer Preview](https://developers.google.com/workspace/preview)."
+"A Chat space rich link type. For example, a space smart chip."
 ],
 "type": "string"
 },

From 6d726e54687c8a60dcd23dd05f9d786f7cc3b8a1 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:03 +0000
Subject: [PATCH 08/32] feat(civicinfo): update the api

#### civicinfo:v2

The following keys were added:
- resources.divisions.methods.queryDivisionByAddress (Total Keys: 8)
- schemas.DivisionByAddressResponse (Total Keys: 5)
---
 docs/dyn/civicinfo_v2.divisions.html          | 41 +++++++++++++++++++
 .../documents/civicinfo.v2.json               | 35 +++++++++++++++-
 2 files changed, 75 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/civicinfo_v2.divisions.html b/docs/dyn/civicinfo_v2.divisions.html
index 32229335a75..d9f1e5d87fd 100644
--- a/docs/dyn/civicinfo_v2.divisions.html
+++ b/docs/dyn/civicinfo_v2.divisions.html
@@ -77,6 +77,9 @@ Instance Methods
 
   close()
 Close httplib2 connections.
+
+  queryDivisionByAddress(address=None, x__xgafv=None)
+Lookup OCDIDs and names for divisions related to an address.
 
   search(query=None, x__xgafv=None)
 Searches for political divisions by their natural name or OCD ID.
@@ -86,6 +89,44 @@ Method Details
   Close httplib2 connections.

+ queryDivisionByAddress(address=None, x__xgafv=None) +

Lookup OCDIDs and names for divisions related to an address.
+
+Args:
+  address: string, A parameter
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "divisions": {
+    "a_key": { # Describes a political geography.
+      "alsoKnownAs": [ # Any other valid OCD IDs that refer to the same division.\n\nBecause OCD IDs are meant to be human-readable and at least somewhat predictable, there are occasionally several identifiers for a single division. These identifiers are defined to be equivalent to one another, and one is always indicated as the primary identifier. The primary identifier will be returned in ocd_id above, and any other equivalent valid identifiers will be returned in this list.\n\nFor example, if this division's OCD ID is ocd-division/country:us/district:dc, this will contain ocd-division/country:us/state:dc.
+        "A String",
+      ],
+      "name": "A String", # The name of the division.
+      "officeIndices": [ # List of indices in the offices array, one for each office elected from this division. Will only be present if includeOffices was true (or absent) in the request.
+        42,
+      ],
+    },
+  },
+  "normalizedInput": { # A simple representation of an address. # The normalized version of the requested address.
+    "city": "A String", # The city or town for the address.
+    "line1": "A String", # The street name and number of this address.
+    "line2": "A String", # The second line the address, if needed.
+    "line3": "A String", # The third line of the address, if needed.
+    "locationName": "A String", # The name of the location.
+    "state": "A String", # The US two letter state abbreviation of the address.
+    "zip": "A String", # The US Postal Zip Code of the address.
+  },
+}

search(query=None, x__xgafv=None)

Searches for political divisions by their natural name or OCD ID.
diff --git a/googleapiclient/discovery_cache/documents/civicinfo.v2.json b/googleapiclient/discovery_cache/documents/civicinfo.v2.json
index 84fdf3ecb27..3a7f164d540 100644
--- a/googleapiclient/discovery_cache/documents/civicinfo.v2.json
+++ b/googleapiclient/discovery_cache/documents/civicinfo.v2.json
@@ -97,6 +97,23 @@
 "resources": {
 "divisions": {
 "methods": {
+"queryDivisionByAddress": {
+"description": "Lookup OCDIDs and names for divisions related to an address.",
+"flatPath": "civicinfo/v2/divisionsByAddress",
+"httpMethod": "GET",
+"id": "civicinfo.divisions.queryDivisionByAddress",
+"parameterOrder": [],
+"parameters": {
+"address": {
+"location": "query",
+"type": "string"
+}
+},
+"path": "civicinfo/v2/divisionsByAddress",
+"response": {
+"$ref": "DivisionByAddressResponse"
+}
+},
 "search": {
 "description": "Searches for political divisions by their natural name or OCD ID.",
 "flatPath": "civicinfo/v2/divisions",
@@ -362,7 +379,7 @@
 }
 }
 },
-"revision": "20240620",
+"revision": "20240910",
 "rootUrl": "https://civicinfo.googleapis.com/",
 "schemas": {
 "AdministrationRegion": {
@@ -696,6 +713,22 @@
 },
 "type": "object"
 },
+"DivisionByAddressResponse": {
+"id": "DivisionByAddressResponse",
+"properties": {
+"divisions": {
+"additionalProperties": {
+"$ref": "GeographicDivision"
+},
+"type": "object"
+},
+"normalizedInput": {
+"$ref": "SimpleAddressType",
+"description": "The normalized version of the requested address."
+}
+},
+"type": "object"
+},
 "DivisionSearchResponse": {
 "description": "The result of a division search query.",
 "id": "DivisionSearchResponse",

From 4ecae700437ca7327e1b3a4300dacf94ee6c3e9d Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:04 +0000
Subject: [PATCH 09/32] feat(cloudchannel): update the api

#### cloudchannel:v1

The following keys were deleted:
- resources.accounts.methods.listSubscribers.parameters.integrator (Total Keys: 2)
- resources.integrators.methods.listSubscribers (Total Keys: 18)
- resources.integrators.methods.register (Total Keys: 15)
- resources.integrators.methods.unregister (Total Keys: 15)
- schemas.GoogleCloudChannelV1RegisterSubscriberRequest.properties.integrator.type (Total Keys: 1)
- schemas.GoogleCloudChannelV1UnregisterSubscriberRequest.properties.integrator.type (Total Keys: 1)
---
 ...ccounts.channelPartnerLinks.customers.html |   2 +-
 .../cloudchannel_v1.accounts.customers.html   |   2 +-
 docs/dyn/cloudchannel_v1.accounts.html        |  11 +-
 docs/dyn/cloudchannel_v1.html                 |   5 -
 .../documents/cloudchannel.v1.json            | 136 +-----------------
 5 files changed, 10 insertions(+), 146 deletions(-)

diff --git a/docs/dyn/cloudchannel_v1.accounts.channelPartnerLinks.customers.html b/docs/dyn/cloudchannel_v1.accounts.channelPartnerLinks.customers.html
index 2bde3b0b7f0..dd72f1ef16a 100644
--- a/docs/dyn/cloudchannel_v1.accounts.channelPartnerLinks.customers.html
+++ b/docs/dyn/cloudchannel_v1.accounts.channelPartnerLinks.customers.html
@@ -327,7 +327,7 @@ Method Details
   "customer": "A String", # Optional. Specifies the customer that will receive imported Cloud Identity information. Format: accounts/{account_id}/customers/{customer_id}
   "domain": "A String", # Required. Customer domain.
   "overwriteIfExists": True or False, # Required. Choose to overwrite an existing customer if found. This must be set to true if there is an existing customer with a conflicting region code or domain.
-  "primaryAdminEmail": "A String", # Optional. Customer's primary admin email.
+  "primaryAdminEmail": "A String", # Required. Customer's primary admin email.
 }
 
   x__xgafv: string, V1 error format.
diff --git a/docs/dyn/cloudchannel_v1.accounts.customers.html b/docs/dyn/cloudchannel_v1.accounts.customers.html
index 219d7c09d93..38bf16b4f20 100644
--- a/docs/dyn/cloudchannel_v1.accounts.customers.html
+++ b/docs/dyn/cloudchannel_v1.accounts.customers.html
@@ -361,7 +361,7 @@ Method Details
   "customer": "A String", # Optional. Specifies the customer that will receive imported Cloud Identity information. Format: accounts/{account_id}/customers/{customer_id}
   "domain": "A String", # Required. Customer domain.
   "overwriteIfExists": True or False, # Required. Choose to overwrite an existing customer if found. This must be set to true if there is an existing customer with a conflicting region code or domain.
-  "primaryAdminEmail": "A String", # Optional. Customer's primary admin email.
+  "primaryAdminEmail": "A String", # Required. Customer's primary admin email.
 }
 
   x__xgafv: string, V1 error format.
diff --git a/docs/dyn/cloudchannel_v1.accounts.html b/docs/dyn/cloudchannel_v1.accounts.html
index 13323ecb661..48526626542 100644
--- a/docs/dyn/cloudchannel_v1.accounts.html
+++ b/docs/dyn/cloudchannel_v1.accounts.html
@@ -111,7 +111,7 @@ Instance Methods
   close()
 Close httplib2 connections.
 
-  listSubscribers(account, integrator=None, pageSize=None, pageToken=None, x__xgafv=None)
+  listSubscribers(account, pageSize=None, pageToken=None, x__xgafv=None)
 Lists service accounts with subscriber privileges on the Cloud Pub/Sub topic created for this Channel Services account. Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: A list of service email addresses.
 
   listSubscribers_next()
@@ -145,8 +145,8 @@ Method Details
     The object takes the form of:
 
 { # Request message for CloudChannelService.CheckCloudIdentityAccountsExist.
-  "domain": "A String", # Required. Domain to fetch for Cloud Identity account customers, including domained and domainless.
-  "primaryAdminEmail": "A String", # Optional. Primary admin email to fetch for Cloud Identity account domainless customer.
+  "domain": "A String", # Required. Domain to fetch for Cloud Identity account customers, including domain and team customers. For team customers, please use the domain for their emails.
+  "primaryAdminEmail": "A String", # Optional. Primary admin email to fetch for Cloud Identity account team customer.
 }
 
   x__xgafv: string, V1 error format.
@@ -177,12 +177,11 @@ Method Details

- listSubscribers(account, integrator=None, pageSize=None, pageToken=None, x__xgafv=None) + listSubscribers(account, pageSize=None, pageToken=None, x__xgafv=None)

Lists service accounts with subscriber privileges on the Cloud Pub/Sub topic created for this Channel Services account. Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: A list of service email addresses.
 
 Args:
   account: string, Optional. Resource name of the account. (required)
-  integrator: string, Optional. Resource name of the integrator.
   pageSize: integer, Optional. The maximum number of service accounts to return. The service may return fewer than this value. If unspecified, returns at most 100 service accounts. The maximum value is 1000; the server will coerce values above 1000.
   pageToken: string, Optional. A page token, received from a previous `ListSubscribers` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListSubscribers` must match the call that provided the page token.
   x__xgafv: string, V1 error format.
@@ -539,7 +538,6 @@ Method Details
     The object takes the form of:
 
 { # Request Message for RegisterSubscriber.
-  "integrator": "A String", # Optional. Resource name of the integrator.
   "serviceAccount": "A String", # Required. Service account that provides subscriber access to the registered topic.
 }
 
@@ -566,7 +564,6 @@ Method Details
     The object takes the form of:
 
 { # Request Message for UnregisterSubscriber.
-  "integrator": "A String", # Optional. Resource name of the integrator.
   "serviceAccount": "A String", # Required. Service account to unregister from subscriber access to the topic.
 }
 
diff --git a/docs/dyn/cloudchannel_v1.html b/docs/dyn/cloudchannel_v1.html
index aa51f74b7ed..22cbcd31f47 100644
--- a/docs/dyn/cloudchannel_v1.html
+++ b/docs/dyn/cloudchannel_v1.html
@@ -79,11 +79,6 @@ Instance Methods
 
 Returns the accounts Resource.
 
-
-  integrators()
-
-Returns the integrators Resource.
-
 
   operations()
 
diff --git a/googleapiclient/discovery_cache/documents/cloudchannel.v1.json b/googleapiclient/discovery_cache/documents/cloudchannel.v1.json
index ffbfd4738c3..3ce3677ea58 100644
--- a/googleapiclient/discovery_cache/documents/cloudchannel.v1.json
+++ b/googleapiclient/discovery_cache/documents/cloudchannel.v1.json
@@ -154,11 +154,6 @@
 "required": true,
 "type": "string"
 },
-"integrator": {
-"description": "Optional. Resource name of the integrator.",
-"location": "query",
-"type": "string"
-},
 "pageSize": {
 "description": "Optional. The maximum number of service accounts to return. The service may return fewer than this value. If unspecified, returns at most 100 service accounts. The maximum value is 1000; the server will coerce values above 1000.",
 "format": "int32",
@@ -1971,121 +1966,6 @@
 }
 }
 },
-"integrators": {
-"methods": {
-"listSubscribers": {
-"description": "Lists service accounts with subscriber privileges on the Cloud Pub/Sub topic created for this Channel Services account. Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: A list of service email addresses.",
-"flatPath": "v1/integrators/{integratorsId}:listSubscribers",
-"httpMethod": "GET",
-"id": "cloudchannel.integrators.listSubscribers",
-"parameterOrder": [
-"integrator"
-],
-"parameters": {
-"account": {
-"description": "Optional. Resource name of the account.",
-"location": "query",
-"type": "string"
-},
-"integrator": {
-"description": "Optional. Resource name of the integrator.",
-"location": "path",
-"pattern": "^integrators/[^/]+$",
-"required": true,
-"type": "string"
-},
-"pageSize": {
-"description": "Optional. The maximum number of service accounts to return. The service may return fewer than this value. If unspecified, returns at most 100 service accounts. The maximum value is 1000; the server will coerce values above 1000.",
-"format": "int32",
-"location": "query",
-"type": "integer"
-},
-"pageToken": {
-"description": "Optional. A page token, received from a previous `ListSubscribers` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListSubscribers` must match the call that provided the page token.",
-"location": "query",
-"type": "string"
-}
-},
-"path": "v1/{+integrator}:listSubscribers",
-"response": {
-"$ref": "GoogleCloudChannelV1ListSubscribersResponse"
-},
-"scopes": [
-"https://www.googleapis.com/auth/apps.order"
-]
-},
-"register": {
-"description": "Registers a service account with subscriber privileges on the Cloud Pub/Sub topic for this Channel Services account. After you create a subscriber, you get the events through SubscriberEvent Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: The topic name with the registered service email address.",
-"flatPath": "v1/integrators/{integratorsId}:register",
-"httpMethod": "POST",
-"id": "cloudchannel.integrators.register",
-"parameterOrder": [
-"integrator"
-],
-"parameters": {
-"account": {
-"description": "Optional. Resource name of the account.",
-"location": "query",
-"type": "string"
-},
-"integrator": {
-"description": "Optional. Resource name of the integrator.",
-"location": "path",
-"pattern": "^integrators/[^/]+$",
-"required": true,
-"type": "string"
-},
-"serviceAccount": {
-"description": "Required. Service account that provides subscriber access to the registered topic.",
-"location": "query",
-"type": "string"
-}
-},
-"path": "v1/{+integrator}:register",
-"response": {
-"$ref": "GoogleCloudChannelV1RegisterSubscriberResponse"
-},
-"scopes": [
-"https://www.googleapis.com/auth/apps.order"
-]
-},
-"unregister": {
-"description": "Unregisters a service account with subscriber privileges on the Cloud Pub/Sub topic created for this Channel Services account. If there are no service accounts left with subscriber privileges, this deletes the topic. You can call ListSubscribers to check for these accounts. Possible error codes: * PERMISSION_DENIED: The reseller account making the request and the provided reseller account are different, or the impersonated user is not a super admin. * INVALID_ARGUMENT: Required request parameters are missing or invalid. * NOT_FOUND: The topic resource doesn't exist. * INTERNAL: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. * UNKNOWN: Any non-user error related to a technical issue in the backend. Contact Cloud Channel support. Return value: The topic name that unregistered the service email address. Returns a success response if the service email address wasn't registered with the topic.",
-"flatPath": "v1/integrators/{integratorsId}:unregister",
-"httpMethod": "POST",
-"id": "cloudchannel.integrators.unregister",
-"parameterOrder": [
-"integrator"
-],
-"parameters": {
-"account": {
-"description": "Optional. Resource name of the account.",
-"location": "query",
-"type": "string"
-},
-"integrator": {
-"description": "Optional. Resource name of the integrator.",
-"location": "path",
-"pattern": "^integrators/[^/]+$",
-"required": true,
-"type": "string"
-},
-"serviceAccount": {
-"description": "Required. Service account to unregister from subscriber access to the topic.",
-"location": "query",
-"type": "string"
-}
-},
-"path": "v1/{+integrator}:unregister",
-"response": {
-"$ref": "GoogleCloudChannelV1UnregisterSubscriberResponse"
-},
-"scopes": [
-"https://www.googleapis.com/auth/apps.order"
-]
-}
-}
-},
 "operations": {
 "methods": {
 "cancel": {
@@ -2303,7 +2183,7 @@
 }
 }
 },
-"revision": "20240828",
+"revision": "20240913",
 "rootUrl": "https://cloudchannel.googleapis.com/",
 "schemas": {
 "GoogleCloudChannelV1ActivateEntitlementRequest": {
@@ -2579,11 +2459,11 @@
 "id": "GoogleCloudChannelV1CheckCloudIdentityAccountsExistRequest",
 "properties": {
 "domain": {
-"description": "Required. Domain to fetch for Cloud Identity account customers, including domained and domainless.",
+"description": "Required. Domain to fetch for Cloud Identity account customers, including domain and team customers. For team customers, please use the domain for their emails.",
 "type": "string"
 },
 "primaryAdminEmail": {
-"description": "Optional. Primary admin email to fetch for Cloud Identity account domainless customer.",
+"description": "Optional. Primary admin email to fetch for Cloud Identity account team customer.",
 "type": "string"
 }
 },
@@ -3450,7 +3330,7 @@
 "type": "boolean"
 },
 "primaryAdminEmail": {
-"description": "Optional. Customer's primary admin email.",
+"description": "Required. Customer's primary admin email.",
 "type": "string"
 }
 },
@@ -4363,10 +4243,6 @@
 "description": "Request Message for RegisterSubscriber.",
 "id": "GoogleCloudChannelV1RegisterSubscriberRequest",
 "properties": {
-"integrator": {
-"description": "Optional. Resource name of the integrator.",
-"type": "string"
-},
 "serviceAccount": {
 "description": "Required. Service account that provides subscriber access to the registered topic.",
 "type": "string"
@@ -4941,10 +4817,6 @@
 "description": "Request Message for UnregisterSubscriber.",
 "id": "GoogleCloudChannelV1UnregisterSubscriberRequest",
 "properties": {
-"integrator": {
-"description": "Optional. Resource name of the integrator.",
-"type": "string"
-},
 "serviceAccount": {
 "description": "Required. Service account to unregister from subscriber access to the topic.",
 "type": "string"

From 29f873cfbeeed1aa5e786cfabb1620dee60abf8c Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:04 +0000
Subject: [PATCH 10/32] feat(cloudfunctions): update the api

#### cloudfunctions:v1

The following keys were deleted:
- schemas.GoogleCloudFunctionsV2LocationMetadata (Total Keys: 4)
- schemas.GoogleCloudFunctionsV2OperationMetadata (Total Keys: 18)
- schemas.GoogleCloudFunctionsV2Stage (Total Keys: 9)
- schemas.GoogleCloudFunctionsV2StateMessage (Total Keys: 5)
- schemas.GoogleCloudFunctionsV2alphaLocationMetadata (Total Keys: 4)
- schemas.GoogleCloudFunctionsV2alphaOperationMetadata (Total Keys: 18)
- schemas.GoogleCloudFunctionsV2alphaStage (Total Keys: 9)
- schemas.GoogleCloudFunctionsV2alphaStateMessage (Total Keys: 5)
- schemas.GoogleCloudFunctionsV2betaLocationMetadata (Total Keys: 4)
- schemas.GoogleCloudFunctionsV2betaOperationMetadata (Total Keys: 18)
- schemas.GoogleCloudFunctionsV2betaStage (Total Keys: 9)
- schemas.GoogleCloudFunctionsV2betaStateMessage (Total Keys: 5)

#### cloudfunctions:v2

The following keys were deleted:
- schemas.GoogleCloudFunctionsV2alphaLocationMetadata (Total Keys: 4)
- schemas.GoogleCloudFunctionsV2alphaOperationMetadata (Total Keys: 18)
- schemas.GoogleCloudFunctionsV2alphaStage (Total Keys: 9)
- schemas.GoogleCloudFunctionsV2alphaStateMessage (Total Keys: 5)
- schemas.GoogleCloudFunctionsV2betaLocationMetadata (Total Keys: 4)
- schemas.GoogleCloudFunctionsV2betaOperationMetadata (Total Keys: 18)
- schemas.GoogleCloudFunctionsV2betaStage (Total Keys: 9)
- schemas.GoogleCloudFunctionsV2betaStateMessage (Total Keys: 5)

#### cloudfunctions:v2alpha

The following keys were deleted:
- schemas.GoogleCloudFunctionsV2LocationMetadata (Total Keys: 4)
- schemas.GoogleCloudFunctionsV2OperationMetadata (Total Keys: 18)
- schemas.GoogleCloudFunctionsV2Stage (Total Keys: 9)
- schemas.GoogleCloudFunctionsV2StateMessage (Total Keys: 5)
- schemas.GoogleCloudFunctionsV2betaLocationMetadata (Total Keys: 4)
- schemas.GoogleCloudFunctionsV2betaOperationMetadata (Total Keys: 18)
- schemas.GoogleCloudFunctionsV2betaStage (Total Keys: 9)
- schemas.GoogleCloudFunctionsV2betaStateMessage (Total Keys: 5)

#### cloudfunctions:v2beta

The following keys were deleted:
- schemas.GoogleCloudFunctionsV2LocationMetadata (Total Keys: 4)
- schemas.GoogleCloudFunctionsV2OperationMetadata (Total Keys: 18)
- schemas.GoogleCloudFunctionsV2Stage (Total Keys: 9)
- schemas.GoogleCloudFunctionsV2StateMessage (Total Keys: 5)
- schemas.GoogleCloudFunctionsV2alphaLocationMetadata (Total Keys: 4)
- schemas.GoogleCloudFunctionsV2alphaOperationMetadata (Total Keys: 18)
- schemas.GoogleCloudFunctionsV2alphaStage (Total Keys: 9)
- schemas.GoogleCloudFunctionsV2alphaStateMessage (Total Keys: 5)
---
 .../documents/cloudfunctions.v1.json          | 617 +-----------------
 .../documents/cloudfunctions.v2.json          | 412 +-----------
 .../documents/cloudfunctions.v2alpha.json     | 412 +-----------
 .../documents/cloudfunctions.v2beta.json      | 412 +-----------
 4 files changed, 4 insertions(+), 1849 deletions(-)

diff --git a/googleapiclient/discovery_cache/documents/cloudfunctions.v1.json b/googleapiclient/discovery_cache/documents/cloudfunctions.v1.json
index c3ab178d212..bffe298b055 100644
--- a/googleapiclient/discovery_cache/documents/cloudfunctions.v1.json
+++ b/googleapiclient/discovery_cache/documents/cloudfunctions.v1.json
@@ -552,7 +552,7 @@
 }
 }
 },
-"revision": "20240725",
+"revision": "20240905",
 "rootUrl": "https://cloudfunctions.googleapis.com/",
 "schemas": {
 "AuditConfig": {
@@ -987,621 +987,6 @@
 },
 "type": "object"
 },
-"GoogleCloudFunctionsV2LocationMetadata": {
-"description": "Extra GCF specific location information.",
-"id": "GoogleCloudFunctionsV2LocationMetadata",
-"properties": {
-"environments": {
-"description": "The Cloud Function environments this location supports.",
-"items": {
-"enum": [
-"ENVIRONMENT_UNSPECIFIED",
-"GEN_1",
-"GEN_2"
-],
-"enumDescriptions": [
-"Unspecified",
-"Gen 1",
-"Gen 2"
-],
-"type": "string"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2OperationMetadata": {
-"description": "Represents the metadata of the long-running operation.",
-"id": "GoogleCloudFunctionsV2OperationMetadata",
-"properties": {
-"apiVersion": {
-"description": "API version used to start the operation.",
-"type": "string"
-},
-"buildName": {
-"description": "The build name of the function for create and update operations.",
-"type": "string"
-},
-"cancelRequested": {
-"description": "Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have google.longrunning.Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
-"type": "boolean"
-},
-"createTime": {
-"description": "The time the operation was created.",
-"format": "google-datetime",
-"type": "string"
-},
-"endTime": {
-"description": "The time the operation finished running.",
-"format": "google-datetime",
-"type": "string"
-},
-"operationType": {
-"description": "The operation type.",
-"enum": [
-"OPERATIONTYPE_UNSPECIFIED",
-"CREATE_FUNCTION",
-"UPDATE_FUNCTION",
-"DELETE_FUNCTION",
-"REDIRECT_FUNCTION_UPGRADE_TRAFFIC",
-"ROLLBACK_FUNCTION_UPGRADE_TRAFFIC",
-"SETUP_FUNCTION_UPGRADE_CONFIG",
-"ABORT_FUNCTION_UPGRADE",
-"COMMIT_FUNCTION_UPGRADE"
-],
-"enumDescriptions": [
-"Unspecified",
-"CreateFunction",
-"UpdateFunction",
-"DeleteFunction",
-"RedirectFunctionUpgradeTraffic",
-"RollbackFunctionUpgradeTraffic",
-"SetupFunctionUpgradeConfig",
-"AbortFunctionUpgrade",
-"CommitFunctionUpgrade"
-],
-"type": "string"
-},
-"requestResource": {
-"additionalProperties": {
-"description": "Properties of the object. Contains field @type with type URL.",
-"type": "any"
-},
-"description": "The original request that started the operation.",
-"type": "object"
-},
-"sourceToken": {
-"description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.",
-"type": "string"
-},
-"stages": {
-"description": "Mechanism for reporting in-progress stages",
-"items": {
-"$ref": "GoogleCloudFunctionsV2Stage"
-},
-"type": "array"
-},
-"statusDetail": {
-"description": "Human-readable status of the operation, if any.",
-"type": "string"
-},
-"target": {
-"description": "Server-defined resource path for the target of the operation.",
-"type": "string"
-},
-"verb": {
-"description": "Name of the verb executed by the operation.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2Stage": {
-"description": "Each Stage of the deployment process",
-"id": "GoogleCloudFunctionsV2Stage",
-"properties": {
-"message": {
-"description": "Message describing the Stage",
-"type": "string"
-},
-"name": {
-"description": "Name of the Stage. This will be unique for each Stage.",
-"enum": [
-"NAME_UNSPECIFIED",
-"ARTIFACT_REGISTRY",
-"BUILD",
-"SERVICE",
-"TRIGGER",
-"SERVICE_ROLLBACK",
-"TRIGGER_ROLLBACK"
-],
-"enumDescriptions": [
-"Not specified. Invalid name.",
-"Artifact Regsitry Stage",
-"Build Stage",
-"Service Stage",
-"Trigger Stage",
-"Service Rollback Stage",
-"Trigger Rollback Stage"
-],
-"type": "string"
-},
-"resource": {
-"description": "Resource of the Stage",
-"type": "string"
-},
-"resourceUri": {
-"description": "Link to the current Stage resource",
-"type": "string"
-},
-"state": {
-"description": "Current state of the Stage",
-"enum": [
-"STATE_UNSPECIFIED",
-"NOT_STARTED",
-"IN_PROGRESS",
-"COMPLETE"
-],
-"enumDescriptions": [
-"Not specified. Invalid state.",
-"Stage has not started.",
-"Stage is in progress.",
-"Stage has completed."
-],
-"type": "string"
-},
-"stateMessages": {
-"description": "State messages from the current Stage.",
-"items": {
-"$ref": "GoogleCloudFunctionsV2StateMessage"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2StateMessage": {
-"description": "Informational messages about the state of the Cloud Function or Operation.",
-"id": "GoogleCloudFunctionsV2StateMessage",
-"properties": {
-"message": {
-"description": "The message.",
-"type": "string"
-},
-"severity": {
-"description": "Severity of the state message.",
-"enum": [
-"SEVERITY_UNSPECIFIED",
-"ERROR",
-"WARNING",
-"INFO"
-],
-"enumDescriptions": [
-"Not specified. Invalid severity.",
-"ERROR-level severity.",
-"WARNING-level severity.",
-"INFO-level severity."
-],
-"type": "string"
-},
-"type": {
-"description": "One-word CamelCase type of the state message.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2alphaLocationMetadata": {
-"description": "Extra GCF specific location information.",
-"id": "GoogleCloudFunctionsV2alphaLocationMetadata",
-"properties": {
-"environments": {
-"description": "The Cloud Function environments this location supports.",
-"items": {
-"enum": [
-"ENVIRONMENT_UNSPECIFIED",
-"GEN_1",
-"GEN_2"
-],
-"enumDescriptions": [
-"Unspecified",
-"Gen 1",
-"Gen 2"
-],
-"type": "string"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2alphaOperationMetadata": {
-"description": "Represents the metadata of the long-running operation.",
-"id": "GoogleCloudFunctionsV2alphaOperationMetadata",
-"properties": {
-"apiVersion": {
-"description": "API version used to start the operation.",
-"type": "string"
-},
-"buildName": {
-"description": "The build name of the function for create and update operations.",
-"type": "string"
-},
-"cancelRequested": {
-"description": "Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have google.longrunning.Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
-"type": "boolean"
-},
-"createTime": {
-"description": "The time the operation was created.",
-"format": "google-datetime",
-"type": "string"
-},
-"endTime": {
-"description": "The time the operation finished running.",
-"format": "google-datetime",
-"type": "string"
-},
-"operationType": {
-"description": "The operation type.",
-"enum": [
-"OPERATIONTYPE_UNSPECIFIED",
-"CREATE_FUNCTION",
-"UPDATE_FUNCTION",
-"DELETE_FUNCTION",
-"REDIRECT_FUNCTION_UPGRADE_TRAFFIC",
-"ROLLBACK_FUNCTION_UPGRADE_TRAFFIC",
-"SETUP_FUNCTION_UPGRADE_CONFIG",
-"ABORT_FUNCTION_UPGRADE",
-"COMMIT_FUNCTION_UPGRADE"
-],
-"enumDescriptions": [
-"Unspecified",
-"CreateFunction",
-"UpdateFunction",
-"DeleteFunction",
-"RedirectFunctionUpgradeTraffic",
-"RollbackFunctionUpgradeTraffic",
-"SetupFunctionUpgradeConfig",
-"AbortFunctionUpgrade",
-"CommitFunctionUpgrade"
-],
-"type": "string"
-},
-"requestResource": {
-"additionalProperties": {
-"description": "Properties of the object. Contains field @type with type URL.",
-"type": "any"
-},
-"description": "The original request that started the operation.",
-"type": "object"
-},
-"sourceToken": {
-"description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.",
-"type": "string"
-},
-"stages": {
-"description": "Mechanism for reporting in-progress stages",
-"items": {
-"$ref": "GoogleCloudFunctionsV2alphaStage"
-},
-"type": "array"
-},
-"statusDetail": {
-"description": "Human-readable status of the operation, if any.",
-"type": "string"
-},
-"target": {
-"description": "Server-defined resource path for the target of the operation.",
-"type": "string"
-},
-"verb": {
-"description": "Name of the verb executed by the operation.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2alphaStage": {
-"description": "Each Stage of the deployment process",
-"id": "GoogleCloudFunctionsV2alphaStage",
-"properties": {
-"message": {
-"description": "Message describing the Stage",
-"type": "string"
-},
-"name": {
-"description": "Name of the Stage. This will be unique for each Stage.",
-"enum": [
-"NAME_UNSPECIFIED",
-"ARTIFACT_REGISTRY",
-"BUILD",
-"SERVICE",
-"TRIGGER",
-"SERVICE_ROLLBACK",
-"TRIGGER_ROLLBACK"
-],
-"enumDescriptions": [
-"Not specified. Invalid name.",
-"Artifact Regsitry Stage",
-"Build Stage",
-"Service Stage",
-"Trigger Stage",
-"Service Rollback Stage",
-"Trigger Rollback Stage"
-],
-"type": "string"
-},
-"resource": {
-"description": "Resource of the Stage",
-"type": "string"
-},
-"resourceUri": {
-"description": "Link to the current Stage resource",
-"type": "string"
-},
-"state": {
-"description": "Current state of the Stage",
-"enum": [
-"STATE_UNSPECIFIED",
-"NOT_STARTED",
-"IN_PROGRESS",
-"COMPLETE"
-],
-"enumDescriptions": [
-"Not specified. Invalid state.",
-"Stage has not started.",
-"Stage is in progress.",
-"Stage has completed."
-],
-"type": "string"
-},
-"stateMessages": {
-"description": "State messages from the current Stage.",
-"items": {
-"$ref": "GoogleCloudFunctionsV2alphaStateMessage"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2alphaStateMessage": {
-"description": "Informational messages about the state of the Cloud Function or Operation.",
-"id": "GoogleCloudFunctionsV2alphaStateMessage",
-"properties": {
-"message": {
-"description": "The message.",
-"type": "string"
-},
-"severity": {
-"description": "Severity of the state message.",
-"enum": [
-"SEVERITY_UNSPECIFIED",
-"ERROR",
-"WARNING",
-"INFO"
-],
-"enumDescriptions": [
-"Not specified. Invalid severity.",
-"ERROR-level severity.",
-"WARNING-level severity.",
-"INFO-level severity."
-],
-"type": "string"
-},
-"type": {
-"description": "One-word CamelCase type of the state message.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2betaLocationMetadata": {
-"description": "Extra GCF specific location information.",
-"id": "GoogleCloudFunctionsV2betaLocationMetadata",
-"properties": {
-"environments": {
-"description": "The Cloud Function environments this location supports.",
-"items": {
-"enum": [
-"ENVIRONMENT_UNSPECIFIED",
-"GEN_1",
-"GEN_2"
-],
-"enumDescriptions": [
-"Unspecified",
-"Gen 1",
-"Gen 2"
-],
-"type": "string"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2betaOperationMetadata": {
-"description": "Represents the metadata of the long-running operation.",
-"id": "GoogleCloudFunctionsV2betaOperationMetadata",
-"properties": {
-"apiVersion": {
-"description": "API version used to start the operation.",
-"type": "string"
-},
-"buildName": {
-"description": "The build name of the function for create and update operations.",
-"type": "string"
-},
-"cancelRequested": {
-"description": "Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have google.longrunning.Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
-"type": "boolean"
-},
-"createTime": {
-"description": "The time the operation was created.",
-"format": "google-datetime",
-"type": "string"
-},
-"endTime": {
-"description": "The time the operation finished running.",
-"format": "google-datetime",
-"type": "string"
-},
-"operationType": {
-"description": "The operation type.",
-"enum": [
-"OPERATIONTYPE_UNSPECIFIED",
-"CREATE_FUNCTION",
-"UPDATE_FUNCTION",
-"DELETE_FUNCTION",
-"REDIRECT_FUNCTION_UPGRADE_TRAFFIC",
-"ROLLBACK_FUNCTION_UPGRADE_TRAFFIC",
-"SETUP_FUNCTION_UPGRADE_CONFIG",
-"ABORT_FUNCTION_UPGRADE",
-"COMMIT_FUNCTION_UPGRADE"
-],
-"enumDescriptions": [
-"Unspecified",
-"CreateFunction",
-"UpdateFunction",
-"DeleteFunction",
-"RedirectFunctionUpgradeTraffic",
-"RollbackFunctionUpgradeTraffic",
-"SetupFunctionUpgradeConfig",
-"AbortFunctionUpgrade",
-"CommitFunctionUpgrade"
-],
-"type": "string"
-},
-"requestResource": {
-"additionalProperties": {
-"description": "Properties of the object. Contains field @type with type URL.",
-"type": "any"
-},
-"description": "The original request that started the operation.",
-"type": "object"
-},
-"sourceToken": {
-"description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.",
-"type": "string"
-},
-"stages": {
-"description": "Mechanism for reporting in-progress stages",
-"items": {
-"$ref": "GoogleCloudFunctionsV2betaStage"
-},
-"type": "array"
-},
-"statusDetail": {
-"description": "Human-readable status of the operation, if any.",
-"type": "string"
-},
-"target": {
-"description": "Server-defined resource path for the target of the operation.",
-"type": "string"
-},
-"verb": {
-"description": "Name of the verb executed by the operation.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2betaStage": {
-"description": "Each Stage of the deployment process",
-"id": "GoogleCloudFunctionsV2betaStage",
-"properties": {
-"message": {
-"description": "Message describing the Stage",
-"type": "string"
-},
-"name": {
-"description": "Name of the Stage. This will be unique for each Stage.",
-"enum": [
-"NAME_UNSPECIFIED",
-"ARTIFACT_REGISTRY",
-"BUILD",
-"SERVICE",
-"TRIGGER",
-"SERVICE_ROLLBACK",
-"TRIGGER_ROLLBACK"
-],
-"enumDescriptions": [
-"Not specified. Invalid name.",
-"Artifact Regsitry Stage",
-"Build Stage",
-"Service Stage",
-"Trigger Stage",
-"Service Rollback Stage",
-"Trigger Rollback Stage"
-],
-"type": "string"
-},
-"resource": {
-"description": "Resource of the Stage",
-"type": "string"
-},
-"resourceUri": {
-"description": "Link to the current Stage resource",
-"type": "string"
-},
-"state": {
-"description": "Current state of the Stage",
-"enum": [
-"STATE_UNSPECIFIED",
-"NOT_STARTED",
-"IN_PROGRESS",
-"COMPLETE"
-],
-"enumDescriptions": [
-"Not specified. Invalid state.",
-"Stage has not started.",
-"Stage is in progress.",
-"Stage has completed."
-],
-"type": "string"
-},
-"stateMessages": {
-"description": "State messages from the current Stage.",
-"items": {
-"$ref": "GoogleCloudFunctionsV2betaStateMessage"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2betaStateMessage": {
-"description": "Informational messages about the state of the Cloud Function or Operation.",
-"id": "GoogleCloudFunctionsV2betaStateMessage",
-"properties": {
-"message": {
-"description": "The message.",
-"type": "string"
-},
-"severity": {
-"description": "Severity of the state message.",
-"enum": [
-"SEVERITY_UNSPECIFIED",
-"ERROR",
-"WARNING",
-"INFO"
-],
-"enumDescriptions": [
-"Not specified. Invalid severity.",
-"ERROR-level severity.",
-"WARNING-level severity.",
-"INFO-level severity."
-],
-"type": "string"
-},
-"type": {
-"description": "One-word CamelCase type of the state message.",
-"type": "string"
-}
-},
-"type": "object"
-},
 "HttpsTrigger": {
 "description": "Describes HttpsTrigger, could be used to connect web hooks to function.",
 "id": "HttpsTrigger",
diff --git a/googleapiclient/discovery_cache/documents/cloudfunctions.v2.json b/googleapiclient/discovery_cache/documents/cloudfunctions.v2.json
index 998f899c8e9..ff730966bf5 100644
--- a/googleapiclient/discovery_cache/documents/cloudfunctions.v2.json
+++ b/googleapiclient/discovery_cache/documents/cloudfunctions.v2.json
@@ -716,7 +716,7 @@
 }
 }
 },
-"revision": "20240822",
+"revision": "20240905",
 "rootUrl": "https://cloudfunctions.googleapis.com/",
 "schemas": {
 "AbortFunctionUpgradeRequest": {
@@ -1370,416 +1370,6 @@
 },
 "type": "object"
 },
-"GoogleCloudFunctionsV2alphaLocationMetadata": {
-"description": "Extra GCF specific location information.",
-"id": "GoogleCloudFunctionsV2alphaLocationMetadata",
-"properties": {
-"environments": {
-"description": "The Cloud Function environments this location supports.",
-"items": {
-"enum": [
-"ENVIRONMENT_UNSPECIFIED",
-"GEN_1",
-"GEN_2"
-],
-"enumDescriptions": [
-"Unspecified",
-"Gen 1",
-"Gen 2"
-],
-"type": "string"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2alphaOperationMetadata": {
-"description": "Represents the metadata of the long-running operation.",
-"id": "GoogleCloudFunctionsV2alphaOperationMetadata",
-"properties": {
-"apiVersion": {
-"description": "API version used to start the operation.",
-"type": "string"
-},
-"buildName": {
-"description": "The build name of the function for create and update operations.",
-"type": "string"
-},
-"cancelRequested": {
-"description": "Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have google.longrunning.Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
-"type": "boolean"
-},
-"createTime": {
-"description": "The time the operation was created.",
-"format": "google-datetime",
-"type": "string"
-},
-"endTime": {
-"description": "The time the operation finished running.",
-"format": "google-datetime",
-"type": "string"
-},
-"operationType": {
-"description": "The operation type.",
-"enum": [
-"OPERATIONTYPE_UNSPECIFIED",
-"CREATE_FUNCTION",
-"UPDATE_FUNCTION",
-"DELETE_FUNCTION",
-"REDIRECT_FUNCTION_UPGRADE_TRAFFIC",
-"ROLLBACK_FUNCTION_UPGRADE_TRAFFIC",
-"SETUP_FUNCTION_UPGRADE_CONFIG",
-"ABORT_FUNCTION_UPGRADE",
-"COMMIT_FUNCTION_UPGRADE"
-],
-"enumDescriptions": [
-"Unspecified",
-"CreateFunction",
-"UpdateFunction",
-"DeleteFunction",
-"RedirectFunctionUpgradeTraffic",
-"RollbackFunctionUpgradeTraffic",
-"SetupFunctionUpgradeConfig",
-"AbortFunctionUpgrade",
-"CommitFunctionUpgrade"
-],
-"type": "string"
-},
-"requestResource": {
-"additionalProperties": {
-"description": "Properties of the object. Contains field @type with type URL.",
-"type": "any"
-},
-"description": "The original request that started the operation.",
-"type": "object"
-},
-"sourceToken": {
-"description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.",
-"type": "string"
-},
-"stages": {
-"description": "Mechanism for reporting in-progress stages",
-"items": {
-"$ref": "GoogleCloudFunctionsV2alphaStage"
-},
-"type": "array"
-},
-"statusDetail": {
-"description": "Human-readable status of the operation, if any.",
-"type": "string"
-},
-"target": {
-"description": "Server-defined resource path for the target of the operation.",
-"type": "string"
-},
-"verb": {
-"description": "Name of the verb executed by the operation.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2alphaStage": {
-"description": "Each Stage of the deployment process",
-"id": "GoogleCloudFunctionsV2alphaStage",
-"properties": {
-"message": {
-"description": "Message describing the Stage",
-"type": "string"
-},
-"name": {
-"description": "Name of the Stage. This will be unique for each Stage.",
-"enum": [
-"NAME_UNSPECIFIED",
-"ARTIFACT_REGISTRY",
-"BUILD",
-"SERVICE",
-"TRIGGER",
-"SERVICE_ROLLBACK",
-"TRIGGER_ROLLBACK"
-],
-"enumDescriptions": [
-"Not specified. Invalid name.",
-"Artifact Regsitry Stage",
-"Build Stage",
-"Service Stage",
-"Trigger Stage",
-"Service Rollback Stage",
-"Trigger Rollback Stage"
-],
-"type": "string"
-},
-"resource": {
-"description": "Resource of the Stage",
-"type": "string"
-},
-"resourceUri": {
-"description": "Link to the current Stage resource",
-"type": "string"
-},
-"state": {
-"description": "Current state of the Stage",
-"enum": [
-"STATE_UNSPECIFIED",
-"NOT_STARTED",
-"IN_PROGRESS",
-"COMPLETE"
-],
-"enumDescriptions": [
-"Not specified. Invalid state.",
-"Stage has not started.",
-"Stage is in progress.",
-"Stage has completed."
-],
-"type": "string"
-},
-"stateMessages": {
-"description": "State messages from the current Stage.",
-"items": {
-"$ref": "GoogleCloudFunctionsV2alphaStateMessage"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2alphaStateMessage": {
-"description": "Informational messages about the state of the Cloud Function or Operation.",
-"id": "GoogleCloudFunctionsV2alphaStateMessage",
-"properties": {
-"message": {
-"description": "The message.",
-"type": "string"
-},
-"severity": {
-"description": "Severity of the state message.",
-"enum": [
-"SEVERITY_UNSPECIFIED",
-"ERROR",
-"WARNING",
-"INFO"
-],
-"enumDescriptions": [
-"Not specified. Invalid severity.",
-"ERROR-level severity.",
-"WARNING-level severity.",
-"INFO-level severity."
-],
-"type": "string"
-},
-"type": {
-"description": "One-word CamelCase type of the state message.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2betaLocationMetadata": {
-"description": "Extra GCF specific location information.",
-"id": "GoogleCloudFunctionsV2betaLocationMetadata",
-"properties": {
-"environments": {
-"description": "The Cloud Function environments this location supports.",
-"items": {
-"enum": [
-"ENVIRONMENT_UNSPECIFIED",
-"GEN_1",
-"GEN_2"
-],
-"enumDescriptions": [
-"Unspecified",
-"Gen 1",
-"Gen 2"
-],
-"type": "string"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2betaOperationMetadata": {
-"description": "Represents the metadata of the long-running operation.",
-"id": "GoogleCloudFunctionsV2betaOperationMetadata",
-"properties": {
-"apiVersion": {
-"description": "API version used to start the operation.",
-"type": "string"
-},
-"buildName": {
-"description": "The build name of the function for create and update operations.",
-"type": "string"
-},
-"cancelRequested": {
-"description": "Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have google.longrunning.Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
-"type": "boolean"
-},
-"createTime": {
-"description": "The time the operation was created.",
-"format": "google-datetime",
-"type": "string"
-},
-"endTime": {
-"description": "The time the operation finished running.",
-"format": "google-datetime",
-"type": "string"
-},
-"operationType": {
-"description": "The operation type.",
-"enum": [
-"OPERATIONTYPE_UNSPECIFIED",
-"CREATE_FUNCTION",
-"UPDATE_FUNCTION",
-"DELETE_FUNCTION",
-"REDIRECT_FUNCTION_UPGRADE_TRAFFIC",
-"ROLLBACK_FUNCTION_UPGRADE_TRAFFIC",
-"SETUP_FUNCTION_UPGRADE_CONFIG",
-"ABORT_FUNCTION_UPGRADE",
-"COMMIT_FUNCTION_UPGRADE"
-],
-"enumDescriptions": [
-"Unspecified",
-"CreateFunction",
-"UpdateFunction",
-"DeleteFunction",
-"RedirectFunctionUpgradeTraffic",
-"RollbackFunctionUpgradeTraffic",
-"SetupFunctionUpgradeConfig",
-"AbortFunctionUpgrade",
-"CommitFunctionUpgrade"
-],
-"type": "string"
-},
-"requestResource": {
-"additionalProperties": {
-"description": "Properties of the object. Contains field @type with type URL.",
-"type": "any"
-},
-"description": "The original request that started the operation.",
-"type": "object"
-},
-"sourceToken": {
-"description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.",
-"type": "string"
-},
-"stages": {
-"description": "Mechanism for reporting in-progress stages",
-"items": {
-"$ref": "GoogleCloudFunctionsV2betaStage"
-},
-"type": "array"
-},
-"statusDetail": {
-"description": "Human-readable status of the operation, if any.",
-"type": "string"
-},
-"target": {
-"description": "Server-defined resource path for the target of the operation.",
-"type": "string"
-},
-"verb": {
-"description": "Name of the verb executed by the operation.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2betaStage": {
-"description": "Each Stage of the deployment process",
-"id": "GoogleCloudFunctionsV2betaStage",
-"properties": {
-"message": {
-"description": "Message describing the Stage",
-"type": "string"
-},
-"name": {
-"description": "Name of the Stage. This will be unique for each Stage.",
-"enum": [
-"NAME_UNSPECIFIED",
-"ARTIFACT_REGISTRY",
-"BUILD",
-"SERVICE",
-"TRIGGER",
-"SERVICE_ROLLBACK",
-"TRIGGER_ROLLBACK"
-],
-"enumDescriptions": [
-"Not specified. Invalid name.",
-"Artifact Regsitry Stage",
-"Build Stage",
-"Service Stage",
-"Trigger Stage",
-"Service Rollback Stage",
-"Trigger Rollback Stage"
-],
-"type": "string"
-},
-"resource": {
-"description": "Resource of the Stage",
-"type": "string"
-},
-"resourceUri": {
-"description": "Link to the current Stage resource",
-"type": "string"
-},
-"state": {
-"description": "Current state of the Stage",
-"enum": [
-"STATE_UNSPECIFIED",
-"NOT_STARTED",
-"IN_PROGRESS",
-"COMPLETE"
-],
-"enumDescriptions": [
-"Not specified. Invalid state.",
-"Stage has not started.",
-"Stage is in progress.",
-"Stage has completed."
-],
-"type": "string"
-},
-"stateMessages": {
-"description": "State messages from the current Stage.",
-"items": {
-"$ref": "GoogleCloudFunctionsV2betaStateMessage"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2betaStateMessage": {
-"description": "Informational messages about the state of the Cloud Function or Operation.",
-"id": "GoogleCloudFunctionsV2betaStateMessage",
-"properties": {
-"message": {
-"description": "The message.",
-"type": "string"
-},
-"severity": {
-"description": "Severity of the state message.",
-"enum": [
-"SEVERITY_UNSPECIFIED",
-"ERROR",
-"WARNING",
-"INFO"
-],
-"enumDescriptions": [
-"Not specified. Invalid severity.",
-"ERROR-level severity.",
-"WARNING-level severity.",
-"INFO-level severity."
-],
-"type": "string"
-},
-"type": {
-"description": "One-word CamelCase type of the state message.",
-"type": "string"
-}
-},
-"type": "object"
-},
 "ListFunctionsResponse": {
 "description": "Response for the `ListFunctions` method.",
 "id": "ListFunctionsResponse",
diff --git a/googleapiclient/discovery_cache/documents/cloudfunctions.v2alpha.json b/googleapiclient/discovery_cache/documents/cloudfunctions.v2alpha.json
index e92df197d27..4db5bdb2346 100644
--- a/googleapiclient/discovery_cache/documents/cloudfunctions.v2alpha.json
+++ b/googleapiclient/discovery_cache/documents/cloudfunctions.v2alpha.json
@@ -716,7 +716,7 @@
 }
 }
 },
-"revision": "20240822",
+"revision": "20240905",
 "rootUrl": "https://cloudfunctions.googleapis.com/",
 "schemas": {
 "AbortFunctionUpgradeRequest": {
@@ -1165,211 +1165,6 @@
 },
 "type": "object"
 },
-"GoogleCloudFunctionsV2LocationMetadata": {
-"description": "Extra GCF specific location information.",
-"id": "GoogleCloudFunctionsV2LocationMetadata",
-"properties": {
-"environments": {
-"description": "The Cloud Function environments this location supports.",
-"items": {
-"enum": [
-"ENVIRONMENT_UNSPECIFIED",
-"GEN_1",
-"GEN_2"
-],
-"enumDescriptions": [
-"Unspecified",
-"Gen 1",
-"Gen 2"
-],
-"type": "string"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2OperationMetadata": {
-"description": "Represents the metadata of the long-running operation.",
-"id": "GoogleCloudFunctionsV2OperationMetadata",
-"properties": {
-"apiVersion": {
-"description": "API version used to start the operation.",
-"type": "string"
-},
-"buildName": {
-"description": "The build name of the function for create and update operations.",
-"type": "string"
-},
-"cancelRequested": {
-"description": "Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have google.longrunning.Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
-"type": "boolean"
-},
-"createTime": {
-"description": "The time the operation was created.",
-"format": "google-datetime",
-"type": "string"
-},
-"endTime": {
-"description": "The time the operation finished running.",
-"format": "google-datetime",
-"type": "string"
-},
-"operationType": {
-"description": "The operation type.",
-"enum": [
-"OPERATIONTYPE_UNSPECIFIED",
-"CREATE_FUNCTION",
-"UPDATE_FUNCTION",
-"DELETE_FUNCTION",
-"REDIRECT_FUNCTION_UPGRADE_TRAFFIC",
-"ROLLBACK_FUNCTION_UPGRADE_TRAFFIC",
-"SETUP_FUNCTION_UPGRADE_CONFIG",
-"ABORT_FUNCTION_UPGRADE",
-"COMMIT_FUNCTION_UPGRADE"
-],
-"enumDescriptions": [
-"Unspecified",
-"CreateFunction",
-"UpdateFunction",
-"DeleteFunction",
-"RedirectFunctionUpgradeTraffic",
-"RollbackFunctionUpgradeTraffic",
-"SetupFunctionUpgradeConfig",
-"AbortFunctionUpgrade",
-"CommitFunctionUpgrade"
-],
-"type": "string"
-},
-"requestResource": {
-"additionalProperties": {
-"description": "Properties of the object. Contains field @type with type URL.",
-"type": "any"
-},
-"description": "The original request that started the operation.",
-"type": "object"
-},
-"sourceToken": {
-"description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.",
-"type": "string"
-},
-"stages": {
-"description": "Mechanism for reporting in-progress stages",
-"items": {
-"$ref": "GoogleCloudFunctionsV2Stage"
-},
-"type": "array"
-},
-"statusDetail": {
-"description": "Human-readable status of the operation, if any.",
-"type": "string"
-},
-"target": {
-"description": "Server-defined resource path for the target of the operation.",
-"type": "string"
-},
-"verb": {
-"description": "Name of the verb executed by the operation.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2Stage": {
-"description": "Each Stage of the deployment process",
-"id": "GoogleCloudFunctionsV2Stage",
-"properties": {
-"message": {
-"description": "Message describing the Stage",
-"type": "string"
-},
-"name": {
-"description": "Name of the Stage. This will be unique for each Stage.",
-"enum": [
-"NAME_UNSPECIFIED",
-"ARTIFACT_REGISTRY",
-"BUILD",
-"SERVICE",
-"TRIGGER",
-"SERVICE_ROLLBACK",
-"TRIGGER_ROLLBACK"
-],
-"enumDescriptions": [
-"Not specified. Invalid name.",
-"Artifact Regsitry Stage",
-"Build Stage",
-"Service Stage",
-"Trigger Stage",
-"Service Rollback Stage",
-"Trigger Rollback Stage"
-],
-"type": "string"
-},
-"resource": {
-"description": "Resource of the Stage",
-"type": "string"
-},
-"resourceUri": {
-"description": "Link to the current Stage resource",
-"type": "string"
-},
-"state": {
-"description": "Current state of the Stage",
-"enum": [
-"STATE_UNSPECIFIED",
-"NOT_STARTED",
-"IN_PROGRESS",
-"COMPLETE"
-],
-"enumDescriptions": [
-"Not specified. Invalid state.",
-"Stage has not started.",
-"Stage is in progress.",
-"Stage has completed."
-],
-"type": "string"
-},
-"stateMessages": {
-"description": "State messages from the current Stage.",
-"items": {
-"$ref": "GoogleCloudFunctionsV2StateMessage"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2StateMessage": {
-"description": "Informational messages about the state of the Cloud Function or Operation.",
-"id": "GoogleCloudFunctionsV2StateMessage",
-"properties": {
-"message": {
-"description": "The message.",
-"type": "string"
-},
-"severity": {
-"description": "Severity of the state message.",
-"enum": [
-"SEVERITY_UNSPECIFIED",
-"ERROR",
-"WARNING",
-"INFO"
-],
-"enumDescriptions": [
-"Not specified. Invalid severity.",
-"ERROR-level severity.",
-"WARNING-level severity.",
-"INFO-level severity."
-],
-"type": "string"
-},
-"type": {
-"description": "One-word CamelCase type of the state message.",
-"type": "string"
-}
-},
-"type": "object"
-},
 "GoogleCloudFunctionsV2alphaLocationMetadata": {
 "description": "Extra GCF specific location information.",
 "id": "GoogleCloudFunctionsV2alphaLocationMetadata",
@@ -1575,211 +1370,6 @@
 },
 "type": "object"
 },
-"GoogleCloudFunctionsV2betaLocationMetadata": {
-"description": "Extra GCF specific location information.",
-"id": "GoogleCloudFunctionsV2betaLocationMetadata",
-"properties": {
-"environments": {
-"description": "The Cloud Function environments this location supports.",
-"items": {
-"enum": [
-"ENVIRONMENT_UNSPECIFIED",
-"GEN_1",
-"GEN_2"
-],
-"enumDescriptions": [
-"Unspecified",
-"Gen 1",
-"Gen 2"
-],
-"type": "string"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2betaOperationMetadata": {
-"description": "Represents the metadata of the long-running operation.",
-"id": "GoogleCloudFunctionsV2betaOperationMetadata",
-"properties": {
-"apiVersion": {
-"description": "API version used to start the operation.",
-"type": "string"
-},
-"buildName": {
-"description": "The build name of the function for create and update operations.",
-"type": "string"
-},
-"cancelRequested": {
-"description": "Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have google.longrunning.Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
-"type": "boolean"
-},
-"createTime": {
-"description": "The time the operation was created.",
-"format": "google-datetime",
-"type": "string"
-},
-"endTime": {
-"description": "The time the operation finished running.",
-"format": "google-datetime",
-"type": "string"
-},
-"operationType": {
-"description": "The operation type.",
-"enum": [
-"OPERATIONTYPE_UNSPECIFIED",
-"CREATE_FUNCTION",
-"UPDATE_FUNCTION",
-"DELETE_FUNCTION",
-"REDIRECT_FUNCTION_UPGRADE_TRAFFIC",
-"ROLLBACK_FUNCTION_UPGRADE_TRAFFIC",
-"SETUP_FUNCTION_UPGRADE_CONFIG",
-"ABORT_FUNCTION_UPGRADE",
-"COMMIT_FUNCTION_UPGRADE"
-],
-"enumDescriptions": [
-"Unspecified",
-"CreateFunction",
-"UpdateFunction",
-"DeleteFunction",
-"RedirectFunctionUpgradeTraffic",
-"RollbackFunctionUpgradeTraffic",
-"SetupFunctionUpgradeConfig",
-"AbortFunctionUpgrade",
-"CommitFunctionUpgrade"
-],
-"type": "string"
-},
-"requestResource": {
-"additionalProperties": {
-"description": "Properties of the object. Contains field @type with type URL.",
-"type": "any"
-},
-"description": "The original request that started the operation.",
-"type": "object"
-},
-"sourceToken": {
-"description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.",
-"type": "string"
-},
-"stages": {
-"description": "Mechanism for reporting in-progress stages",
-"items": {
-"$ref": "GoogleCloudFunctionsV2betaStage"
-},
-"type": "array"
-},
-"statusDetail": {
-"description": "Human-readable status of the operation, if any.",
-"type": "string"
-},
-"target": {
-"description": "Server-defined resource path for the target of the operation.",
-"type": "string"
-},
-"verb": {
-"description": "Name of the verb executed by the operation.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2betaStage": {
-"description": "Each Stage of the deployment process",
-"id": "GoogleCloudFunctionsV2betaStage",
-"properties": {
-"message": {
-"description": "Message describing the Stage",
-"type": "string"
-},
-"name": {
-"description": "Name of the Stage. This will be unique for each Stage.",
-"enum": [
-"NAME_UNSPECIFIED",
-"ARTIFACT_REGISTRY",
-"BUILD",
-"SERVICE",
-"TRIGGER",
-"SERVICE_ROLLBACK",
-"TRIGGER_ROLLBACK"
-],
-"enumDescriptions": [
-"Not specified. Invalid name.",
-"Artifact Regsitry Stage",
-"Build Stage",
-"Service Stage",
-"Trigger Stage",
-"Service Rollback Stage",
-"Trigger Rollback Stage"
-],
-"type": "string"
-},
-"resource": {
-"description": "Resource of the Stage",
-"type": "string"
-},
-"resourceUri": {
-"description": "Link to the current Stage resource",
-"type": "string"
-},
-"state": {
-"description": "Current state of the Stage",
-"enum": [
-"STATE_UNSPECIFIED",
-"NOT_STARTED",
-"IN_PROGRESS",
-"COMPLETE"
-],
-"enumDescriptions": [
-"Not specified. Invalid state.",
-"Stage has not started.",
-"Stage is in progress.",
-"Stage has completed."
-],
-"type": "string"
-},
-"stateMessages": {
-"description": "State messages from the current Stage.",
-"items": {
-"$ref": "GoogleCloudFunctionsV2betaStateMessage"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2betaStateMessage": {
-"description": "Informational messages about the state of the Cloud Function or Operation.",
-"id": "GoogleCloudFunctionsV2betaStateMessage",
-"properties": {
-"message": {
-"description": "The message.",
-"type": "string"
-},
-"severity": {
-"description": "Severity of the state message.",
-"enum": [
-"SEVERITY_UNSPECIFIED",
-"ERROR",
-"WARNING",
-"INFO"
-],
-"enumDescriptions": [
-"Not specified. Invalid severity.",
-"ERROR-level severity.",
-"WARNING-level severity.",
-"INFO-level severity."
-],
-"type": "string"
-},
-"type": {
-"description": "One-word CamelCase type of the state message.",
-"type": "string"
-}
-},
-"type": "object"
-},
 "ListFunctionsResponse": {
 "description": "Response for the `ListFunctions` method.",
 "id": "ListFunctionsResponse",
diff --git a/googleapiclient/discovery_cache/documents/cloudfunctions.v2beta.json b/googleapiclient/discovery_cache/documents/cloudfunctions.v2beta.json
index 86857ee613d..1bb7552541c 100644
--- a/googleapiclient/discovery_cache/documents/cloudfunctions.v2beta.json
+++ b/googleapiclient/discovery_cache/documents/cloudfunctions.v2beta.json
@@ -716,7 +716,7 @@
 }
 }
 },
-"revision": "20240822",
+"revision": "20240905",
 "rootUrl": "https://cloudfunctions.googleapis.com/",
 "schemas": {
 "AbortFunctionUpgradeRequest": {
@@ -1165,416 +1165,6 @@
 },
 "type": "object"
 },
-"GoogleCloudFunctionsV2LocationMetadata": {
-"description": "Extra GCF specific location information.",
-"id": "GoogleCloudFunctionsV2LocationMetadata",
-"properties": {
-"environments": {
-"description": "The Cloud Function environments this location supports.",
-"items": {
-"enum": [
-"ENVIRONMENT_UNSPECIFIED",
-"GEN_1",
-"GEN_2"
-],
-"enumDescriptions": [
-"Unspecified",
-"Gen 1",
-"Gen 2"
-],
-"type": "string"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2OperationMetadata": {
-"description": "Represents the metadata of the long-running operation.",
-"id": "GoogleCloudFunctionsV2OperationMetadata",
-"properties": {
-"apiVersion": {
-"description": "API version used to start the operation.",
-"type": "string"
-},
-"buildName": {
-"description": "The build name of the function for create and update operations.",
-"type": "string"
-},
-"cancelRequested": {
-"description": "Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have google.longrunning.Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
-"type": "boolean"
-},
-"createTime": {
-"description": "The time the operation was created.",
-"format": "google-datetime",
-"type": "string"
-},
-"endTime": {
-"description": "The time the operation finished running.",
-"format": "google-datetime",
-"type": "string"
-},
-"operationType": {
-"description": "The operation type.",
-"enum": [
-"OPERATIONTYPE_UNSPECIFIED",
-"CREATE_FUNCTION",
-"UPDATE_FUNCTION",
-"DELETE_FUNCTION",
-"REDIRECT_FUNCTION_UPGRADE_TRAFFIC",
-"ROLLBACK_FUNCTION_UPGRADE_TRAFFIC",
-"SETUP_FUNCTION_UPGRADE_CONFIG",
-"ABORT_FUNCTION_UPGRADE",
-"COMMIT_FUNCTION_UPGRADE"
-],
-"enumDescriptions": [
-"Unspecified",
-"CreateFunction",
-"UpdateFunction",
-"DeleteFunction",
-"RedirectFunctionUpgradeTraffic",
-"RollbackFunctionUpgradeTraffic",
-"SetupFunctionUpgradeConfig",
-"AbortFunctionUpgrade",
-"CommitFunctionUpgrade"
-],
-"type": "string"
-},
-"requestResource": {
-"additionalProperties": {
-"description": "Properties of the object. Contains field @type with type URL.",
-"type": "any"
-},
-"description": "The original request that started the operation.",
-"type": "object"
-},
-"sourceToken": {
-"description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.",
-"type": "string"
-},
-"stages": {
-"description": "Mechanism for reporting in-progress stages",
-"items": {
-"$ref": "GoogleCloudFunctionsV2Stage"
-},
-"type": "array"
-},
-"statusDetail": {
-"description": "Human-readable status of the operation, if any.",
-"type": "string"
-},
-"target": {
-"description": "Server-defined resource path for the target of the operation.",
-"type": "string"
-},
-"verb": {
-"description": "Name of the verb executed by the operation.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2Stage": {
-"description": "Each Stage of the deployment process",
-"id": "GoogleCloudFunctionsV2Stage",
-"properties": {
-"message": {
-"description": "Message describing the Stage",
-"type": "string"
-},
-"name": {
-"description": "Name of the Stage. This will be unique for each Stage.",
-"enum": [
-"NAME_UNSPECIFIED",
-"ARTIFACT_REGISTRY",
-"BUILD",
-"SERVICE",
-"TRIGGER",
-"SERVICE_ROLLBACK",
-"TRIGGER_ROLLBACK"
-],
-"enumDescriptions": [
-"Not specified. Invalid name.",
-"Artifact Regsitry Stage",
-"Build Stage",
-"Service Stage",
-"Trigger Stage",
-"Service Rollback Stage",
-"Trigger Rollback Stage"
-],
-"type": "string"
-},
-"resource": {
-"description": "Resource of the Stage",
-"type": "string"
-},
-"resourceUri": {
-"description": "Link to the current Stage resource",
-"type": "string"
-},
-"state": {
-"description": "Current state of the Stage",
-"enum": [
-"STATE_UNSPECIFIED",
-"NOT_STARTED",
-"IN_PROGRESS",
-"COMPLETE"
-],
-"enumDescriptions": [
-"Not specified. Invalid state.",
-"Stage has not started.",
-"Stage is in progress.",
-"Stage has completed."
-],
-"type": "string"
-},
-"stateMessages": {
-"description": "State messages from the current Stage.",
-"items": {
-"$ref": "GoogleCloudFunctionsV2StateMessage"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2StateMessage": {
-"description": "Informational messages about the state of the Cloud Function or Operation.",
-"id": "GoogleCloudFunctionsV2StateMessage",
-"properties": {
-"message": {
-"description": "The message.",
-"type": "string"
-},
-"severity": {
-"description": "Severity of the state message.",
-"enum": [
-"SEVERITY_UNSPECIFIED",
-"ERROR",
-"WARNING",
-"INFO"
-],
-"enumDescriptions": [
-"Not specified. Invalid severity.",
-"ERROR-level severity.",
-"WARNING-level severity.",
-"INFO-level severity."
-],
-"type": "string"
-},
-"type": {
-"description": "One-word CamelCase type of the state message.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2alphaLocationMetadata": {
-"description": "Extra GCF specific location information.",
-"id": "GoogleCloudFunctionsV2alphaLocationMetadata",
-"properties": {
-"environments": {
-"description": "The Cloud Function environments this location supports.",
-"items": {
-"enum": [
-"ENVIRONMENT_UNSPECIFIED",
-"GEN_1",
-"GEN_2"
-],
-"enumDescriptions": [
-"Unspecified",
-"Gen 1",
-"Gen 2"
-],
-"type": "string"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2alphaOperationMetadata": {
-"description": "Represents the metadata of the long-running operation.",
-"id": "GoogleCloudFunctionsV2alphaOperationMetadata",
-"properties": {
-"apiVersion": {
-"description": "API version used to start the operation.",
-"type": "string"
-},
-"buildName": {
-"description": "The build name of the function for create and update operations.",
-"type": "string"
-},
-"cancelRequested": {
-"description": "Identifies whether the user has requested cancellation of the operation. Operations that have successfully been cancelled have google.longrunning.Operation.error value with a google.rpc.Status.code of 1, corresponding to `Code.CANCELLED`.",
-"type": "boolean"
-},
-"createTime": {
-"description": "The time the operation was created.",
-"format": "google-datetime",
-"type": "string"
-},
-"endTime": {
-"description": "The time the operation finished running.",
-"format": "google-datetime",
-"type": "string"
-},
-"operationType": {
-"description": "The operation type.",
-"enum": [
-"OPERATIONTYPE_UNSPECIFIED",
-"CREATE_FUNCTION",
-"UPDATE_FUNCTION",
-"DELETE_FUNCTION",
-"REDIRECT_FUNCTION_UPGRADE_TRAFFIC",
-"ROLLBACK_FUNCTION_UPGRADE_TRAFFIC",
-"SETUP_FUNCTION_UPGRADE_CONFIG",
-"ABORT_FUNCTION_UPGRADE",
-"COMMIT_FUNCTION_UPGRADE"
-],
-"enumDescriptions": [
-"Unspecified",
-"CreateFunction",
-"UpdateFunction",
-"DeleteFunction",
-"RedirectFunctionUpgradeTraffic",
-"RollbackFunctionUpgradeTraffic",
-"SetupFunctionUpgradeConfig",
-"AbortFunctionUpgrade",
-"CommitFunctionUpgrade"
-],
-"type": "string"
-},
-"requestResource": {
-"additionalProperties": {
-"description": "Properties of the object. Contains field @type with type URL.",
-"type": "any"
-},
-"description": "The original request that started the operation.",
-"type": "object"
-},
-"sourceToken": {
-"description": "An identifier for Firebase function sources. Disclaimer: This field is only supported for Firebase function deployments.",
-"type": "string"
-},
-"stages": {
-"description": "Mechanism for reporting in-progress stages",
-"items": {
-"$ref": "GoogleCloudFunctionsV2alphaStage"
-},
-"type": "array"
-},
-"statusDetail": {
-"description": "Human-readable status of the operation, if any.",
-"type": "string"
-},
-"target": {
-"description": "Server-defined resource path for the target of the operation.",
-"type": "string"
-},
-"verb": {
-"description": "Name of the verb executed by the operation.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2alphaStage": {
-"description": "Each Stage of the deployment process",
-"id": "GoogleCloudFunctionsV2alphaStage",
-"properties": {
-"message": {
-"description": "Message describing the Stage",
-"type": "string"
-},
-"name": {
-"description": "Name of the Stage. This will be unique for each Stage.",
-"enum": [
-"NAME_UNSPECIFIED",
-"ARTIFACT_REGISTRY",
-"BUILD",
-"SERVICE",
-"TRIGGER",
-"SERVICE_ROLLBACK",
-"TRIGGER_ROLLBACK"
-],
-"enumDescriptions": [
-"Not specified. Invalid name.",
-"Artifact Regsitry Stage",
-"Build Stage",
-"Service Stage",
-"Trigger Stage",
-"Service Rollback Stage",
-"Trigger Rollback Stage"
-],
-"type": "string"
-},
-"resource": {
-"description": "Resource of the Stage",
-"type": "string"
-},
-"resourceUri": {
-"description": "Link to the current Stage resource",
-"type": "string"
-},
-"state": {
-"description": "Current state of the Stage",
-"enum": [
-"STATE_UNSPECIFIED",
-"NOT_STARTED",
-"IN_PROGRESS",
-"COMPLETE"
-],
-"enumDescriptions": [
-"Not specified. Invalid state.",
-"Stage has not started.",
-"Stage is in progress.",
-"Stage has completed."
-],
-"type": "string"
-},
-"stateMessages": {
-"description": "State messages from the current Stage.",
-"items": {
-"$ref": "GoogleCloudFunctionsV2alphaStateMessage"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudFunctionsV2alphaStateMessage": {
-"description": "Informational messages about the state of the Cloud Function or Operation.",
-"id": "GoogleCloudFunctionsV2alphaStateMessage",
-"properties": {
-"message": {
-"description": "The message.",
-"type": "string"
-},
-"severity": {
-"description": "Severity of the state message.",
-"enum": [
-"SEVERITY_UNSPECIFIED",
-"ERROR",
-"WARNING",
-"INFO"
-],
-"enumDescriptions": [
-"Not specified. Invalid severity.",
-"ERROR-level severity.",
-"WARNING-level severity.",
-"INFO-level severity."
-],
-"type": "string"
-},
-"type": {
-"description": "One-word CamelCase type of the state message.",
-"type": "string"
-}
-},
-"type": "object"
-},
 "GoogleCloudFunctionsV2betaLocationMetadata": {
 "description": "Extra GCF specific location information.",
 "id": "GoogleCloudFunctionsV2betaLocationMetadata",

From d5e971b43b433b1f3c19438616f26ecdbb1af8c3 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:04 +0000
Subject: [PATCH 11/32] feat(compute): update the api

#### compute:alpha

The following keys were added:
- resources.instantSnapshotGroups.methods.getIamPolicy (Total Keys: 22)
- resources.instantSnapshotGroups.methods.setIamPolicy (Total Keys: 20)
- resources.instantSnapshotGroups.methods.testIamPermissions (Total Keys: 20)
- resources.regionInstantSnapshotGroups.methods.getIamPolicy (Total Keys: 22)
- resources.regionInstantSnapshotGroups.methods.setIamPolicy (Total Keys: 20)
- resources.regionInstantSnapshotGroups.methods.testIamPermissions (Total Keys: 20)
- schemas.InstanceGroupManager.properties.multiMig.type (Total Keys: 1)
- schemas.ManagedInstance.properties.currentActionDetails.$ref (Total Keys: 1)
- schemas.ManagedInstanceCurrentActionDetails (Total Keys: 4)

#### compute:beta

The following keys were added:
- schemas.BackendBucket.properties.usedBy (Total Keys: 2)
- schemas.BackendBucketUsedBy (Total Keys: 3)
- schemas.InstanceGroupManager.properties.multiMig.type (Total Keys: 1)
- schemas.NetworkEndpointGroupPscData.properties.producerPort (Total Keys: 2)

#### compute:v1

The following keys were added:
- schemas.BackendBucket.properties.usedBy (Total Keys: 2)
- schemas.BackendBucketUsedBy (Total Keys: 3)
- schemas.NetworkEndpointGroupPscData.properties.producerPort (Total Keys: 2)
---
 docs/dyn/compute_alpha.backendServices.html   |   4 +-
 .../compute_alpha.instanceGroupManagers.html  |  10 +
 .../compute_alpha.instantSnapshotGroups.html  | 346 ++++++++++++++++++
 .../compute_alpha.regionBackendServices.html  |   4 +-
 ...ute_alpha.regionInstanceGroupManagers.html |   9 +
 ...ute_alpha.regionInstantSnapshotGroups.html | 346 ++++++++++++++++++
 docs/dyn/compute_alpha.routers.html           |   4 +
 docs/dyn/compute_alpha.subnetworks.html       |  10 +-
 docs/dyn/compute_beta.backendBuckets.html     |  25 ++
 docs/dyn/compute_beta.backendServices.html    |   4 +-
 ...pute_beta.globalNetworkEndpointGroups.html |   3 +
 .../compute_beta.instanceGroupManagers.html   |   6 +
 .../compute_beta.networkEndpointGroups.html   |   4 +
 .../compute_beta.regionBackendServices.html   |   4 +-
 ...pute_beta.regionInstanceGroupManagers.html |   5 +
 ...pute_beta.regionNetworkEndpointGroups.html |   3 +
 docs/dyn/compute_beta.subnetworks.html        |  10 +-
 docs/dyn/compute_v1.backendBuckets.html       |  25 ++
 docs/dyn/compute_v1.backendServices.html      |   4 +-
 ...ompute_v1.globalNetworkEndpointGroups.html |   3 +
 .../dyn/compute_v1.networkEndpointGroups.html |   4 +
 .../dyn/compute_v1.regionBackendServices.html |   4 +-
 ...ompute_v1.regionNetworkEndpointGroups.html |   3 +
 docs/dyn/compute_v1.subnetworks.html          |  10 +-
 .../documents/compute.alpha.json              | 338 ++++++++++++++++-
 .../documents/compute.beta.json               |  34 +-
 .../discovery_cache/documents/compute.v1.json |  30 +-
 27 files changed, 1213 insertions(+), 39 deletions(-)

diff --git a/docs/dyn/compute_alpha.backendServices.html b/docs/dyn/compute_alpha.backendServices.html
index a2447f27953..bf608dc4ec3 100644
--- a/docs/dyn/compute_alpha.backendServices.html
+++ b/docs/dyn/compute_alpha.backendServices.html
@@ -109,7 +109,7 @@ Instance Methods
 Retrieves the list of BackendService resources available to the specified project.
 
   listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)
-Retrieves an aggregated list of all usable backend services in the specified project.
+Retrieves a list of all usable backend services in the specified project.
 
   listUsable_next()
 Retrieves the next page of results.
@@ -2805,7 +2805,7 @@ Method Details
 
 
     listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)
-  Retrieves an aggregated list of all usable backend services in the specified project.
+  Retrieves a list of all usable backend services in the specified project.
 
 Args:
   project: string, Project ID for this request. (required)
diff --git a/docs/dyn/compute_alpha.instanceGroupManagers.html b/docs/dyn/compute_alpha.instanceGroupManagers.html
index b11cf5992f1..5e6f7c6e650 100644
--- a/docs/dyn/compute_alpha.instanceGroupManagers.html
+++ b/docs/dyn/compute_alpha.instanceGroupManagers.html
@@ -428,6 +428,7 @@ Method Details
           "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
           "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
           "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+          "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
           "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
           "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
             { # The named port. For example: <"http", 80>.
@@ -1443,6 +1444,7 @@ Method Details
   "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
   "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
   "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+  "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
   "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
   "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
     { # The named port. For example: <"http", 80>.
@@ -1697,6 +1699,7 @@ Method Details
   "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
   "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
   "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+  "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
   "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
   "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
     { # The named port. For example: <"http", 80>.
@@ -2081,6 +2084,7 @@ Method Details
       "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
       "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
       "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+      "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
       "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
       "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
         { # The named port. For example: <"http", 80>.
@@ -2335,6 +2339,10 @@ Method Details
         "revision": "A String", # [Output Only] Current all-instances configuration revision. This value is in RFC3339 text format.
       },
       "currentAction": "A String", # [Output Only] The current action that the managed instance group has scheduled for the instance. Possible values: - NONE The instance is running, and the managed instance group does not have any scheduled actions for this instance. - CREATING The managed instance group is creating this instance. If the group fails to create this instance, it will try again until it is successful. - CREATING_WITHOUT_RETRIES The managed instance group is attempting to create this instance only once. If the group fails to create this instance, it does not try again and the group's targetSize value is decreased instead. - RECREATING The managed instance group is recreating this instance. - DELETING The managed instance group is permanently deleting this instance. - ABANDONING The managed instance group is abandoning this instance. The instance will be removed from the instance group and from any target pools that are associated with this group. - RESTARTING The managed instance group is restarting the instance. - REFRESHING The managed instance group is applying configuration changes to the instance without stopping it. For example, the group can update the target pool list for an instance without stopping that instance. - VERIFYING The managed instance group has created the instance and it is in the process of being verified.
+      "currentActionDetails": {
+        "methodName": "A String",
+        "trigger": "A String", # [Output Only] Details of the current action that the managed instance group has scheduled for the instance. Contains trigger for the current action, and methodName in case it was triggered by API call. Possible values for trigger: - API Any API call. - PROACTIVE_UPDATE Proactive updater scheduled an update on this managed instance. - AUTOSCALING Instance being deleted/created after a decision from the Autoscaler. - REDISTRIBUTION The regional managed instance group is moving instances between zones to restore balance. - STANDBY_REFILL The managed instance group is refilling the Standby Pool (stopped/suspended virtual machines) after scale up. - MAINTENANCE Manual maintenance. - FAILED_CREATION The managed instance group is handling failed instance creation. - INSTANCE_FAILURE The managed instance group is handling instance failure, according to the Instance Lifecycle Policy. - FAILED_HEALTH_CHECK The managed instance group is handling failed health check, according to the Instance Lifecycle Policy. - TERMINATION_TIMESTAMP Instance reached termination time, thus managed instance group stops/deletes it.
+      },
       "id": "A String", # [Output only] The unique identifier for this resource. This field is empty when instance does not exist.
       "instance": "A String", # [Output Only] The URL of the instance. The URL can exist even if the instance has not yet been created.
       "instanceFlexibilityOverride": { # [Output Only] The overrides to instance properties resulting from InstanceFlexibilityPolicy.
@@ -2688,6 +2696,7 @@ Method Details
   "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
   "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
   "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+  "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
   "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
   "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
     { # The named port. For example: <"http", 80>.
@@ -4614,6 +4623,7 @@ Method Details
   "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
   "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
   "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+  "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
   "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
   "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
     { # The named port. For example: <"http", 80>.
diff --git a/docs/dyn/compute_alpha.instantSnapshotGroups.html b/docs/dyn/compute_alpha.instantSnapshotGroups.html
index 24f6c6f6d21..ffba222580b 100644
--- a/docs/dyn/compute_alpha.instantSnapshotGroups.html
+++ b/docs/dyn/compute_alpha.instantSnapshotGroups.html
@@ -83,6 +83,9 @@ Instance Methods
 
   get(project, zone, instantSnapshotGroup, x__xgafv=None)
 returns the specified InstantSnapshotGroup resource in the specified zone.
+
+  getIamPolicy(project, zone, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)
+Gets the access control policy for a resource. May be empty if no such policy or resource exists.
 
   insert(project, zone, body=None, requestId=None, sourceConsistencyGroup=None, x__xgafv=None)
 inserts a Zonal InstantSnapshotGroup resource
@@ -92,6 +95,12 @@ Instance Methods
 
   list_next()
 Retrieves the next page of results.
+
+  setIamPolicy(project, zone, resource, body=None, x__xgafv=None)
+Sets the access control policy on the specified resource. Replaces any existing policy.
+
+  testIamPermissions(project, zone, resource, body=None, x__xgafv=None)
+Returns permissions that a caller has on the specified resource.
 Method Details
 
     close()
@@ -262,6 +271,107 @@ Method Details
 }
 
 
+
+    getIamPolicy(project, zone, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)
+  Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  resource: string, Name or id of the resource for this request. (required)
+  optionsRequestedPolicyVersion: integer, Requested IAM Policy version.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).
+  "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+    { # Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts jose@example.com from DATA_READ logging, and aliya@example.com from DATA_WRITE logging.
+      "auditLogConfigs": [ # The configuration for logging of each type of permission.
+        { # Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.
+          "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.
+            "A String",
+          ],
+          "ignoreChildExemptions": True or False, # This is deprecated and has no effect. Do not use.
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "exemptedMembers": [ # This is deprecated and has no effect. Do not use.
+        "A String",
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.
+    },
+  ],
+  "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.
+    { # Associates `members`, or principals, with a `role`.
+      "bindingId": "A String", # This is deprecated and has no effect. Do not use.
+      "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
+        "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
+        "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
+        "title": "A String", # Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
+      },
+      "members": [ # Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
+        "A String",
+      ],
+      "role": "A String", # Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
+    },
+  ],
+  "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.
+  "rules": [ # This is deprecated and has no effect. Do not use.
+    { # This is deprecated and has no effect. Do not use.
+      "action": "A String", # This is deprecated and has no effect. Do not use.
+      "conditions": [ # This is deprecated and has no effect. Do not use.
+        { # This is deprecated and has no effect. Do not use.
+          "iam": "A String", # This is deprecated and has no effect. Do not use.
+          "op": "A String", # This is deprecated and has no effect. Do not use.
+          "svc": "A String", # This is deprecated and has no effect. Do not use.
+          "sys": "A String", # This is deprecated and has no effect. Do not use.
+          "values": [ # This is deprecated and has no effect. Do not use.
+            "A String",
+          ],
+        },
+      ],
+      "description": "A String", # This is deprecated and has no effect. Do not use.
+      "ins": [ # This is deprecated and has no effect. Do not use.
+        "A String",
+      ],
+      "logConfigs": [ # This is deprecated and has no effect. Do not use.
+        { # This is deprecated and has no effect. Do not use.
+          "cloudAudit": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+            "logName": "A String", # This is deprecated and has no effect. Do not use.
+          },
+          "counter": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+            "customFields": [ # This is deprecated and has no effect. Do not use.
+              { # This is deprecated and has no effect. Do not use.
+                "name": "A String", # This is deprecated and has no effect. Do not use.
+                "value": "A String", # This is deprecated and has no effect. Do not use.
+              },
+            ],
+            "field": "A String", # This is deprecated and has no effect. Do not use.
+            "metric": "A String", # This is deprecated and has no effect. Do not use.
+          },
+          "dataAccess": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+            "logMode": "A String", # This is deprecated and has no effect. Do not use.
+          },
+        },
+      ],
+      "notIns": [ # This is deprecated and has no effect. Do not use.
+        "A String",
+      ],
+      "permissions": [ # This is deprecated and has no effect. Do not use.
+        "A String",
+      ],
+    },
+  ],
+  "version": 42, # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+}
+
+
 
     insert(project, zone, body=None, requestId=None, sourceConsistencyGroup=None, x__xgafv=None)
   inserts a Zonal InstantSnapshotGroup resource
@@ -490,4 +600,240 @@ Method Details
         
 
 
+
+    setIamPolicy(project, zone, resource, body=None, x__xgafv=None)
+  Sets the access control policy on the specified resource. Replaces any existing policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  resource: string, Name or id of the resource for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "bindings": [ # Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use 'policy' to specify bindings.
+    { # Associates `members`, or principals, with a `role`.
+      "bindingId": "A String", # This is deprecated and has no effect. Do not use.
+      "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
+        "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
+        "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
+        "title": "A String", # Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
+      },
+      "members": [ # Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
+        "A String",
+      ],
+      "role": "A String", # Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
+    },
+  ],
+  "etag": "A String", # Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag.
+  "policy": { # An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/). # REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them.
+    "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+      { # Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts jose@example.com from DATA_READ logging, and aliya@example.com from DATA_WRITE logging.
+        "auditLogConfigs": [ # The configuration for logging of each type of permission.
+          { # Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.
+            "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.
+              "A String",
+            ],
+            "ignoreChildExemptions": True or False, # This is deprecated and has no effect. Do not use.
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "exemptedMembers": [ # This is deprecated and has no effect. Do not use.
+          "A String",
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.
+      },
+    ],
+    "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.
+      { # Associates `members`, or principals, with a `role`.
+        "bindingId": "A String", # This is deprecated and has no effect. Do not use.
+        "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+          "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
+          "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
+          "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
+          "title": "A String", # Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
+        },
+        "members": [ # Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
+          "A String",
+        ],
+        "role": "A String", # Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
+      },
+    ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.
+    "rules": [ # This is deprecated and has no effect. Do not use.
+      { # This is deprecated and has no effect. Do not use.
+        "action": "A String", # This is deprecated and has no effect. Do not use.
+        "conditions": [ # This is deprecated and has no effect. Do not use.
+          { # This is deprecated and has no effect. Do not use.
+            "iam": "A String", # This is deprecated and has no effect. Do not use.
+            "op": "A String", # This is deprecated and has no effect. Do not use.
+            "svc": "A String", # This is deprecated and has no effect. Do not use.
+            "sys": "A String", # This is deprecated and has no effect. Do not use.
+            "values": [ # This is deprecated and has no effect. Do not use.
+              "A String",
+            ],
+          },
+        ],
+        "description": "A String", # This is deprecated and has no effect. Do not use.
+        "ins": [ # This is deprecated and has no effect. Do not use.
+          "A String",
+        ],
+        "logConfigs": [ # This is deprecated and has no effect. Do not use.
+          { # This is deprecated and has no effect. Do not use.
+            "cloudAudit": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+              "logName": "A String", # This is deprecated and has no effect. Do not use.
+            },
+            "counter": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+              "customFields": [ # This is deprecated and has no effect. Do not use.
+                { # This is deprecated and has no effect. Do not use.
+                  "name": "A String", # This is deprecated and has no effect. Do not use.
+                  "value": "A String", # This is deprecated and has no effect. Do not use.
+                },
+              ],
+              "field": "A String", # This is deprecated and has no effect. Do not use.
+              "metric": "A String", # This is deprecated and has no effect. Do not use.
+            },
+            "dataAccess": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+              "logMode": "A String", # This is deprecated and has no effect. Do not use.
+            },
+          },
+        ],
+        "notIns": [ # This is deprecated and has no effect. Do not use.
+          "A String",
+        ],
+        "permissions": [ # This is deprecated and has no effect. Do not use.
+          "A String",
+        ],
+      },
+    ],
+    "version": 42, # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).
+  "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+    { # Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts jose@example.com from DATA_READ logging, and aliya@example.com from DATA_WRITE logging.
+      "auditLogConfigs": [ # The configuration for logging of each type of permission.
+        { # Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.
+          "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.
+            "A String",
+          ],
+          "ignoreChildExemptions": True or False, # This is deprecated and has no effect. Do not use.
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "exemptedMembers": [ # This is deprecated and has no effect. Do not use.
+        "A String",
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.
+    },
+  ],
+  "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.
+    { # Associates `members`, or principals, with a `role`.
+      "bindingId": "A String", # This is deprecated and has no effect. Do not use.
+      "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
+        "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
+        "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
+        "title": "A String", # Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
+      },
+      "members": [ # Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
+        "A String",
+      ],
+      "role": "A String", # Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
+    },
+  ],
+  "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.
+  "rules": [ # This is deprecated and has no effect. Do not use.
+    { # This is deprecated and has no effect. Do not use.
+      "action": "A String", # This is deprecated and has no effect. Do not use.
+      "conditions": [ # This is deprecated and has no effect. Do not use.
+        { # This is deprecated and has no effect. Do not use.
+          "iam": "A String", # This is deprecated and has no effect. Do not use.
+          "op": "A String", # This is deprecated and has no effect. Do not use.
+          "svc": "A String", # This is deprecated and has no effect. Do not use.
+          "sys": "A String", # This is deprecated and has no effect. Do not use.
+          "values": [ # This is deprecated and has no effect. Do not use.
+            "A String",
+          ],
+        },
+      ],
+      "description": "A String", # This is deprecated and has no effect. Do not use.
+      "ins": [ # This is deprecated and has no effect. Do not use.
+        "A String",
+      ],
+      "logConfigs": [ # This is deprecated and has no effect. Do not use.
+        { # This is deprecated and has no effect. Do not use.
+          "cloudAudit": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+            "logName": "A String", # This is deprecated and has no effect. Do not use.
+          },
+          "counter": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+            "customFields": [ # This is deprecated and has no effect. Do not use.
+              { # This is deprecated and has no effect. Do not use.
+                "name": "A String", # This is deprecated and has no effect. Do not use.
+                "value": "A String", # This is deprecated and has no effect. Do not use.
+              },
+            ],
+            "field": "A String", # This is deprecated and has no effect. Do not use.
+            "metric": "A String", # This is deprecated and has no effect. Do not use.
+          },
+          "dataAccess": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+            "logMode": "A String", # This is deprecated and has no effect. Do not use.
+          },
+        },
+      ],
+      "notIns": [ # This is deprecated and has no effect. Do not use.
+        "A String",
+      ],
+      "permissions": [ # This is deprecated and has no effect. Do not use.
+        "A String",
+      ],
+    },
+  ],
+  "version": 42, # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+}
+
+
+
+    testIamPermissions(project, zone, resource, body=None, x__xgafv=None)
+  Returns permissions that a caller has on the specified resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  zone: string, The name of the zone for this request. (required)
+  resource: string, Name or id of the resource for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "permissions": [ # The set of permissions to check for the 'resource'. Permissions with wildcards (such as '*' or 'storage.*') are not allowed.
+    "A String",
+  ],
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
+    "A String",
+  ],
+}
+
+
 
\ No newline at end of file
diff --git a/docs/dyn/compute_alpha.regionBackendServices.html b/docs/dyn/compute_alpha.regionBackendServices.html
index b8f1d16441e..56e5898a255 100644
--- a/docs/dyn/compute_alpha.regionBackendServices.html
+++ b/docs/dyn/compute_alpha.regionBackendServices.html
@@ -97,7 +97,7 @@ Instance Methods
 Retrieves the list of regional BackendService resources available to the specified project in the given region.
 
   listUsable(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)
-Retrieves an aggregated list of all usable backend services in the specified project in the given region.
+Retrieves a list of all usable backend services in the specified project in the given region.
 
   listUsable_next()
 Retrieves the next page of results.
@@ -1996,7 +1996,7 @@ Method Details
 
 
     listUsable(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)
-  Retrieves an aggregated list of all usable backend services in the specified project in the given region.
+  Retrieves a list of all usable backend services in the specified project in the given region.
 
 Args:
   project: string, Project ID for this request. (required)
diff --git a/docs/dyn/compute_alpha.regionInstanceGroupManagers.html b/docs/dyn/compute_alpha.regionInstanceGroupManagers.html
index bcf51186d52..b5fd94e9357 100644
--- a/docs/dyn/compute_alpha.regionInstanceGroupManagers.html
+++ b/docs/dyn/compute_alpha.regionInstanceGroupManagers.html
@@ -1120,6 +1120,7 @@ Method Details
   "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
   "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
   "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+  "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
   "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
   "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
     { # The named port. For example: <"http", 80>.
@@ -1374,6 +1375,7 @@ Method Details
   "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
   "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
   "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+  "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
   "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
   "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
     { # The named port. For example: <"http", 80>.
@@ -1758,6 +1760,7 @@ Method Details
       "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
       "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
       "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+      "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
       "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
       "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
         { # The named port. For example: <"http", 80>.
@@ -2012,6 +2015,10 @@ Method Details
         "revision": "A String", # [Output Only] Current all-instances configuration revision. This value is in RFC3339 text format.
       },
       "currentAction": "A String", # [Output Only] The current action that the managed instance group has scheduled for the instance. Possible values: - NONE The instance is running, and the managed instance group does not have any scheduled actions for this instance. - CREATING The managed instance group is creating this instance. If the group fails to create this instance, it will try again until it is successful. - CREATING_WITHOUT_RETRIES The managed instance group is attempting to create this instance only once. If the group fails to create this instance, it does not try again and the group's targetSize value is decreased instead. - RECREATING The managed instance group is recreating this instance. - DELETING The managed instance group is permanently deleting this instance. - ABANDONING The managed instance group is abandoning this instance. The instance will be removed from the instance group and from any target pools that are associated with this group. - RESTARTING The managed instance group is restarting the instance. - REFRESHING The managed instance group is applying configuration changes to the instance without stopping it. For example, the group can update the target pool list for an instance without stopping that instance. - VERIFYING The managed instance group has created the instance and it is in the process of being verified.
+      "currentActionDetails": {
+        "methodName": "A String",
+        "trigger": "A String", # [Output Only] Details of the current action that the managed instance group has scheduled for the instance. Contains trigger for the current action, and methodName in case it was triggered by API call. Possible values for trigger: - API Any API call. - PROACTIVE_UPDATE Proactive updater scheduled an update on this managed instance. - AUTOSCALING Instance being deleted/created after a decision from the Autoscaler. - REDISTRIBUTION The regional managed instance group is moving instances between zones to restore balance. - STANDBY_REFILL The managed instance group is refilling the Standby Pool (stopped/suspended virtual machines) after scale up. - MAINTENANCE Manual maintenance. - FAILED_CREATION The managed instance group is handling failed instance creation. - INSTANCE_FAILURE The managed instance group is handling instance failure, according to the Instance Lifecycle Policy. - FAILED_HEALTH_CHECK The managed instance group is handling failed health check, according to the Instance Lifecycle Policy. - TERMINATION_TIMESTAMP Instance reached termination time, thus managed instance group stops/deletes it.
+      },
       "id": "A String", # [Output only] The unique identifier for this resource. This field is empty when instance does not exist.
       "instance": "A String", # [Output Only] The URL of the instance. The URL can exist even if the instance has not yet been created.
       "instanceFlexibilityOverride": { # [Output Only] The overrides to instance properties resulting from InstanceFlexibilityPolicy.
@@ -2365,6 +2372,7 @@ Method Details
   "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
   "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
   "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+  "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
   "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
   "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
     { # The named port. For example: <"http", 80>.
@@ -4291,6 +4299,7 @@ Method Details
   "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
   "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
   "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+  "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
   "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
   "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
     { # The named port. For example: <"http", 80>.
diff --git a/docs/dyn/compute_alpha.regionInstantSnapshotGroups.html b/docs/dyn/compute_alpha.regionInstantSnapshotGroups.html
index 15440c1914f..58b9fe404df 100644
--- a/docs/dyn/compute_alpha.regionInstantSnapshotGroups.html
+++ b/docs/dyn/compute_alpha.regionInstantSnapshotGroups.html
@@ -83,6 +83,9 @@ Instance Methods
 
   get(project, region, instantSnapshotGroup, x__xgafv=None)
 returns the specified InstantSnapshotGroup resource in the specified region.
+
+  getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)
+Gets the access control policy for a resource. May be empty if no such policy or resource exists.
 
   insert(project, region, body=None, requestId=None, sourceConsistencyGroup=None, x__xgafv=None)
 creates a Regional InstantSnapshotGroup resource
@@ -92,6 +95,12 @@ Instance Methods
 
   list_next()
 Retrieves the next page of results.
+
+  setIamPolicy(project, region, resource, body=None, x__xgafv=None)
+Sets the access control policy on the specified resource. Replaces any existing policy.
+
+  testIamPermissions(project, region, resource, body=None, x__xgafv=None)
+Returns permissions that a caller has on the specified resource.
 Method Details
 
     close()
@@ -262,6 +271,107 @@ Method Details
 }
 
 
+
+    getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)
+  Gets the access control policy for a resource. May be empty if no such policy or resource exists.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  resource: string, Name or id of the resource for this request. (required)
+  optionsRequestedPolicyVersion: integer, Requested IAM Policy version.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).
+  "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+    { # Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts jose@example.com from DATA_READ logging, and aliya@example.com from DATA_WRITE logging.
+      "auditLogConfigs": [ # The configuration for logging of each type of permission.
+        { # Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.
+          "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.
+            "A String",
+          ],
+          "ignoreChildExemptions": True or False, # This is deprecated and has no effect. Do not use.
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "exemptedMembers": [ # This is deprecated and has no effect. Do not use.
+        "A String",
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.
+    },
+  ],
+  "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.
+    { # Associates `members`, or principals, with a `role`.
+      "bindingId": "A String", # This is deprecated and has no effect. Do not use.
+      "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
+        "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
+        "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
+        "title": "A String", # Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
+      },
+      "members": [ # Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
+        "A String",
+      ],
+      "role": "A String", # Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
+    },
+  ],
+  "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.
+  "rules": [ # This is deprecated and has no effect. Do not use.
+    { # This is deprecated and has no effect. Do not use.
+      "action": "A String", # This is deprecated and has no effect. Do not use.
+      "conditions": [ # This is deprecated and has no effect. Do not use.
+        { # This is deprecated and has no effect. Do not use.
+          "iam": "A String", # This is deprecated and has no effect. Do not use.
+          "op": "A String", # This is deprecated and has no effect. Do not use.
+          "svc": "A String", # This is deprecated and has no effect. Do not use.
+          "sys": "A String", # This is deprecated and has no effect. Do not use.
+          "values": [ # This is deprecated and has no effect. Do not use.
+            "A String",
+          ],
+        },
+      ],
+      "description": "A String", # This is deprecated and has no effect. Do not use.
+      "ins": [ # This is deprecated and has no effect. Do not use.
+        "A String",
+      ],
+      "logConfigs": [ # This is deprecated and has no effect. Do not use.
+        { # This is deprecated and has no effect. Do not use.
+          "cloudAudit": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+            "logName": "A String", # This is deprecated and has no effect. Do not use.
+          },
+          "counter": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+            "customFields": [ # This is deprecated and has no effect. Do not use.
+              { # This is deprecated and has no effect. Do not use.
+                "name": "A String", # This is deprecated and has no effect. Do not use.
+                "value": "A String", # This is deprecated and has no effect. Do not use.
+              },
+            ],
+            "field": "A String", # This is deprecated and has no effect. Do not use.
+            "metric": "A String", # This is deprecated and has no effect. Do not use.
+          },
+          "dataAccess": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+            "logMode": "A String", # This is deprecated and has no effect. Do not use.
+          },
+        },
+      ],
+      "notIns": [ # This is deprecated and has no effect. Do not use.
+        "A String",
+      ],
+      "permissions": [ # This is deprecated and has no effect. Do not use.
+        "A String",
+      ],
+    },
+  ],
+  "version": 42, # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+}
+
+
 
     insert(project, region, body=None, requestId=None, sourceConsistencyGroup=None, x__xgafv=None)
   creates a Regional InstantSnapshotGroup resource
@@ -490,4 +600,240 @@ Method Details
         
 
 
+
+    setIamPolicy(project, region, resource, body=None, x__xgafv=None)
+  Sets the access control policy on the specified resource. Replaces any existing policy.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  resource: string, Name or id of the resource for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "bindings": [ # Flatten Policy to create a backwacd compatible wire-format. Deprecated. Use 'policy' to specify bindings.
+    { # Associates `members`, or principals, with a `role`.
+      "bindingId": "A String", # This is deprecated and has no effect. Do not use.
+      "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
+        "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
+        "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
+        "title": "A String", # Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
+      },
+      "members": [ # Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
+        "A String",
+      ],
+      "role": "A String", # Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
+    },
+  ],
+  "etag": "A String", # Flatten Policy to create a backward compatible wire-format. Deprecated. Use 'policy' to specify the etag.
+  "policy": { # An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/). # REQUIRED: The complete policy to be applied to the 'resource'. The size of the policy is limited to a few 10s of KB. An empty policy is in general a valid policy but certain services (like Projects) might reject them.
+    "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+      { # Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts jose@example.com from DATA_READ logging, and aliya@example.com from DATA_WRITE logging.
+        "auditLogConfigs": [ # The configuration for logging of each type of permission.
+          { # Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.
+            "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.
+              "A String",
+            ],
+            "ignoreChildExemptions": True or False, # This is deprecated and has no effect. Do not use.
+            "logType": "A String", # The log type that this config enables.
+          },
+        ],
+        "exemptedMembers": [ # This is deprecated and has no effect. Do not use.
+          "A String",
+        ],
+        "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.
+      },
+    ],
+    "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.
+      { # Associates `members`, or principals, with a `role`.
+        "bindingId": "A String", # This is deprecated and has no effect. Do not use.
+        "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+          "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
+          "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
+          "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
+          "title": "A String", # Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
+        },
+        "members": [ # Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
+          "A String",
+        ],
+        "role": "A String", # Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
+      },
+    ],
+    "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.
+    "rules": [ # This is deprecated and has no effect. Do not use.
+      { # This is deprecated and has no effect. Do not use.
+        "action": "A String", # This is deprecated and has no effect. Do not use.
+        "conditions": [ # This is deprecated and has no effect. Do not use.
+          { # This is deprecated and has no effect. Do not use.
+            "iam": "A String", # This is deprecated and has no effect. Do not use.
+            "op": "A String", # This is deprecated and has no effect. Do not use.
+            "svc": "A String", # This is deprecated and has no effect. Do not use.
+            "sys": "A String", # This is deprecated and has no effect. Do not use.
+            "values": [ # This is deprecated and has no effect. Do not use.
+              "A String",
+            ],
+          },
+        ],
+        "description": "A String", # This is deprecated and has no effect. Do not use.
+        "ins": [ # This is deprecated and has no effect. Do not use.
+          "A String",
+        ],
+        "logConfigs": [ # This is deprecated and has no effect. Do not use.
+          { # This is deprecated and has no effect. Do not use.
+            "cloudAudit": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+              "logName": "A String", # This is deprecated and has no effect. Do not use.
+            },
+            "counter": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+              "customFields": [ # This is deprecated and has no effect. Do not use.
+                { # This is deprecated and has no effect. Do not use.
+                  "name": "A String", # This is deprecated and has no effect. Do not use.
+                  "value": "A String", # This is deprecated and has no effect. Do not use.
+                },
+              ],
+              "field": "A String", # This is deprecated and has no effect. Do not use.
+              "metric": "A String", # This is deprecated and has no effect. Do not use.
+            },
+            "dataAccess": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+              "logMode": "A String", # This is deprecated and has no effect. Do not use.
+            },
+          },
+        ],
+        "notIns": [ # This is deprecated and has no effect. Do not use.
+          "A String",
+        ],
+        "permissions": [ # This is deprecated and has no effect. Do not use.
+          "A String",
+        ],
+      },
+    ],
+    "version": 42, # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+  },
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A `Policy` is a collection of `bindings`. A `binding` binds one or more `members`, or principals, to a single `role`. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A `role` is a named list of permissions; each `role` can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a `binding` can also specify a `condition`, which is a logical expression that allows access to a resource only if the expression evaluates to `true`. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** ``` { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01T00:00:00.000Z')", } } ], "etag": "BwWWja0YfJA=", "version": 3 } ``` **YAML example:** ``` bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01T00:00:00.000Z') etag: BwWWja0YfJA= version: 3 ``` For a description of IAM and its features, see the [IAM documentation](https://cloud.google.com/iam/docs/).
+  "auditConfigs": [ # Specifies cloud audit logging configuration for this policy.
+    { # Specifies the audit configuration for a service. The configuration determines which permission types are logged, and what identities, if any, are exempted from logging. An AuditConfig must have one or more AuditLogConfigs. If there are AuditConfigs for both `allServices` and a specific service, the union of the two AuditConfigs is used for that service: the log_types specified in each AuditConfig are enabled, and the exempted_members in each AuditLogConfig are exempted. Example Policy with multiple AuditConfigs: { "audit_configs": [ { "service": "allServices", "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" }, { "log_type": "ADMIN_READ" } ] }, { "service": "sampleservice.googleapis.com", "audit_log_configs": [ { "log_type": "DATA_READ" }, { "log_type": "DATA_WRITE", "exempted_members": [ "user:aliya@example.com" ] } ] } ] } For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ logging. It also exempts jose@example.com from DATA_READ logging, and aliya@example.com from DATA_WRITE logging.
+      "auditLogConfigs": [ # The configuration for logging of each type of permission.
+        { # Provides the configuration for logging a type of permissions. Example: { "audit_log_configs": [ { "log_type": "DATA_READ", "exempted_members": [ "user:jose@example.com" ] }, { "log_type": "DATA_WRITE" } ] } This enables 'DATA_READ' and 'DATA_WRITE' logging, while exempting jose@example.com from DATA_READ logging.
+          "exemptedMembers": [ # Specifies the identities that do not cause logging for this type of permission. Follows the same format of Binding.members.
+            "A String",
+          ],
+          "ignoreChildExemptions": True or False, # This is deprecated and has no effect. Do not use.
+          "logType": "A String", # The log type that this config enables.
+        },
+      ],
+      "exemptedMembers": [ # This is deprecated and has no effect. Do not use.
+        "A String",
+      ],
+      "service": "A String", # Specifies a service that will be enabled for audit logging. For example, `storage.googleapis.com`, `cloudsql.googleapis.com`. `allServices` is a special value that covers all services.
+    },
+  ],
+  "bindings": [ # Associates a list of `members`, or principals, with a `role`. Optionally, may specify a `condition` that determines how and when the `bindings` are applied. Each of the `bindings` must contain at least one principal. The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250 of these principals can be Google groups. Each occurrence of a principal counts towards these limits. For example, if the `bindings` grant 50 different roles to `user:alice@example.com`, and not to any other principal, then you can add another 1,450 principals to the `bindings` in the `Policy`.
+    { # Associates `members`, or principals, with a `role`.
+      "bindingId": "A String", # This is deprecated and has no effect. Do not use.
+      "condition": { # Represents a textual expression in the Common Expression Language (CEL) syntax. CEL is a C-like expression language. The syntax and semantics of CEL are documented at https://github.com/google/cel-spec. Example (Comparison): title: "Summary size limit" description: "Determines if a summary is less than 100 chars" expression: "document.summary.size() < 100" Example (Equality): title: "Requestor is owner" description: "Determines if requestor is the document owner" expression: "document.owner == request.auth.claims.email" Example (Logic): title: "Public documents" description: "Determine whether the document should be publicly visible" expression: "document.type != 'private' && document.type != 'internal'" Example (Data Manipulation): title: "Notification string" description: "Create a notification string with a timestamp." expression: "'New message received at ' + string(document.create_time)" The exact variables and functions that may be referenced within an expression are determined by the service that evaluates it. See the service documentation for additional information. # The condition that is associated with this binding. If the condition evaluates to `true`, then this binding applies to the current request. If the condition evaluates to `false`, then this binding does not apply to the current request. However, a different role binding might grant the same role to one or more of the principals in this binding. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+        "description": "A String", # Optional. Description of the expression. This is a longer text which describes the expression, e.g. when hovered over it in a UI.
+        "expression": "A String", # Textual representation of an expression in Common Expression Language syntax.
+        "location": "A String", # Optional. String indicating the location of the expression for error reporting, e.g. a file name and a position in the file.
+        "title": "A String", # Optional. Title for the expression, i.e. a short string describing its purpose. This can be used e.g. in UIs which allow to enter the expression.
+      },
+      "members": [ # Specifies the principals requesting access for a Google Cloud resource. `members` can have the following values: * `allUsers`: A special identifier that represents anyone who is on the internet; with or without a Google account. * `allAuthenticatedUsers`: A special identifier that represents anyone who is authenticated with a Google account or a service account. Does not include identities that come from external identity providers (IdPs) through identity federation. * `user:{emailid}`: An email address that represents a specific Google account. For example, `alice@example.com` . * `serviceAccount:{emailid}`: An email address that represents a Google service account. For example, `my-other-app@appspot.gserviceaccount.com`. * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An identifier for a [Kubernetes service account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts). For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`. * `group:{emailid}`: An email address that represents a Google group. For example, `admins@example.com`. * `domain:{domain}`: The G Suite domain (primary) that represents all the users of that domain. For example, `google.com` or `example.com`. * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workforce identity pool. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`: All workforce identities in a group. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All workforce identities with a specific attribute value. * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`: All identities in a workforce identity pool. * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`: A single identity in a workload identity pool. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`: A workload identity pool group. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`: All identities in a workload identity pool with a certain attribute. * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`: All identities in a workload identity pool. * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a user that has been recently deleted. For example, `alice@example.com?uid=123456789012345678901`. If the user is recovered, this value reverts to `user:{emailid}` and the recovered user retains the role in the binding. * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a service account that has been recently deleted. For example, `my-other-app@appspot.gserviceaccount.com?uid=123456789012345678901`. If the service account is undeleted, this value reverts to `serviceAccount:{emailid}` and the undeleted service account retains the role in the binding. * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique identifier) representing a Google group that has been recently deleted. For example, `admins@example.com?uid=123456789012345678901`. If the group is recovered, this value reverts to `group:{emailid}` and the recovered group retains the role in the binding. * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`: Deleted single identity in a workforce identity pool. For example, `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
+        "A String",
+      ],
+      "role": "A String", # Role that is assigned to the list of `members`, or principals. For example, `roles/viewer`, `roles/editor`, or `roles/owner`. For an overview of the IAM roles and permissions, see the [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For a list of the available pre-defined roles, see [here](https://cloud.google.com/iam/docs/understanding-roles).
+    },
+  ],
+  "etag": "A String", # `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a policy from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform policy updates in order to avoid race conditions: An `etag` is returned in the response to `getIamPolicy`, and systems are expected to put that etag in the request to `setIamPolicy` to ensure that their change will be applied to the same version of the policy. **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost.
+  "rules": [ # This is deprecated and has no effect. Do not use.
+    { # This is deprecated and has no effect. Do not use.
+      "action": "A String", # This is deprecated and has no effect. Do not use.
+      "conditions": [ # This is deprecated and has no effect. Do not use.
+        { # This is deprecated and has no effect. Do not use.
+          "iam": "A String", # This is deprecated and has no effect. Do not use.
+          "op": "A String", # This is deprecated and has no effect. Do not use.
+          "svc": "A String", # This is deprecated and has no effect. Do not use.
+          "sys": "A String", # This is deprecated and has no effect. Do not use.
+          "values": [ # This is deprecated and has no effect. Do not use.
+            "A String",
+          ],
+        },
+      ],
+      "description": "A String", # This is deprecated and has no effect. Do not use.
+      "ins": [ # This is deprecated and has no effect. Do not use.
+        "A String",
+      ],
+      "logConfigs": [ # This is deprecated and has no effect. Do not use.
+        { # This is deprecated and has no effect. Do not use.
+          "cloudAudit": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+            "logName": "A String", # This is deprecated and has no effect. Do not use.
+          },
+          "counter": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+            "customFields": [ # This is deprecated and has no effect. Do not use.
+              { # This is deprecated and has no effect. Do not use.
+                "name": "A String", # This is deprecated and has no effect. Do not use.
+                "value": "A String", # This is deprecated and has no effect. Do not use.
+              },
+            ],
+            "field": "A String", # This is deprecated and has no effect. Do not use.
+            "metric": "A String", # This is deprecated and has no effect. Do not use.
+          },
+          "dataAccess": { # This is deprecated and has no effect. Do not use. # This is deprecated and has no effect. Do not use.
+            "logMode": "A String", # This is deprecated and has no effect. Do not use.
+          },
+        },
+      ],
+      "notIns": [ # This is deprecated and has no effect. Do not use.
+        "A String",
+      ],
+      "permissions": [ # This is deprecated and has no effect. Do not use.
+        "A String",
+      ],
+    },
+  ],
+  "version": 42, # Specifies the format of the policy. Valid values are `0`, `1`, and `3`. Requests that specify an invalid value are rejected. Any operation that affects conditional role bindings must specify version `3`. This requirement applies to the following operations: * Getting a policy that includes a conditional role binding * Adding a conditional role binding to a policy * Changing a conditional role binding in a policy * Removing any role binding, with or without a condition, from a policy that includes conditions **Important:** If you use IAM Conditions, you must include the `etag` field whenever you call `setIamPolicy`. If you omit this field, then IAM allows you to overwrite a version `3` policy with a version `1` policy, and all of the conditions in the version `3` policy are lost. If a policy does not include any conditions, operations on that policy may specify any valid version or leave the field unset. To learn which resources support conditions in their IAM policies, see the [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
+}
+
+
+
+    testIamPermissions(project, region, resource, body=None, x__xgafv=None)
+  Returns permissions that a caller has on the specified resource.
+
+Args:
+  project: string, Project ID for this request. (required)
+  region: string, The name of the region for this request. (required)
+  resource: string, Name or id of the resource for this request. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{
+  "permissions": [ # The set of permissions to check for the 'resource'. Permissions with wildcards (such as '*' or 'storage.*') are not allowed.
+    "A String",
+  ],
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    {
+  "permissions": [ # A subset of `TestPermissionsRequest.permissions` that the caller is allowed.
+    "A String",
+  ],
+}
+
+
 
\ No newline at end of file
diff --git a/docs/dyn/compute_alpha.routers.html b/docs/dyn/compute_alpha.routers.html
index 5b8e246aec9..8801b9417bd 100644
--- a/docs/dyn/compute_alpha.routers.html
+++ b/docs/dyn/compute_alpha.routers.html
@@ -1146,6 +1146,7 @@ Method Details
     {
   "etag": "A String", # end_interface: MixerGetResponseWithEtagBuilder
   "resource": {
+    "description": "A String", # An optional description of route policy.
     "fingerprint": "A String", # A fingerprint for the Route Policy being applied to this Router, which is essentially a hash of the Route Policy used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update Route Policy. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make a getRoutePolicy() request to retrieve a Route Policy.
     "name": "A String", # Route Policy name, which must be a resource ID segment and unique within all the router's Route Policies. Name should conform to RFC1035.
     "terms": [ # List of terms (the order in the list is not important, they are evaluated in order of priority). Order of policies is not retained and might change when getting policy later.
@@ -2182,6 +2183,7 @@ Method Details
   "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
   "result": [ # [Output Only] A list of route policies.
     {
+      "description": "A String", # An optional description of route policy.
       "fingerprint": "A String", # A fingerprint for the Route Policy being applied to this Router, which is essentially a hash of the Route Policy used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update Route Policy. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make a getRoutePolicy() request to retrieve a Route Policy.
       "name": "A String", # Route Policy name, which must be a resource ID segment and unique within all the router's Route Policies. Name should conform to RFC1035.
       "terms": [ # List of terms (the order in the list is not important, they are evaluated in order of priority). Order of policies is not retained and might change when getting policy later.
@@ -2702,6 +2704,7 @@ Method Details
     The object takes the form of:
 
 {
+  "description": "A String", # An optional description of route policy.
   "fingerprint": "A String", # A fingerprint for the Route Policy being applied to this Router, which is essentially a hash of the Route Policy used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update Route Policy. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make a getRoutePolicy() request to retrieve a Route Policy.
   "name": "A String", # Route Policy name, which must be a resource ID segment and unique within all the router's Route Policies. Name should conform to RFC1035.
   "terms": [ # List of terms (the order in the list is not important, they are evaluated in order of priority). Order of policies is not retained and might change when getting policy later.
@@ -3683,6 +3686,7 @@ Method Details
     The object takes the form of:
 
 {
+  "description": "A String", # An optional description of route policy.
   "fingerprint": "A String", # A fingerprint for the Route Policy being applied to this Router, which is essentially a hash of the Route Policy used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update Route Policy. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make a getRoutePolicy() request to retrieve a Route Policy.
   "name": "A String", # Route Policy name, which must be a resource ID segment and unique within all the router's Route Policies. Name should conform to RFC1035.
   "terms": [ # List of terms (the order in the list is not important, they are evaluated in order of priority). Order of policies is not retained and might change when getting policy later.
diff --git a/docs/dyn/compute_alpha.subnetworks.html b/docs/dyn/compute_alpha.subnetworks.html
index 7fc77e0793a..a479a2a0b99 100644
--- a/docs/dyn/compute_alpha.subnetworks.html
+++ b/docs/dyn/compute_alpha.subnetworks.html
@@ -162,7 +162,7 @@ Method Details
           "flowSampling": 3.14, # Can only be specified if VPC flow logging for this subnetwork is enabled. The value of the field must be in [0, 1]. Set the sampling rate of VPC flow logs within the subnetwork where 1.0 means all collected logs are reported and 0.0 means no logs are reported. Default is 0.5 unless otherwise specified by the org policy, which means half of all collected logs are reported.
           "gatewayAddress": "A String", # [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork.
           "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-          "internalIpv6Prefix": "A String", # [Output Only] The internal IPv6 address range that is assigned to this subnetwork.
+          "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this subnetwork.
           "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.
           "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.
           "ipv6CidrRange": "A String", # [Output Only] This field is for internal use.
@@ -540,7 +540,7 @@ Method Details
   "flowSampling": 3.14, # Can only be specified if VPC flow logging for this subnetwork is enabled. The value of the field must be in [0, 1]. Set the sampling rate of VPC flow logs within the subnetwork where 1.0 means all collected logs are reported and 0.0 means no logs are reported. Default is 0.5 unless otherwise specified by the org policy, which means half of all collected logs are reported.
   "gatewayAddress": "A String", # [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork.
   "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-  "internalIpv6Prefix": "A String", # [Output Only] The internal IPv6 address range that is assigned to this subnetwork.
+  "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this subnetwork.
   "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.
   "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.
   "ipv6CidrRange": "A String", # [Output Only] This field is for internal use.
@@ -705,7 +705,7 @@ Method Details
   "flowSampling": 3.14, # Can only be specified if VPC flow logging for this subnetwork is enabled. The value of the field must be in [0, 1]. Set the sampling rate of VPC flow logs within the subnetwork where 1.0 means all collected logs are reported and 0.0 means no logs are reported. Default is 0.5 unless otherwise specified by the org policy, which means half of all collected logs are reported.
   "gatewayAddress": "A String", # [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork.
   "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-  "internalIpv6Prefix": "A String", # [Output Only] The internal IPv6 address range that is assigned to this subnetwork.
+  "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this subnetwork.
   "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.
   "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.
   "ipv6CidrRange": "A String", # [Output Only] This field is for internal use.
@@ -899,7 +899,7 @@ Method Details
       "flowSampling": 3.14, # Can only be specified if VPC flow logging for this subnetwork is enabled. The value of the field must be in [0, 1]. Set the sampling rate of VPC flow logs within the subnetwork where 1.0 means all collected logs are reported and 0.0 means no logs are reported. Default is 0.5 unless otherwise specified by the org policy, which means half of all collected logs are reported.
       "gatewayAddress": "A String", # [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork.
       "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-      "internalIpv6Prefix": "A String", # [Output Only] The internal IPv6 address range that is assigned to this subnetwork.
+      "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this subnetwork.
       "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.
       "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.
       "ipv6CidrRange": "A String", # [Output Only] This field is for internal use.
@@ -1082,7 +1082,7 @@ Method Details
   "flowSampling": 3.14, # Can only be specified if VPC flow logging for this subnetwork is enabled. The value of the field must be in [0, 1]. Set the sampling rate of VPC flow logs within the subnetwork where 1.0 means all collected logs are reported and 0.0 means no logs are reported. Default is 0.5 unless otherwise specified by the org policy, which means half of all collected logs are reported.
   "gatewayAddress": "A String", # [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork.
   "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-  "internalIpv6Prefix": "A String", # [Output Only] The internal IPv6 address range that is assigned to this subnetwork.
+  "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this subnetwork.
   "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.
   "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.
   "ipv6CidrRange": "A String", # [Output Only] This field is for internal use.
diff --git a/docs/dyn/compute_beta.backendBuckets.html b/docs/dyn/compute_beta.backendBuckets.html
index 036e1bc8546..c414cc12992 100644
--- a/docs/dyn/compute_beta.backendBuckets.html
+++ b/docs/dyn/compute_beta.backendBuckets.html
@@ -564,6 +564,11 @@ Method Details
   "kind": "compute#backendBucket", # Type of the resource.
   "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
   "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "usedBy": [ # [Output Only] List of resources referencing that backend bucket.
+    {
+      "reference": "A String", # [Output Only] Server-defined URL for UrlMaps referencing that BackendBucket.
+    },
+  ],
 }

@@ -722,6 +727,11 @@

Method Details

"kind": "compute#backendBucket", # Type of the resource. "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash. "selfLink": "A String", # [Output Only] Server-defined URL for the resource. + "usedBy": [ # [Output Only] List of resources referencing that backend bucket. + { + "reference": "A String", # [Output Only] Server-defined URL for UrlMaps referencing that BackendBucket. + }, + ], } requestId: string, An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000). @@ -909,6 +919,11 @@

Method Details

Instance Methods

Retrieves the list of BackendService resources available to the specified project.

listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves an aggregated list of all usable backend services in the specified project.

Retrieves a list of all usable backend services in the specified project.

listUsable_next()

Retrieves the next page of results.

@@ -1785,7 +1785,7 @@

Method Details

listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)

Retrieves an aggregated list of all usable backend services in the specified project.
+  Retrieves a list of all usable backend services in the specified project.
 
 Args:
   project: string, Project ID for this request. (required)
diff --git a/docs/dyn/compute_beta.globalNetworkEndpointGroups.html b/docs/dyn/compute_beta.globalNetworkEndpointGroups.html
index dfcebb7f00e..945ec73f40c 100644
--- a/docs/dyn/compute_beta.globalNetworkEndpointGroups.html
+++ b/docs/dyn/compute_beta.globalNetworkEndpointGroups.html
@@ -569,6 +569,7 @@ Method Details
   "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
   "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
     "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
     "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
     "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
   },
@@ -630,6 +631,7 @@ Method Details
   "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
   "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
     "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
     "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
     "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
   },
@@ -820,6 +822,7 @@ Method Details
       "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
       "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
         "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+        "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
         "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
         "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
       },
diff --git a/docs/dyn/compute_beta.instanceGroupManagers.html b/docs/dyn/compute_beta.instanceGroupManagers.html
index f5af8e30814..dec286217ef 100644
--- a/docs/dyn/compute_beta.instanceGroupManagers.html
+++ b/docs/dyn/compute_beta.instanceGroupManagers.html
@@ -405,6 +405,7 @@ Method Details
           "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
           "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
           "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+          "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
           "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
           "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
             { # The named port. For example: <"http", 80>.
@@ -1335,6 +1336,7 @@ Method Details
   "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
   "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
   "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+  "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
   "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
   "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
     { # The named port. For example: <"http", 80>.
@@ -1513,6 +1515,7 @@ Method Details
   "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
   "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
   "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+  "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
   "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
   "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
     { # The named port. For example: <"http", 80>.
@@ -1820,6 +1823,7 @@ Method Details
       "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
       "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
       "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+      "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
       "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
       "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
         { # The named port. For example: <"http", 80>.
@@ -2343,6 +2347,7 @@ Method Details
   "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
   "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
   "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+  "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
   "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
   "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
     { # The named port. For example: <"http", 80>.
@@ -4173,6 +4178,7 @@ Method Details
   "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
   "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
   "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+  "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
   "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
   "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
     { # The named port. For example: <"http", 80>.
diff --git a/docs/dyn/compute_beta.networkEndpointGroups.html b/docs/dyn/compute_beta.networkEndpointGroups.html
index f2de9e0f20f..861bc3c15a4 100644
--- a/docs/dyn/compute_beta.networkEndpointGroups.html
+++ b/docs/dyn/compute_beta.networkEndpointGroups.html
@@ -174,6 +174,7 @@ Method Details
           "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
           "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
             "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+            "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
             "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
             "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
           },
@@ -704,6 +705,7 @@ Method Details
   "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
   "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
     "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
     "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
     "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
   },
@@ -766,6 +768,7 @@ Method Details
   "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
   "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
     "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
     "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
     "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
   },
@@ -957,6 +960,7 @@ Method Details
       "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
       "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
         "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+        "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
         "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
         "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
       },
diff --git a/docs/dyn/compute_beta.regionBackendServices.html b/docs/dyn/compute_beta.regionBackendServices.html
index 139c46ae7ec..935c0872833 100644
--- a/docs/dyn/compute_beta.regionBackendServices.html
+++ b/docs/dyn/compute_beta.regionBackendServices.html
@@ -97,7 +97,7 @@ Instance Methods
 Retrieves the list of regional BackendService resources available to the specified project in the given region.
 
   listUsable(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)
-Retrieves an aggregated list of all usable backend services in the specified project in the given region.
+Retrieves a list of all usable backend services in the specified project in the given region.
 
   listUsable_next()
 Retrieves the next page of results.
@@ -1232,7 +1232,7 @@ Method Details
 
 
     listUsable(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)
-  Retrieves an aggregated list of all usable backend services in the specified project in the given region.
+  Retrieves a list of all usable backend services in the specified project in the given region.
 
 Args:
   project: string, Project ID for this request. (required)
diff --git a/docs/dyn/compute_beta.regionInstanceGroupManagers.html b/docs/dyn/compute_beta.regionInstanceGroupManagers.html
index 67bfd0f2d21..aa94d5e8d29 100644
--- a/docs/dyn/compute_beta.regionInstanceGroupManagers.html
+++ b/docs/dyn/compute_beta.regionInstanceGroupManagers.html
@@ -1091,6 +1091,7 @@ Method Details
   "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
   "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
   "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+  "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
   "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
   "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
     { # The named port. For example: <"http", 80>.
@@ -1269,6 +1270,7 @@ Method Details
   "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
   "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
   "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+  "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
   "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
   "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
     { # The named port. For example: <"http", 80>.
@@ -1576,6 +1578,7 @@ Method Details
       "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
       "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
       "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+      "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
       "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
       "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
         { # The named port. For example: <"http", 80>.
@@ -2099,6 +2102,7 @@ Method Details
   "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
   "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
   "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+  "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
   "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
   "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
     { # The named port. For example: <"http", 80>.
@@ -3929,6 +3933,7 @@ Method Details
   "instanceTemplate": "A String", # The URL of the instance template that is specified for this managed instance group. The group uses this template to create all new instances in the managed instance group. The templates for existing instances in the group do not change unless you run recreateInstances, run applyUpdatesToInstances, or set the group's updatePolicy.type to PROACTIVE.
   "kind": "compute#instanceGroupManager", # [Output Only] The resource type, which is always compute#instanceGroupManager for managed instance groups.
   "listManagedInstancesResults": "A String", # Pagination behavior of the listManagedInstances API method for this managed instance group.
+  "multiMig": "A String", # URL to the multi-MIG that this Managed Instance Group belongs to.
   "name": "A String", # The name of the managed instance group. The name must be 1-63 characters long, and comply with RFC1035.
   "namedPorts": [ # Named ports configured for the Instance Groups complementary to this Instance Group Manager.
     { # The named port. For example: <"http", 80>.
diff --git a/docs/dyn/compute_beta.regionNetworkEndpointGroups.html b/docs/dyn/compute_beta.regionNetworkEndpointGroups.html
index 23acaec90a6..abb9932e324 100644
--- a/docs/dyn/compute_beta.regionNetworkEndpointGroups.html
+++ b/docs/dyn/compute_beta.regionNetworkEndpointGroups.html
@@ -573,6 +573,7 @@ Method Details
   "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
   "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
     "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
     "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
     "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
   },
@@ -635,6 +636,7 @@ Method Details
   "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
   "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
     "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
     "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
     "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
   },
@@ -826,6 +828,7 @@ Method Details
       "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
       "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
         "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+        "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
         "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
         "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
       },
diff --git a/docs/dyn/compute_beta.subnetworks.html b/docs/dyn/compute_beta.subnetworks.html
index d729c92bdb0..1c961a4e546 100644
--- a/docs/dyn/compute_beta.subnetworks.html
+++ b/docs/dyn/compute_beta.subnetworks.html
@@ -158,7 +158,7 @@ Method Details
           "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a Subnetwork. An up-to-date fingerprint must be provided in order to update the Subnetwork, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a Subnetwork.
           "gatewayAddress": "A String", # [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork.
           "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-          "internalIpv6Prefix": "A String", # [Output Only] The internal IPv6 address range that is assigned to this subnetwork.
+          "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this subnetwork.
           "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.
           "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.
           "ipv6CidrRange": "A String", # [Output Only] This field is for internal use.
@@ -525,7 +525,7 @@ Method Details
   "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a Subnetwork. An up-to-date fingerprint must be provided in order to update the Subnetwork, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a Subnetwork.
   "gatewayAddress": "A String", # [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork.
   "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-  "internalIpv6Prefix": "A String", # [Output Only] The internal IPv6 address range that is assigned to this subnetwork.
+  "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this subnetwork.
   "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.
   "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.
   "ipv6CidrRange": "A String", # [Output Only] This field is for internal use.
@@ -681,7 +681,7 @@ Method Details
   "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a Subnetwork. An up-to-date fingerprint must be provided in order to update the Subnetwork, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a Subnetwork.
   "gatewayAddress": "A String", # [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork.
   "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-  "internalIpv6Prefix": "A String", # [Output Only] The internal IPv6 address range that is assigned to this subnetwork.
+  "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this subnetwork.
   "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.
   "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.
   "ipv6CidrRange": "A String", # [Output Only] This field is for internal use.
@@ -865,7 +865,7 @@ Method Details
       "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a Subnetwork. An up-to-date fingerprint must be provided in order to update the Subnetwork, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a Subnetwork.
       "gatewayAddress": "A String", # [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork.
       "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-      "internalIpv6Prefix": "A String", # [Output Only] The internal IPv6 address range that is assigned to this subnetwork.
+      "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this subnetwork.
       "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.
       "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.
       "ipv6CidrRange": "A String", # [Output Only] This field is for internal use.
@@ -1021,7 +1021,7 @@ Method Details
   "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a Subnetwork. An up-to-date fingerprint must be provided in order to update the Subnetwork, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a Subnetwork.
   "gatewayAddress": "A String", # [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork.
   "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-  "internalIpv6Prefix": "A String", # [Output Only] The internal IPv6 address range that is assigned to this subnetwork.
+  "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this subnetwork.
   "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.
   "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.
   "ipv6CidrRange": "A String", # [Output Only] This field is for internal use.
diff --git a/docs/dyn/compute_v1.backendBuckets.html b/docs/dyn/compute_v1.backendBuckets.html
index ef9fff64076..284a8785602 100644
--- a/docs/dyn/compute_v1.backendBuckets.html
+++ b/docs/dyn/compute_v1.backendBuckets.html
@@ -564,6 +564,11 @@ Method Details
   "kind": "compute#backendBucket", # Type of the resource.
   "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
   "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "usedBy": [ # [Output Only] List of resources referencing that backend bucket.
+    {
+      "reference": "A String", # [Output Only] Server-defined URL for UrlMaps referencing that BackendBucket.
+    },
+  ],
 }
 
 
@@ -722,6 +727,11 @@ Method Details
   "kind": "compute#backendBucket", # Type of the resource.
   "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
   "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "usedBy": [ # [Output Only] List of resources referencing that backend bucket.
+    {
+      "reference": "A String", # [Output Only] Server-defined URL for UrlMaps referencing that BackendBucket.
+    },
+  ],
 }
 
   requestId: string, An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
@@ -909,6 +919,11 @@ Method Details
       "kind": "compute#backendBucket", # Type of the resource.
       "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
       "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+      "usedBy": [ # [Output Only] List of resources referencing that backend bucket.
+        {
+          "reference": "A String", # [Output Only] Server-defined URL for UrlMaps referencing that BackendBucket.
+        },
+      ],
     },
   ],
   "kind": "compute#backendBucketList", # Type of resource.
@@ -997,6 +1012,11 @@ Method Details
   "kind": "compute#backendBucket", # Type of the resource.
   "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
   "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "usedBy": [ # [Output Only] List of resources referencing that backend bucket.
+    {
+      "reference": "A String", # [Output Only] Server-defined URL for UrlMaps referencing that BackendBucket.
+    },
+  ],
 }
 
   requestId: string, An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
@@ -1537,6 +1557,11 @@ Method Details
   "kind": "compute#backendBucket", # Type of the resource.
   "name": "A String", # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
   "selfLink": "A String", # [Output Only] Server-defined URL for the resource.
+  "usedBy": [ # [Output Only] List of resources referencing that backend bucket.
+    {
+      "reference": "A String", # [Output Only] Server-defined URL for UrlMaps referencing that BackendBucket.
+    },
+  ],
 }
 
   requestId: string, An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported ( 00000000-0000-0000-0000-000000000000).
diff --git a/docs/dyn/compute_v1.backendServices.html b/docs/dyn/compute_v1.backendServices.html
index 24f81b1987c..7eb86edcd94 100644
--- a/docs/dyn/compute_v1.backendServices.html
+++ b/docs/dyn/compute_v1.backendServices.html
@@ -109,7 +109,7 @@ Instance Methods
 Retrieves the list of BackendService resources available to the specified project.
 
   listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)
-Retrieves an aggregated list of all usable backend services in the specified project.
+Retrieves a list of all usable backend services in the specified project.
 
   listUsable_next()
 Retrieves the next page of results.
@@ -1715,7 +1715,7 @@ Method Details
 
 
     listUsable(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)
-  Retrieves an aggregated list of all usable backend services in the specified project.
+  Retrieves a list of all usable backend services in the specified project.
 
 Args:
   project: string, Project ID for this request. (required)
diff --git a/docs/dyn/compute_v1.globalNetworkEndpointGroups.html b/docs/dyn/compute_v1.globalNetworkEndpointGroups.html
index 01a2b5e1816..0efff77bbc8 100644
--- a/docs/dyn/compute_v1.globalNetworkEndpointGroups.html
+++ b/docs/dyn/compute_v1.globalNetworkEndpointGroups.html
@@ -561,6 +561,7 @@ Method Details
   "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
   "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
     "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
     "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
     "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
   },
@@ -610,6 +611,7 @@ Method Details
   "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
   "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
     "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
     "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
     "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
   },
@@ -788,6 +790,7 @@ Method Details
       "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
       "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
         "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+        "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
         "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
         "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
       },
diff --git a/docs/dyn/compute_v1.networkEndpointGroups.html b/docs/dyn/compute_v1.networkEndpointGroups.html
index 42a470fcafc..ce7d1eeec74 100644
--- a/docs/dyn/compute_v1.networkEndpointGroups.html
+++ b/docs/dyn/compute_v1.networkEndpointGroups.html
@@ -168,6 +168,7 @@ Method Details
           "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
           "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
             "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+            "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
             "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
             "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
           },
@@ -684,6 +685,7 @@ Method Details
   "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
   "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
     "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
     "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
     "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
   },
@@ -734,6 +736,7 @@ Method Details
   "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
   "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
     "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
     "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
     "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
   },
@@ -913,6 +916,7 @@ Method Details
       "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
       "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
         "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+        "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
         "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
         "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
       },
diff --git a/docs/dyn/compute_v1.regionBackendServices.html b/docs/dyn/compute_v1.regionBackendServices.html
index 9dbc2ee3e8c..cbaba11f1c9 100644
--- a/docs/dyn/compute_v1.regionBackendServices.html
+++ b/docs/dyn/compute_v1.regionBackendServices.html
@@ -97,7 +97,7 @@ Instance Methods
 Retrieves the list of regional BackendService resources available to the specified project in the given region.
 
   listUsable(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)
-Retrieves an aggregated list of all usable backend services in the specified project in the given region.
+Retrieves a list of all usable backend services in the specified project in the given region.
 
   listUsable_next()
 Retrieves the next page of results.
@@ -1179,7 +1179,7 @@ Method Details
 
 
     listUsable(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)
-  Retrieves an aggregated list of all usable backend services in the specified project in the given region.
+  Retrieves a list of all usable backend services in the specified project in the given region.
 
 Args:
   project: string, Project ID for this request. (required)
diff --git a/docs/dyn/compute_v1.regionNetworkEndpointGroups.html b/docs/dyn/compute_v1.regionNetworkEndpointGroups.html
index e9ea4f4b7af..e49fc477ac1 100644
--- a/docs/dyn/compute_v1.regionNetworkEndpointGroups.html
+++ b/docs/dyn/compute_v1.regionNetworkEndpointGroups.html
@@ -565,6 +565,7 @@ Method Details
   "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
   "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
     "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
     "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
     "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
   },
@@ -615,6 +616,7 @@ Method Details
   "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
   "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
     "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+    "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
     "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
     "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
   },
@@ -794,6 +796,7 @@ Method Details
       "networkEndpointType": "A String", # Type of network endpoints in this network endpoint group. Can be one of GCE_VM_IP, GCE_VM_IP_PORT, NON_GCP_PRIVATE_IP_PORT, INTERNET_FQDN_PORT, INTERNET_IP_PORT, SERVERLESS, PRIVATE_SERVICE_CONNECT, GCE_VM_IP_PORTMAP.
       "pscData": { # All data that is specifically relevant to only network endpoint groups of type PRIVATE_SERVICE_CONNECT.
         "consumerPscAddress": "A String", # [Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.
+        "producerPort": 42, # The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type
         "pscConnectionId": "A String", # [Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.
         "pscConnectionStatus": "A String", # [Output Only] The connection status of the PSC Forwarding Rule.
       },
diff --git a/docs/dyn/compute_v1.subnetworks.html b/docs/dyn/compute_v1.subnetworks.html
index 03762234d02..a1d5917f710 100644
--- a/docs/dyn/compute_v1.subnetworks.html
+++ b/docs/dyn/compute_v1.subnetworks.html
@@ -157,7 +157,7 @@ Method Details
           "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a Subnetwork. An up-to-date fingerprint must be provided in order to update the Subnetwork, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a Subnetwork.
           "gatewayAddress": "A String", # [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork.
           "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-          "internalIpv6Prefix": "A String", # [Output Only] The internal IPv6 address range that is assigned to this subnetwork.
+          "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this subnetwork.
           "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.
           "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.
           "ipv6CidrRange": "A String", # [Output Only] This field is for internal use.
@@ -523,7 +523,7 @@ Method Details
   "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a Subnetwork. An up-to-date fingerprint must be provided in order to update the Subnetwork, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a Subnetwork.
   "gatewayAddress": "A String", # [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork.
   "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-  "internalIpv6Prefix": "A String", # [Output Only] The internal IPv6 address range that is assigned to this subnetwork.
+  "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this subnetwork.
   "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.
   "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.
   "ipv6CidrRange": "A String", # [Output Only] This field is for internal use.
@@ -678,7 +678,7 @@ Method Details
   "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a Subnetwork. An up-to-date fingerprint must be provided in order to update the Subnetwork, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a Subnetwork.
   "gatewayAddress": "A String", # [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork.
   "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-  "internalIpv6Prefix": "A String", # [Output Only] The internal IPv6 address range that is assigned to this subnetwork.
+  "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this subnetwork.
   "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.
   "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.
   "ipv6CidrRange": "A String", # [Output Only] This field is for internal use.
@@ -861,7 +861,7 @@ Method Details
       "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a Subnetwork. An up-to-date fingerprint must be provided in order to update the Subnetwork, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a Subnetwork.
       "gatewayAddress": "A String", # [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork.
       "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-      "internalIpv6Prefix": "A String", # [Output Only] The internal IPv6 address range that is assigned to this subnetwork.
+      "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this subnetwork.
       "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.
       "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.
       "ipv6CidrRange": "A String", # [Output Only] This field is for internal use.
@@ -1015,7 +1015,7 @@ Method Details
   "fingerprint": "A String", # Fingerprint of this resource. A hash of the contents stored in this object. This field is used in optimistic locking. This field will be ignored when inserting a Subnetwork. An up-to-date fingerprint must be provided in order to update the Subnetwork, otherwise the request will fail with error 412 conditionNotMet. To see the latest fingerprint, make a get() request to retrieve a Subnetwork.
   "gatewayAddress": "A String", # [Output Only] The gateway address for default routes to reach destination addresses outside this subnetwork.
   "id": "A String", # [Output Only] The unique identifier for the resource. This identifier is defined by the server.
-  "internalIpv6Prefix": "A String", # [Output Only] The internal IPv6 address range that is assigned to this subnetwork.
+  "internalIpv6Prefix": "A String", # The internal IPv6 address range that is owned by this subnetwork.
   "ipCidrRange": "A String", # The range of internal addresses that are owned by this subnetwork. Provide this property when you create the subnetwork. For example, 10.0.0.0/8 or 100.64.0.0/10. Ranges must be unique and non-overlapping within a network. Only IPv4 is supported. This field is set at resource creation time. The range can be any range listed in the Valid ranges list. The range can be expanded after creation using expandIpCidrRange.
   "ipv6AccessType": "A String", # The access type of IPv6 address this subnet holds. It's immutable and can only be specified during creation or the first time the subnet is updated into IPV4_IPV6 dual stack.
   "ipv6CidrRange": "A String", # [Output Only] This field is for internal use.
diff --git a/googleapiclient/discovery_cache/documents/compute.alpha.json b/googleapiclient/discovery_cache/documents/compute.alpha.json
index 61f96287d0f..441624cc6eb 100644
--- a/googleapiclient/discovery_cache/documents/compute.alpha.json
+++ b/googleapiclient/discovery_cache/documents/compute.alpha.json
@@ -2062,7 +2062,7 @@
 ]
 },
 "listUsable": {
-"description": "Retrieves an aggregated list of all usable backend services in the specified project.",
+"description": "Retrieves a list of all usable backend services in the specified project.",
 "flatPath": "projects/{project}/global/backendServices/listUsable",
 "httpMethod": "GET",
 "id": "compute.backendServices.listUsable",
@@ -14231,6 +14231,55 @@
 "https://www.googleapis.com/auth/compute.readonly"
 ]
 },
+"getIamPolicy": {
+"description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists.",
+"flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/getIamPolicy",
+"httpMethod": "GET",
+"id": "compute.instantSnapshotGroups.getIamPolicy",
+"parameterOrder": [
+"project",
+"zone",
+"resource"
+],
+"parameters": {
+"optionsRequestedPolicyVersion": {
+"description": "Requested IAM Policy version.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"project": {
+"description": "Project ID for this request.",
+"location": "path",
+"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+"required": true,
+"type": "string"
+},
+"resource": {
+"description": "Name or id of the resource for this request.",
+"location": "path",
+"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}",
+"required": true,
+"type": "string"
+},
+"zone": {
+"description": "The name of the zone for this request.",
+"location": "path",
+"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+"required": true,
+"type": "string"
+}
+},
+"path": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/getIamPolicy",
+"response": {
+"$ref": "Policy"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/compute",
+"https://www.googleapis.com/auth/compute.readonly"
+]
+},
 "insert": {
 "description": "inserts a Zonal InstantSnapshotGroup resource",
 "flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups",
@@ -14340,6 +14389,97 @@
 "https://www.googleapis.com/auth/compute",
 "https://www.googleapis.com/auth/compute.readonly"
 ]
+},
+"setIamPolicy": {
+"description": "Sets the access control policy on the specified resource. Replaces any existing policy.",
+"flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/setIamPolicy",
+"httpMethod": "POST",
+"id": "compute.instantSnapshotGroups.setIamPolicy",
+"parameterOrder": [
+"project",
+"zone",
+"resource"
+],
+"parameters": {
+"project": {
+"description": "Project ID for this request.",
+"location": "path",
+"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+"required": true,
+"type": "string"
+},
+"resource": {
+"description": "Name or id of the resource for this request.",
+"location": "path",
+"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}",
+"required": true,
+"type": "string"
+},
+"zone": {
+"description": "The name of the zone for this request.",
+"location": "path",
+"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+"required": true,
+"type": "string"
+}
+},
+"path": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/setIamPolicy",
+"request": {
+"$ref": "ZoneSetPolicyRequest"
+},
+"response": {
+"$ref": "Policy"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/compute"
+]
+},
+"testIamPermissions": {
+"description": "Returns permissions that a caller has on the specified resource.",
+"flatPath": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/testIamPermissions",
+"httpMethod": "POST",
+"id": "compute.instantSnapshotGroups.testIamPermissions",
+"parameterOrder": [
+"project",
+"zone",
+"resource"
+],
+"parameters": {
+"project": {
+"description": "Project ID for this request.",
+"location": "path",
+"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+"required": true,
+"type": "string"
+},
+"resource": {
+"description": "Name or id of the resource for this request.",
+"location": "path",
+"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}",
+"required": true,
+"type": "string"
+},
+"zone": {
+"description": "The name of the zone for this request.",
+"location": "path",
+"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+"required": true,
+"type": "string"
+}
+},
+"path": "projects/{project}/zones/{zone}/instantSnapshotGroups/{resource}/testIamPermissions",
+"request": {
+"$ref": "TestPermissionsRequest"
+},
+"response": {
+"$ref": "TestPermissionsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/compute",
+"https://www.googleapis.com/auth/compute.readonly"
+]
 }
 }
 },
@@ -23957,7 +24097,7 @@
 ]
 },
 "listUsable": {
-"description": "Retrieves an aggregated list of all usable backend services in the specified project in the given region.",
+"description": "Retrieves a list of all usable backend services in the specified project in the given region.",
 "flatPath": "projects/{project}/regions/{region}/backendServices/listUsable",
 "httpMethod": "GET",
 "id": "compute.regionBackendServices.listUsable",
@@ -28737,6 +28877,55 @@
 "https://www.googleapis.com/auth/compute.readonly"
 ]
 },
+"getIamPolicy": {
+"description": "Gets the access control policy for a resource. May be empty if no such policy or resource exists.",
+"flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/getIamPolicy",
+"httpMethod": "GET",
+"id": "compute.regionInstantSnapshotGroups.getIamPolicy",
+"parameterOrder": [
+"project",
+"region",
+"resource"
+],
+"parameters": {
+"optionsRequestedPolicyVersion": {
+"description": "Requested IAM Policy version.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"project": {
+"description": "Project ID for this request.",
+"location": "path",
+"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+"required": true,
+"type": "string"
+},
+"region": {
+"description": "The name of the region for this request.",
+"location": "path",
+"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+"required": true,
+"type": "string"
+},
+"resource": {
+"description": "Name or id of the resource for this request.",
+"location": "path",
+"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}",
+"required": true,
+"type": "string"
+}
+},
+"path": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/getIamPolicy",
+"response": {
+"$ref": "Policy"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/compute",
+"https://www.googleapis.com/auth/compute.readonly"
+]
+},
 "insert": {
 "description": "creates a Regional InstantSnapshotGroup resource",
 "flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups",
@@ -28846,6 +29035,97 @@
 "https://www.googleapis.com/auth/compute",
 "https://www.googleapis.com/auth/compute.readonly"
 ]
+},
+"setIamPolicy": {
+"description": "Sets the access control policy on the specified resource. Replaces any existing policy.",
+"flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/setIamPolicy",
+"httpMethod": "POST",
+"id": "compute.regionInstantSnapshotGroups.setIamPolicy",
+"parameterOrder": [
+"project",
+"region",
+"resource"
+],
+"parameters": {
+"project": {
+"description": "Project ID for this request.",
+"location": "path",
+"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+"required": true,
+"type": "string"
+},
+"region": {
+"description": "The name of the region for this request.",
+"location": "path",
+"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+"required": true,
+"type": "string"
+},
+"resource": {
+"description": "Name or id of the resource for this request.",
+"location": "path",
+"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}",
+"required": true,
+"type": "string"
+}
+},
+"path": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/setIamPolicy",
+"request": {
+"$ref": "RegionSetPolicyRequest"
+},
+"response": {
+"$ref": "Policy"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/compute"
+]
+},
+"testIamPermissions": {
+"description": "Returns permissions that a caller has on the specified resource.",
+"flatPath": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/testIamPermissions",
+"httpMethod": "POST",
+"id": "compute.regionInstantSnapshotGroups.testIamPermissions",
+"parameterOrder": [
+"project",
+"region",
+"resource"
+],
+"parameters": {
+"project": {
+"description": "Project ID for this request.",
+"location": "path",
+"pattern": "(?:(?:[-a-z0-9]{1,63}\\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))",
+"required": true,
+"type": "string"
+},
+"region": {
+"description": "The name of the region for this request.",
+"location": "path",
+"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?",
+"required": true,
+"type": "string"
+},
+"resource": {
+"description": "Name or id of the resource for this request.",
+"location": "path",
+"pattern": "[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}",
+"required": true,
+"type": "string"
+}
+},
+"path": "projects/{project}/regions/{region}/instantSnapshotGroups/{resource}/testIamPermissions",
+"request": {
+"$ref": "TestPermissionsRequest"
+},
+"response": {
+"$ref": "TestPermissionsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/compute",
+"https://www.googleapis.com/auth/compute.readonly"
+]
 }
 }
 },
@@ -45278,7 +45558,7 @@
 }
 }
 },
-"revision": "20240827",
+"revision": "20240903",
 "rootUrl": "https://compute.googleapis.com/",
 "schemas": {
 "AWSV4Signature": {
@@ -60627,6 +60907,10 @@ false
 ],
 "type": "string"
 },
+"multiMig": {
+"description": "URL to the multi-MIG that this Managed Instance Group belongs to.",
+"type": "string"
+},
 "name": {
 "annotations": {
 "required": [
@@ -69632,6 +69916,9 @@ false
 ],
 "type": "string"
 },
+"currentActionDetails": {
+"$ref": "ManagedInstanceCurrentActionDetails"
+},
 "id": {
 "description": "[Output only] The unique identifier for this resource. This field is empty when instance does not exist.",
 "format": "uint64",
@@ -69751,6 +70038,45 @@ false
 },
 "type": "object"
 },
+"ManagedInstanceCurrentActionDetails": {
+"id": "ManagedInstanceCurrentActionDetails",
+"properties": {
+"methodName": {
+"type": "string"
+},
+"trigger": {
+"description": "[Output Only] Details of the current action that the managed instance group has scheduled for the instance. Contains trigger for the current action, and methodName in case it was triggered by API call. Possible values for trigger: - API Any API call. - PROACTIVE_UPDATE Proactive updater scheduled an update on this managed instance. - AUTOSCALING Instance being deleted/created after a decision from the Autoscaler. - REDISTRIBUTION The regional managed instance group is moving instances between zones to restore balance. - STANDBY_REFILL The managed instance group is refilling the Standby Pool (stopped/suspended virtual machines) after scale up. - MAINTENANCE Manual maintenance. - FAILED_CREATION The managed instance group is handling failed instance creation. - INSTANCE_FAILURE The managed instance group is handling instance failure, according to the Instance Lifecycle Policy. - FAILED_HEALTH_CHECK The managed instance group is handling failed health check, according to the Instance Lifecycle Policy. - TERMINATION_TIMESTAMP Instance reached termination time, thus managed instance group stops/deletes it. ",
+"enum": [
+"API",
+"AUTOSCALING",
+"FAILED_CREATION",
+"FAILED_HEALTH_CHECK",
+"INSTANCE_FAILURE",
+"MAINTENANCE",
+"NONE",
+"PROACTIVE_UPDATE",
+"REDISTRIBUTION",
+"STANDBY_REFILL",
+"TERMINATION_TIMESTAMP"
+],
+"enumDescriptions": [
+"Any API call.",
+"Instance being deleted/created after a decision from the Autoscaler.",
+"The managed instance group is handling failed instance creation.",
+"The managed instance group is handling failed health check, according to the Instance Lifecycle Policy.",
+"The managed instance group is handling instance failure, according to the Instance Lifecycle Policy.",
+"Manual maintenance.",
+"Default value, not visible externally.",
+"Proactive updater scheduled an update on this managed instance.",
+"The regional managed instance group is moving instances between zones to restore balance.",
+"The managed instance group is refilling the Standby Pool (stopped/suspended virtual machines) after scale up.",
+"Instance reached termination time, thus managed instance group stops/deletes it."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "ManagedInstanceInstanceFlexibilityOverride": {
 "id": "ManagedInstanceInstanceFlexibilityOverride",
 "properties": {
@@ -84640,6 +84966,10 @@ false
 "RoutePolicy": {
 "id": "RoutePolicy",
 "properties": {
+"description": {
+"description": "An optional description of route policy.",
+"type": "string"
+},
 "fingerprint": {
 "description": "A fingerprint for the Route Policy being applied to this Router, which is essentially a hash of the Route Policy used for optimistic locking. The fingerprint is initially generated by Compute Engine and changes after every request to modify or update Route Policy. You must always provide an up-to-date fingerprint hash in order to update or change labels. To see the latest fingerprint, make a getRoutePolicy() request to retrieve a Route Policy.",
 "format": "byte",
@@ -93787,7 +94117,7 @@ false
 "type": "string"
 },
 "internalIpv6Prefix": {
-"description": "[Output Only] The internal IPv6 address range that is assigned to this subnetwork.",
+"description": "The internal IPv6 address range that is owned by this subnetwork.",
 "type": "string"
 },
 "ipCidrRange": {
diff --git a/googleapiclient/discovery_cache/documents/compute.beta.json b/googleapiclient/discovery_cache/documents/compute.beta.json
index b5d029b5a12..fa1a1764e75 100644
--- a/googleapiclient/discovery_cache/documents/compute.beta.json
+++ b/googleapiclient/discovery_cache/documents/compute.beta.json
@@ -2007,7 +2007,7 @@
 ]
 },
 "listUsable": {
-"description": "Retrieves an aggregated list of all usable backend services in the specified project.",
+"description": "Retrieves a list of all usable backend services in the specified project.",
 "flatPath": "projects/{project}/global/backendServices/listUsable",
 "httpMethod": "GET",
 "id": "compute.backendServices.listUsable",
@@ -22797,7 +22797,7 @@
 ]
 },
 "listUsable": {
-"description": "Retrieves an aggregated list of all usable backend services in the specified project in the given region.",
+"description": "Retrieves a list of all usable backend services in the specified project in the given region.",
 "flatPath": "projects/{project}/regions/{region}/backendServices/listUsable",
 "httpMethod": "GET",
 "id": "compute.regionBackendServices.listUsable",
@@ -41911,7 +41911,7 @@
 }
 }
 },
-"revision": "20240827",
+"revision": "20240903",
 "rootUrl": "https://compute.googleapis.com/",
 "schemas": {
 "AWSV4Signature": {
@@ -44714,6 +44714,13 @@ false
 "selfLink": {
 "description": "[Output Only] Server-defined URL for the resource.",
 "type": "string"
+},
+"usedBy": {
+"description": "[Output Only] List of resources referencing that backend bucket.",
+"items": {
+"$ref": "BackendBucketUsedBy"
+},
+"type": "array"
 }
 },
 "type": "object"
@@ -45000,6 +45007,16 @@ false
 },
 "type": "object"
 },
+"BackendBucketUsedBy": {
+"id": "BackendBucketUsedBy",
+"properties": {
+"reference": {
+"description": "[Output Only] Server-defined URL for UrlMaps referencing that BackendBucket.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "BackendService": {
 "description": "Represents a Backend Service resource. A backend service defines how Google Cloud load balancers distribute traffic. The backend service configuration contains a set of values, such as the protocol used to connect to backends, various distribution and session settings, health checks, and timeouts. These settings provide fine-grained control over how your load balancer behaves. Most of the settings have default values that allow for easy configuration if you need to get started quickly. Backend services in Google Compute Engine can be either regionally or globally scoped. * [Global](https://cloud.google.com/compute/docs/reference/rest/beta/backendServices) * [Regional](https://cloud.google.com/compute/docs/reference/rest/beta/regionBackendServices) For more information, see Backend Services.",
 "id": "BackendService",
@@ -55913,6 +55930,10 @@ false
 ],
 "type": "string"
 },
+"multiMig": {
+"description": "URL to the multi-MIG that this Managed Instance Group belongs to.",
+"type": "string"
+},
 "name": {
 "annotations": {
 "required": [
@@ -65723,6 +65744,11 @@ false
 "description": "[Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.",
 "type": "string"
 },
+"producerPort": {
+"description": "The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type",
+"format": "int32",
+"type": "integer"
+},
 "pscConnectionId": {
 "description": "[Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.",
 "format": "uint64",
@@ -84304,7 +84330,7 @@ false
 "type": "string"
 },
 "internalIpv6Prefix": {
-"description": "[Output Only] The internal IPv6 address range that is assigned to this subnetwork.",
+"description": "The internal IPv6 address range that is owned by this subnetwork.",
 "type": "string"
 },
 "ipCidrRange": {
diff --git a/googleapiclient/discovery_cache/documents/compute.v1.json b/googleapiclient/discovery_cache/documents/compute.v1.json
index 4c953d387a3..b2da97c40c8 100644
--- a/googleapiclient/discovery_cache/documents/compute.v1.json
+++ b/googleapiclient/discovery_cache/documents/compute.v1.json
@@ -1915,7 +1915,7 @@
 ]
 },
 "listUsable": {
-"description": "Retrieves an aggregated list of all usable backend services in the specified project.",
+"description": "Retrieves a list of all usable backend services in the specified project.",
 "flatPath": "projects/{project}/global/backendServices/listUsable",
 "httpMethod": "GET",
 "id": "compute.backendServices.listUsable",
@@ -20638,7 +20638,7 @@
 ]
 },
 "listUsable": {
-"description": "Retrieves an aggregated list of all usable backend services in the specified project in the given region.",
+"description": "Retrieves a list of all usable backend services in the specified project in the given region.",
 "flatPath": "projects/{project}/regions/{region}/backendServices/listUsable",
 "httpMethod": "GET",
 "id": "compute.regionBackendServices.listUsable",
@@ -37779,7 +37779,7 @@
 }
 }
 },
-"revision": "20240827",
+"revision": "20240903",
 "rootUrl": "https://compute.googleapis.com/",
 "schemas": {
 "AWSV4Signature": {
@@ -40488,6 +40488,13 @@ false
 "selfLink": {
 "description": "[Output Only] Server-defined URL for the resource.",
 "type": "string"
+},
+"usedBy": {
+"description": "[Output Only] List of resources referencing that backend bucket.",
+"items": {
+"$ref": "BackendBucketUsedBy"
+},
+"type": "array"
 }
 },
 "type": "object"
@@ -40774,6 +40781,16 @@ false
 },
 "type": "object"
 },
+"BackendBucketUsedBy": {
+"id": "BackendBucketUsedBy",
+"properties": {
+"reference": {
+"description": "[Output Only] Server-defined URL for UrlMaps referencing that BackendBucket.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "BackendService": {
 "description": "Represents a Backend Service resource. A backend service defines how Google Cloud load balancers distribute traffic. The backend service configuration contains a set of values, such as the protocol used to connect to backends, various distribution and session settings, health checks, and timeouts. These settings provide fine-grained control over how your load balancer behaves. Most of the settings have default values that allow for easy configuration if you need to get started quickly. Backend services in Google Compute Engine can be either regionally or globally scoped. * [Global](https://cloud.google.com/compute/docs/reference/rest/v1/backendServices) * [Regional](https://cloud.google.com/compute/docs/reference/rest/v1/regionBackendServices) For more information, see Backend Services.",
 "id": "BackendService",
@@ -60665,6 +60682,11 @@ false
 "description": "[Output Only] Address allocated from given subnetwork for PSC. This IP address acts as a VIP for a PSC NEG, allowing it to act as an endpoint in L7 PSC-XLB.",
 "type": "string"
 },
+"producerPort": {
+"description": "The psc producer port is used to connect PSC NEG with specific port on the PSC Producer side; should only be used for the PRIVATE_SERVICE_CONNECT NEG type",
+"format": "int32",
+"type": "integer"
+},
 "pscConnectionId": {
 "description": "[Output Only] The PSC connection id of the PSC Network Endpoint Group Consumer.",
 "format": "uint64",
@@ -78077,7 +78099,7 @@ false
 "type": "string"
 },
 "internalIpv6Prefix": {
-"description": "[Output Only] The internal IPv6 address range that is assigned to this subnetwork.",
+"description": "The internal IPv6 address range that is owned by this subnetwork.",
 "type": "string"
 },
 "ipCidrRange": {

From 06ea65f66b6eee5e95b62224516c38dbd469d0bb Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:04 +0000
Subject: [PATCH 12/32] feat(contactcenterinsights): update the api

#### contactcenterinsights:v1

The following keys were added:
- schemas.GoogleCloudContactcenterinsightsV1Conversation.properties.metadataJson.type (Total Keys: 1)
- schemas.GoogleCloudContactcenterinsightsV1alpha1Conversation.properties.metadataJson.type (Total Keys: 1)
---
 ...erinsights_v1.projects.locations.conversations.html |  7 +++++++
 .../documents/contactcenterinsights.v1.json            | 10 +++++++++-
 2 files changed, 16 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.html b/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.html
index d1ccfb2d8e7..59f7320c924 100644
--- a/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.html
+++ b/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.html
@@ -451,6 +451,7 @@ Method Details
     },
   },
   "medium": "A String", # Immutable. The conversation medium, if unspecified will default to PHONE_CALL.
+  "metadataJson": "A String", # Input only. JSON Metadata encoded as a string. This field is primarily used by Insights integrations with various telphony systems and must be in one of Insights' supported formats.
   "name": "A String", # Immutable. The resource name of the conversation. Format: projects/{project}/locations/{location}/conversations/{conversation}
   "obfuscatedUserId": "A String", # Obfuscated user ID which the customer sent to us.
   "qualityMetadata": { # Conversation metadata related to quality management. # Conversation metadata related to quality management.
@@ -755,6 +756,7 @@ Method Details
     },
   },
   "medium": "A String", # Immutable. The conversation medium, if unspecified will default to PHONE_CALL.
+  "metadataJson": "A String", # Input only. JSON Metadata encoded as a string. This field is primarily used by Insights integrations with various telphony systems and must be in one of Insights' supported formats.
   "name": "A String", # Immutable. The resource name of the conversation. Format: projects/{project}/locations/{location}/conversations/{conversation}
   "obfuscatedUserId": "A String", # Obfuscated user ID which the customer sent to us.
   "qualityMetadata": { # Conversation metadata related to quality management. # Conversation metadata related to quality management.
@@ -1089,6 +1091,7 @@ Method Details
     },
   },
   "medium": "A String", # Immutable. The conversation medium, if unspecified will default to PHONE_CALL.
+  "metadataJson": "A String", # Input only. JSON Metadata encoded as a string. This field is primarily used by Insights integrations with various telphony systems and must be in one of Insights' supported formats.
   "name": "A String", # Immutable. The resource name of the conversation. Format: projects/{project}/locations/{location}/conversations/{conversation}
   "obfuscatedUserId": "A String", # Obfuscated user ID which the customer sent to us.
   "qualityMetadata": { # Conversation metadata related to quality management. # Conversation metadata related to quality management.
@@ -1476,6 +1479,7 @@ Method Details
         },
       },
       "medium": "A String", # Immutable. The conversation medium, if unspecified will default to PHONE_CALL.
+      "metadataJson": "A String", # Input only. JSON Metadata encoded as a string. This field is primarily used by Insights integrations with various telphony systems and must be in one of Insights' supported formats.
       "name": "A String", # Immutable. The resource name of the conversation. Format: projects/{project}/locations/{location}/conversations/{conversation}
       "obfuscatedUserId": "A String", # Obfuscated user ID which the customer sent to us.
       "qualityMetadata": { # Conversation metadata related to quality management. # Conversation metadata related to quality management.
@@ -1798,6 +1802,7 @@ Method Details
     },
   },
   "medium": "A String", # Immutable. The conversation medium, if unspecified will default to PHONE_CALL.
+  "metadataJson": "A String", # Input only. JSON Metadata encoded as a string. This field is primarily used by Insights integrations with various telphony systems and must be in one of Insights' supported formats.
   "name": "A String", # Immutable. The resource name of the conversation. Format: projects/{project}/locations/{location}/conversations/{conversation}
   "obfuscatedUserId": "A String", # Obfuscated user ID which the customer sent to us.
   "qualityMetadata": { # Conversation metadata related to quality management. # Conversation metadata related to quality management.
@@ -2102,6 +2107,7 @@ Method Details
     },
   },
   "medium": "A String", # Immutable. The conversation medium, if unspecified will default to PHONE_CALL.
+  "metadataJson": "A String", # Input only. JSON Metadata encoded as a string. This field is primarily used by Insights integrations with various telphony systems and must be in one of Insights' supported formats.
   "name": "A String", # Immutable. The resource name of the conversation. Format: projects/{project}/locations/{location}/conversations/{conversation}
   "obfuscatedUserId": "A String", # Obfuscated user ID which the customer sent to us.
   "qualityMetadata": { # Conversation metadata related to quality management. # Conversation metadata related to quality management.
@@ -2408,6 +2414,7 @@ Method Details
       },
     },
     "medium": "A String", # Immutable. The conversation medium, if unspecified will default to PHONE_CALL.
+    "metadataJson": "A String", # Input only. JSON Metadata encoded as a string. This field is primarily used by Insights integrations with various telphony systems and must be in one of Insights' supported formats.
     "name": "A String", # Immutable. The resource name of the conversation. Format: projects/{project}/locations/{location}/conversations/{conversation}
     "obfuscatedUserId": "A String", # Obfuscated user ID which the customer sent to us.
     "qualityMetadata": { # Conversation metadata related to quality management. # Conversation metadata related to quality management.
diff --git a/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json b/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json
index 02079c4f480..d15b5ec1df4 100644
--- a/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json
+++ b/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json
@@ -1531,7 +1531,7 @@
 }
 }
 },
-"revision": "20240805",
+"revision": "20240910",
 "rootUrl": "https://contactcenterinsights.googleapis.com/",
 "schemas": {
 "GoogleCloudContactcenterinsightsV1Analysis": {
@@ -2173,6 +2173,10 @@
 ],
 "type": "string"
 },
+"metadataJson": {
+"description": "Input only. JSON Metadata encoded as a string. This field is primarily used by Insights integrations with various telphony systems and must be in one of Insights' supported formats.",
+"type": "string"
+},
 "name": {
 "description": "Immutable. The resource name of the conversation. Format: projects/{project}/locations/{location}/conversations/{conversation}",
 "type": "string"
@@ -4774,6 +4778,10 @@
 ],
 "type": "string"
 },
+"metadataJson": {
+"description": "Input only. JSON Metadata encoded as a string. This field is primarily used by Insights integrations with various telphony systems and must be in one of Insights' supported formats.",
+"type": "string"
+},
 "name": {
 "description": "Immutable. The resource name of the conversation. Format: projects/{project}/locations/{location}/conversations/{conversation}",
 "type": "string"

From 04b980f8a26dc0f0e41405b28a053be9bcbc918a Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:04 +0000
Subject: [PATCH 13/32] feat(container): update the api

#### container:v1

The following keys were added:
- schemas.Cluster.properties.compliancePostureConfig.$ref (Total Keys: 1)
- schemas.ClusterUpdate.properties.desiredCompliancePostureConfig.$ref (Total Keys: 1)
- schemas.CompliancePostureConfig (Total Keys: 5)
- schemas.ComplianceStandard (Total Keys: 3)
---
 ...tainer_v1.projects.locations.clusters.html | 32 ++++++++++++
 .../container_v1.projects.zones.clusters.html | 32 ++++++++++++
 .../documents/container.v1.json               | 51 ++++++++++++++++++-
 3 files changed, 113 insertions(+), 2 deletions(-)

diff --git a/docs/dyn/container_v1.projects.locations.clusters.html b/docs/dyn/container_v1.projects.locations.clusters.html
index ac8843583e3..1f4ffb8501e 100644
--- a/docs/dyn/container_v1.projects.locations.clusters.html
+++ b/docs/dyn/container_v1.projects.locations.clusters.html
@@ -383,6 +383,14 @@ Method Details
       "evaluationMode": "A String", # Mode of operation for binauthz policy evaluation. If unspecified, defaults to DISABLED.
     },
     "clusterIpv4Cidr": "A String", # The IP address range of the container pods in this cluster, in [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) notation (e.g. `10.96.0.0/14`). Leave blank to have one automatically chosen or specify a `/14` block in `10.0.0.0/8`.
+    "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Enable/Disable Compliance Posture features for the cluster.
+      "complianceStandards": [ # List of enabled compliance standards.
+        { # Defines the details of a compliance standard.
+          "standard": "A String", # Name of the compliance standard.
+        },
+      ],
+      "mode": "A String", # Defines the enablement mode for Compliance Posture.
+    },
     "conditions": [ # Which conditions caused the current cluster state.
       { # StatusCondition describes why a cluster or a node pool has a certain status (e.g., ERROR or DEGRADED).
         "canonicalCode": "A String", # Canonical code of the condition.
@@ -1418,6 +1426,14 @@ Method Details
     "evaluationMode": "A String", # Mode of operation for binauthz policy evaluation. If unspecified, defaults to DISABLED.
   },
   "clusterIpv4Cidr": "A String", # The IP address range of the container pods in this cluster, in [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) notation (e.g. `10.96.0.0/14`). Leave blank to have one automatically chosen or specify a `/14` block in `10.0.0.0/8`.
+  "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Enable/Disable Compliance Posture features for the cluster.
+    "complianceStandards": [ # List of enabled compliance standards.
+      { # Defines the details of a compliance standard.
+        "standard": "A String", # Name of the compliance standard.
+      },
+    ],
+    "mode": "A String", # Defines the enablement mode for Compliance Posture.
+  },
   "conditions": [ # Which conditions caused the current cluster state.
     { # StatusCondition describes why a cluster or a node pool has a certain status (e.g., ERROR or DEGRADED).
       "canonicalCode": "A String", # Canonical code of the condition.
@@ -2356,6 +2372,14 @@ Method Details
         "evaluationMode": "A String", # Mode of operation for binauthz policy evaluation. If unspecified, defaults to DISABLED.
       },
       "clusterIpv4Cidr": "A String", # The IP address range of the container pods in this cluster, in [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) notation (e.g. `10.96.0.0/14`). Leave blank to have one automatically chosen or specify a `/14` block in `10.0.0.0/8`.
+      "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Enable/Disable Compliance Posture features for the cluster.
+        "complianceStandards": [ # List of enabled compliance standards.
+          { # Defines the details of a compliance standard.
+            "standard": "A String", # Name of the compliance standard.
+          },
+        ],
+        "mode": "A String", # Defines the enablement mode for Compliance Posture.
+      },
       "conditions": [ # Which conditions caused the current cluster state.
         { # StatusCondition describes why a cluster or a node pool has a certain status (e.g., ERROR or DEGRADED).
           "canonicalCode": "A String", # Canonical code of the condition.
@@ -4137,6 +4161,14 @@ Method Details
         },
       ],
     },
+    "desiredCompliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Enable/Disable Compliance Posture features for the cluster.
+      "complianceStandards": [ # List of enabled compliance standards.
+        { # Defines the details of a compliance standard.
+          "standard": "A String", # Name of the compliance standard.
+        },
+      ],
+      "mode": "A String", # Defines the enablement mode for Compliance Posture.
+    },
     "desiredContainerdConfig": { # ContainerdConfig contains configuration to customize containerd. # The desired containerd config for the cluster.
       "privateRegistryAccessConfig": { # PrivateRegistryAccessConfig contains access configuration for private container registries. # PrivateRegistryAccessConfig is used to configure access configuration for private container registries.
         "certificateAuthorityDomainConfig": [ # Private registry access configuration.
diff --git a/docs/dyn/container_v1.projects.zones.clusters.html b/docs/dyn/container_v1.projects.zones.clusters.html
index ada3393bd91..f98c91a8e97 100644
--- a/docs/dyn/container_v1.projects.zones.clusters.html
+++ b/docs/dyn/container_v1.projects.zones.clusters.html
@@ -471,6 +471,14 @@ Method Details
       "evaluationMode": "A String", # Mode of operation for binauthz policy evaluation. If unspecified, defaults to DISABLED.
     },
     "clusterIpv4Cidr": "A String", # The IP address range of the container pods in this cluster, in [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) notation (e.g. `10.96.0.0/14`). Leave blank to have one automatically chosen or specify a `/14` block in `10.0.0.0/8`.
+    "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Enable/Disable Compliance Posture features for the cluster.
+      "complianceStandards": [ # List of enabled compliance standards.
+        { # Defines the details of a compliance standard.
+          "standard": "A String", # Name of the compliance standard.
+        },
+      ],
+      "mode": "A String", # Defines the enablement mode for Compliance Posture.
+    },
     "conditions": [ # Which conditions caused the current cluster state.
       { # StatusCondition describes why a cluster or a node pool has a certain status (e.g., ERROR or DEGRADED).
         "canonicalCode": "A String", # Canonical code of the condition.
@@ -1506,6 +1514,14 @@ Method Details
     "evaluationMode": "A String", # Mode of operation for binauthz policy evaluation. If unspecified, defaults to DISABLED.
   },
   "clusterIpv4Cidr": "A String", # The IP address range of the container pods in this cluster, in [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) notation (e.g. `10.96.0.0/14`). Leave blank to have one automatically chosen or specify a `/14` block in `10.0.0.0/8`.
+  "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Enable/Disable Compliance Posture features for the cluster.
+    "complianceStandards": [ # List of enabled compliance standards.
+      { # Defines the details of a compliance standard.
+        "standard": "A String", # Name of the compliance standard.
+      },
+    ],
+    "mode": "A String", # Defines the enablement mode for Compliance Posture.
+  },
   "conditions": [ # Which conditions caused the current cluster state.
     { # StatusCondition describes why a cluster or a node pool has a certain status (e.g., ERROR or DEGRADED).
       "canonicalCode": "A String", # Canonical code of the condition.
@@ -2488,6 +2504,14 @@ Method Details
         "evaluationMode": "A String", # Mode of operation for binauthz policy evaluation. If unspecified, defaults to DISABLED.
       },
       "clusterIpv4Cidr": "A String", # The IP address range of the container pods in this cluster, in [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) notation (e.g. `10.96.0.0/14`). Leave blank to have one automatically chosen or specify a `/14` block in `10.0.0.0/8`.
+      "compliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Enable/Disable Compliance Posture features for the cluster.
+        "complianceStandards": [ # List of enabled compliance standards.
+          { # Defines the details of a compliance standard.
+            "standard": "A String", # Name of the compliance standard.
+          },
+        ],
+        "mode": "A String", # Defines the enablement mode for Compliance Posture.
+      },
       "conditions": [ # Which conditions caused the current cluster state.
         { # StatusCondition describes why a cluster or a node pool has a certain status (e.g., ERROR or DEGRADED).
           "canonicalCode": "A String", # Canonical code of the condition.
@@ -4164,6 +4188,14 @@ Method Details
         },
       ],
     },
+    "desiredCompliancePostureConfig": { # CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture. # Enable/Disable Compliance Posture features for the cluster.
+      "complianceStandards": [ # List of enabled compliance standards.
+        { # Defines the details of a compliance standard.
+          "standard": "A String", # Name of the compliance standard.
+        },
+      ],
+      "mode": "A String", # Defines the enablement mode for Compliance Posture.
+    },
     "desiredContainerdConfig": { # ContainerdConfig contains configuration to customize containerd. # The desired containerd config for the cluster.
       "privateRegistryAccessConfig": { # PrivateRegistryAccessConfig contains access configuration for private container registries. # PrivateRegistryAccessConfig is used to configure access configuration for private container registries.
         "certificateAuthorityDomainConfig": [ # Private registry access configuration.
diff --git a/googleapiclient/discovery_cache/documents/container.v1.json b/googleapiclient/discovery_cache/documents/container.v1.json
index c6faba864f2..1124de7a9ba 100644
--- a/googleapiclient/discovery_cache/documents/container.v1.json
+++ b/googleapiclient/discovery_cache/documents/container.v1.json
@@ -14,7 +14,7 @@
 "canonicalName": "Container",
 "description": "Builds and manages container-based applications, powered by the open source Kubernetes technology.",
 "discoveryVersion": "v1",
-"documentationLink": "https://cloud.google.com/container-engine/",
+"documentationLink": "https://cloud.google.com/kubernetes-engine/docs/",
 "fullyEncodeReservedExpansion": true,
 "icons": {
 "x16": "http://www.google.com/images/icons/product/search-16.gif",
@@ -2540,7 +2540,7 @@
 }
 }
 },
-"revision": "20240806",
+"revision": "20240814",
 "rootUrl": "https://container.googleapis.com/",
 "schemas": {
 "AcceleratorConfig": {
@@ -3147,6 +3147,10 @@
 "description": "The IP address range of the container pods in this cluster, in [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing) notation (e.g. `10.96.0.0/14`). Leave blank to have one automatically chosen or specify a `/14` block in `10.0.0.0/8`.",
 "type": "string"
 },
+"compliancePostureConfig": {
+"$ref": "CompliancePostureConfig",
+"description": "Enable/Disable Compliance Posture features for the cluster."
+},
 "conditions": {
 "description": "Which conditions caused the current cluster state.",
 "items": {
@@ -3565,6 +3569,10 @@
 "$ref": "ClusterAutoscaling",
 "description": "Cluster-level autoscaling configuration."
 },
+"desiredCompliancePostureConfig": {
+"$ref": "CompliancePostureConfig",
+"description": "Enable/Disable Compliance Posture features for the cluster."
+},
 "desiredContainerdConfig": {
 "$ref": "ContainerdConfig",
 "description": "The desired containerd config for the cluster."
@@ -3857,6 +3865,45 @@
 "properties": {},
 "type": "object"
 },
+"CompliancePostureConfig": {
+"description": "CompliancePostureConfig defines the settings needed to enable/disable features for the Compliance Posture.",
+"id": "CompliancePostureConfig",
+"properties": {
+"complianceStandards": {
+"description": "List of enabled compliance standards.",
+"items": {
+"$ref": "ComplianceStandard"
+},
+"type": "array"
+},
+"mode": {
+"description": "Defines the enablement mode for Compliance Posture.",
+"enum": [
+"MODE_UNSPECIFIED",
+"DISABLED",
+"ENABLED"
+],
+"enumDescriptions": [
+"Default value not specified.",
+"Disables Compliance Posture features on the cluster.",
+"Enables Compliance Posture features on the cluster."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"ComplianceStandard": {
+"description": "Defines the details of a compliance standard.",
+"id": "ComplianceStandard",
+"properties": {
+"standard": {
+"description": "Name of the compliance standard.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "ConfidentialNodes": {
 "description": "ConfidentialNodes is configuration for the confidential nodes feature, which makes nodes run on confidential VMs.",
 "id": "ConfidentialNodes",

From ab3b637a30b18e0eebb07fb42e2357cb26cd0556 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:04 +0000
Subject: [PATCH 14/32] feat(css): update the api

#### css:v1

The following keys were added:
- schemas.Attributes.properties.headlineOfferInstallment.$ref (Total Keys: 1)
- schemas.Attributes.properties.headlineOfferSubscriptionCost.$ref (Total Keys: 1)
- schemas.HeadlineOfferInstallment (Total Keys: 6)
- schemas.HeadlineOfferSubscriptionCost (Total Keys: 6)
---
 .../dyn/css_v1.accounts.cssProductInputs.html | 38 ++++++++++++
 docs/dyn/css_v1.accounts.cssProducts.html     | 38 ++++++++++++
 .../discovery_cache/documents/css.v1.json     | 60 ++++++++++++++++++-
 3 files changed, 135 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/css_v1.accounts.cssProductInputs.html b/docs/dyn/css_v1.accounts.cssProductInputs.html
index 0135c320fd3..583fc286f7f 100644
--- a/docs/dyn/css_v1.accounts.cssProductInputs.html
+++ b/docs/dyn/css_v1.accounts.cssProductInputs.html
@@ -150,6 +150,17 @@ Method Details
     "googleProductCategory": "A String", # Google's category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
     "gtin": "A String", # Global Trade Item Number ([GTIN](https://support.google.com/merchants/answer/188494#gtin)) of the item.
     "headlineOfferCondition": "A String", # Condition of the headline offer.
+    "headlineOfferInstallment": { # A message that represents installment. # Number and amount of installments to pay for an item.
+      "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per month.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "downpayment": { # The price represented as a number and currency. # The up-front down payment amount the buyer has to pay.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "months": "A String", # The number of installments the buyer has to pay.
+    },
     "headlineOfferLink": "A String", # Link to the headline offer.
     "headlineOfferMobileLink": "A String", # Mobile Link to the headline offer.
     "headlineOfferPrice": { # The price represented as a number and currency. # Headline Price of the aggregate offer.
@@ -160,6 +171,14 @@ Method Details
       "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
       "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
     },
+    "headlineOfferSubscriptionCost": { # The SubscriptionCost of the product. # Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract.
+      "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per subscription period.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "period": "A String", # The type of subscription period. Supported values are: * "`month`" * "`year`"
+      "periodLength": "A String", # The number of subscription periods the buyer has to pay.
+    },
     "highPrice": { # The price represented as a number and currency. # High Price of the aggregate offer.
       "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
       "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
@@ -275,6 +294,17 @@ Method Details
     "googleProductCategory": "A String", # Google's category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
     "gtin": "A String", # Global Trade Item Number ([GTIN](https://support.google.com/merchants/answer/188494#gtin)) of the item.
     "headlineOfferCondition": "A String", # Condition of the headline offer.
+    "headlineOfferInstallment": { # A message that represents installment. # Number and amount of installments to pay for an item.
+      "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per month.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "downpayment": { # The price represented as a number and currency. # The up-front down payment amount the buyer has to pay.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "months": "A String", # The number of installments the buyer has to pay.
+    },
     "headlineOfferLink": "A String", # Link to the headline offer.
     "headlineOfferMobileLink": "A String", # Mobile Link to the headline offer.
     "headlineOfferPrice": { # The price represented as a number and currency. # Headline Price of the aggregate offer.
@@ -285,6 +315,14 @@ Method Details
       "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
       "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
     },
+    "headlineOfferSubscriptionCost": { # The SubscriptionCost of the product. # Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract.
+      "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per subscription period.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "period": "A String", # The type of subscription period. Supported values are: * "`month`" * "`year`"
+      "periodLength": "A String", # The number of subscription periods the buyer has to pay.
+    },
     "highPrice": { # The price represented as a number and currency. # High Price of the aggregate offer.
       "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
       "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
diff --git a/docs/dyn/css_v1.accounts.cssProducts.html b/docs/dyn/css_v1.accounts.cssProducts.html
index 261fb3bad69..cf48bcfdd2a 100644
--- a/docs/dyn/css_v1.accounts.cssProducts.html
+++ b/docs/dyn/css_v1.accounts.cssProducts.html
@@ -139,6 +139,17 @@ Method Details
     "googleProductCategory": "A String", # Google's category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
     "gtin": "A String", # Global Trade Item Number ([GTIN](https://support.google.com/merchants/answer/188494#gtin)) of the item.
     "headlineOfferCondition": "A String", # Condition of the headline offer.
+    "headlineOfferInstallment": { # A message that represents installment. # Number and amount of installments to pay for an item.
+      "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per month.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "downpayment": { # The price represented as a number and currency. # The up-front down payment amount the buyer has to pay.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "months": "A String", # The number of installments the buyer has to pay.
+    },
     "headlineOfferLink": "A String", # Link to the headline offer.
     "headlineOfferMobileLink": "A String", # Mobile Link to the headline offer.
     "headlineOfferPrice": { # The price represented as a number and currency. # Headline Price of the aggregate offer.
@@ -149,6 +160,14 @@ Method Details
       "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
       "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
     },
+    "headlineOfferSubscriptionCost": { # The SubscriptionCost of the product. # Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract.
+      "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per subscription period.
+        "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+        "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+      },
+      "period": "A String", # The type of subscription period. Supported values are: * "`month`" * "`year`"
+      "periodLength": "A String", # The number of subscription periods the buyer has to pay.
+    },
     "highPrice": { # The price represented as a number and currency. # High Price of the aggregate offer.
       "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
       "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
@@ -306,6 +325,17 @@ Method Details
         "googleProductCategory": "A String", # Google's category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.
         "gtin": "A String", # Global Trade Item Number ([GTIN](https://support.google.com/merchants/answer/188494#gtin)) of the item.
         "headlineOfferCondition": "A String", # Condition of the headline offer.
+        "headlineOfferInstallment": { # A message that represents installment. # Number and amount of installments to pay for an item.
+          "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per month.
+            "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+            "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+          },
+          "downpayment": { # The price represented as a number and currency. # The up-front down payment amount the buyer has to pay.
+            "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+            "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+          },
+          "months": "A String", # The number of installments the buyer has to pay.
+        },
         "headlineOfferLink": "A String", # Link to the headline offer.
         "headlineOfferMobileLink": "A String", # Mobile Link to the headline offer.
         "headlineOfferPrice": { # The price represented as a number and currency. # Headline Price of the aggregate offer.
@@ -316,6 +346,14 @@ Method Details
           "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
           "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
         },
+        "headlineOfferSubscriptionCost": { # The SubscriptionCost of the product. # Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract.
+          "amount": { # The price represented as a number and currency. # The amount the buyer has to pay per subscription period.
+            "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
+            "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
+          },
+          "period": "A String", # The type of subscription period. Supported values are: * "`month`" * "`year`"
+          "periodLength": "A String", # The number of subscription periods the buyer has to pay.
+        },
         "highPrice": { # The price represented as a number and currency. # High Price of the aggregate offer.
           "amountMicros": "A String", # The price represented as a number in micros (1 million micros is an equivalent to one's currency standard unit, for example, 1 USD = 1000000 micros).
           "currencyCode": "A String", # The currency of the price using three-letter acronyms according to [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217).
diff --git a/googleapiclient/discovery_cache/documents/css.v1.json b/googleapiclient/discovery_cache/documents/css.v1.json
index 4330d0100cf..26dbf12572a 100644
--- a/googleapiclient/discovery_cache/documents/css.v1.json
+++ b/googleapiclient/discovery_cache/documents/css.v1.json
@@ -472,7 +472,7 @@
 }
 }
 },
-"revision": "20240719",
+"revision": "20240909",
 "rootUrl": "https://css.googleapis.com/",
 "schemas": {
 "Account": {
@@ -691,6 +691,10 @@
 "description": "Condition of the headline offer.",
 "type": "string"
 },
+"headlineOfferInstallment": {
+"$ref": "HeadlineOfferInstallment",
+"description": "Number and amount of installments to pay for an item."
+},
 "headlineOfferLink": {
 "description": "Link to the headline offer.",
 "type": "string"
@@ -707,6 +711,10 @@
 "$ref": "Price",
 "description": "Headline Price of the aggregate offer."
 },
+"headlineOfferSubscriptionCost": {
+"$ref": "HeadlineOfferSubscriptionCost",
+"description": "Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract."
+},
 "highPrice": {
 "$ref": "Price",
 "description": "High Price of the aggregate offer."
@@ -1022,6 +1030,56 @@
 "properties": {},
 "type": "object"
 },
+"HeadlineOfferInstallment": {
+"description": "A message that represents installment.",
+"id": "HeadlineOfferInstallment",
+"properties": {
+"amount": {
+"$ref": "Price",
+"description": "The amount the buyer has to pay per month."
+},
+"downpayment": {
+"$ref": "Price",
+"description": "The up-front down payment amount the buyer has to pay."
+},
+"months": {
+"description": "The number of installments the buyer has to pay.",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
+"HeadlineOfferSubscriptionCost": {
+"description": "The SubscriptionCost of the product.",
+"id": "HeadlineOfferSubscriptionCost",
+"properties": {
+"amount": {
+"$ref": "Price",
+"description": "The amount the buyer has to pay per subscription period."
+},
+"period": {
+"description": "The type of subscription period. Supported values are: * \"`month`\" * \"`year`\"",
+"enum": [
+"SUBSCRIPTION_PERIOD_UNSPECIFIED",
+"MONTH",
+"YEAR"
+],
+"enumDescriptions": [
+"Indicates that the subscription period is unspecified.",
+"Indicates that the subscription period is month.",
+"Indicates that the subscription period is year."
+],
+"type": "string"
+},
+"periodLength": {
+"description": "The number of subscription periods the buyer has to pay.",
+"format": "int64",
+"type": "string"
+}
+},
+"type": "object"
+},
 "ItemLevelIssue": {
 "description": "The ItemLevelIssue of the product status.",
 "id": "ItemLevelIssue",

From 78f62b8f69668839f6c5e2aeef1655ad20f76c94 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:04 +0000
Subject: [PATCH 15/32] feat(datastream): update the api

#### datastream:v1

The following keys were added:
- schemas.RunStreamRequest.properties.force.type (Total Keys: 1)
---
 docs/dyn/datastream_v1.projects.locations.streams.html      | 1 +
 .../discovery_cache/documents/datastream.v1.json            | 6 +++++-
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/datastream_v1.projects.locations.streams.html b/docs/dyn/datastream_v1.projects.locations.streams.html
index 9ec3c45e077..16b169002d4 100644
--- a/docs/dyn/datastream_v1.projects.locations.streams.html
+++ b/docs/dyn/datastream_v1.projects.locations.streams.html
@@ -1834,6 +1834,7 @@ Method Details
       },
     },
   },
+  "force": True or False, # Optional. Update the stream without validating it.
 }
 
   x__xgafv: string, V1 error format.
diff --git a/googleapiclient/discovery_cache/documents/datastream.v1.json b/googleapiclient/discovery_cache/documents/datastream.v1.json
index 8f41a0bd7b9..b7d44281b03 100644
--- a/googleapiclient/discovery_cache/documents/datastream.v1.json
+++ b/googleapiclient/discovery_cache/documents/datastream.v1.json
@@ -1250,7 +1250,7 @@
 }
 }
 },
-"revision": "20240814",
+"revision": "20240904",
 "rootUrl": "https://datastream.googleapis.com/",
 "schemas": {
 "AppendOnly": {
@@ -2778,6 +2778,10 @@
 "cdcStrategy": {
 "$ref": "CdcStrategy",
 "description": "Optional. The CDC strategy of the stream. If not set, the system's default value will be used."
+},
+"force": {
+"description": "Optional. Update the stream without validating it.",
+"type": "boolean"
 }
 },
 "type": "object"

From 7202a2a1b42134114bcb833fcbc181e081824b75 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:05 +0000
Subject: [PATCH 16/32] feat(discoveryengine): update the api

#### discoveryengine:v1

The following keys were deleted:
- schemas.GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadata.properties.status.type (Total Keys: 1)

The following keys were added:
- schemas.GoogleCloudDiscoveryengineV1AnswerQueryRequest.properties.asynchronousMode.deprecated (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1AnswerQueryRequestAnswerGenerationSpec.properties.ignoreJailBreakingQuery.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfo.properties.documentMetadata.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfoDocumentMetadata (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadata.properties.state.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1DataStore.properties.servingConfigDataStore.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1RecrawlUrisRequest.properties.siteCredential.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1SearchRequestBoostSpecConditionBoostSpec.properties.boostControlSpec.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1SearchRequestBoostSpecConditionBoostSpecBoostControlSpec (Total Keys: 12)
- schemas.GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpecSummarySpec.properties.ignoreJailBreakingQuery.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1ServingConfigDataStore (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1alphaDataStore.properties.naturalLanguageQueryUnderstandingConfig.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaDataStore.properties.servingConfigDataStore.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpec.properties.ignoreJailBreakingQuery.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaServingConfigDataStore (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1betaDataStore.properties.naturalLanguageQueryUnderstandingConfig.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaDataStore.properties.servingConfigDataStore.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaNaturalLanguageQueryUnderstandingConfig (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpec.properties.ignoreJailBreakingQuery.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaServingConfigDataStore (Total Keys: 3)

#### discoveryengine:v1alpha

The following keys were deleted:
- schemas.GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMetadata.properties.status.type (Total Keys: 1)

The following keys were added:
- schemas.GoogleCloudDiscoveryengineV1DataStore.properties.servingConfigDataStore.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1ServingConfigDataStore (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1alphaAnswerQueryRequest.properties.asynchronousMode.deprecated (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestAnswerGenerationSpec.properties.ignoreJailBreakingQuery.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfo.properties.documentMetadata.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfoDocumentMetadata (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMetadata.properties.state.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaDataStore.properties.naturalLanguageQueryUnderstandingConfig.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaDataStore.properties.servingConfigDataStore.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1alphaRecrawlUrisRequest.properties.siteCredential.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpec.properties.ignoreJailBreakingQuery.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaServingConfigDataStore (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1betaDataStore.properties.naturalLanguageQueryUnderstandingConfig.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaDataStore.properties.servingConfigDataStore.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaNaturalLanguageQueryUnderstandingConfig (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpec.properties.ignoreJailBreakingQuery.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaServingConfigDataStore (Total Keys: 3)

#### discoveryengine:v1beta

The following keys were deleted:
- schemas.GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMetadata.properties.status.type (Total Keys: 1)

The following keys were added:
- schemas.GoogleCloudDiscoveryengineV1DataStore.properties.servingConfigDataStore.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1ServingConfigDataStore (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1alphaDataStore.properties.naturalLanguageQueryUnderstandingConfig.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaDataStore.properties.servingConfigDataStore.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1alphaSearchRequestContentSearchSpecSummarySpec.properties.ignoreJailBreakingQuery.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaServingConfigDataStore (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1betaAnswerQueryRequest.properties.asynchronousMode.deprecated (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaAnswerQueryRequestAnswerGenerationSpec.properties.ignoreJailBreakingQuery.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfo.properties.documentMetadata.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfoDocumentMetadata (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMetadata.properties.state.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaDataStore.properties.naturalLanguageQueryUnderstandingConfig.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaDataStore.properties.servingConfigDataStore.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaNaturalLanguageQueryUnderstandingConfig (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1betaRecrawlUrisRequest.properties.siteCredential.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaSearchRequestContentSearchSpecSummarySpec.properties.ignoreJailBreakingQuery.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaServingConfigDataStore (Total Keys: 3)
---
 ...tions.collections.dataStores.branches.html |   2 +-
 ...tions.collections.dataStores.controls.html |   8 +-
 ....collections.dataStores.conversations.html |  24 +-
 ...s.collections.dataStores.customModels.html |   2 +-
 ...ects.locations.collections.dataStores.html |  25 +-
 ...collections.dataStores.servingConfigs.html |  34 +-
 ...llections.dataStores.sessions.answers.html |   4 +-
 ...tions.collections.dataStores.sessions.html |   8 +-
 ...llections.dataStores.siteSearchEngine.html |   1 +
 ...ons.collections.dataStores.userEvents.html |   8 +-
 ...ocations.collections.engines.controls.html |   8 +-
 ...ons.collections.engines.conversations.html |  24 +-
 ...rojects.locations.collections.engines.html |  12 +-
 ...ns.collections.engines.servingConfigs.html |  34 +-
 ....collections.engines.sessions.answers.html |   4 +-
 ...ocations.collections.engines.sessions.html |   8 +-
 ...rojects.locations.dataStores.branches.html |   2 +-
 ...rojects.locations.dataStores.controls.html |   8 +-
 ...ts.locations.dataStores.conversations.html |  24 +-
 ...gine_v1.projects.locations.dataStores.html |  25 +-
 ...s.locations.dataStores.servingConfigs.html |  34 +-
 ...locations.dataStores.sessions.answers.html |   4 +-
 ...rojects.locations.dataStores.sessions.html |   8 +-
 ...locations.dataStores.siteSearchEngine.html |   1 +
 ...jects.locations.dataStores.userEvents.html |   8 +-
 ..._v1.projects.locations.rankingConfigs.html |   2 +-
 ...gine_v1.projects.locations.userEvents.html |   4 +-
 .../dyn/discoveryengine_v1alpha.projects.html |   4 +-
 ...tions.collections.dataStores.branches.html |   2 +-
 ...tions.collections.dataStores.controls.html |   8 +-
 ....collections.dataStores.conversations.html |  13 +-
 ...s.collections.dataStores.customModels.html |   2 +-
 ...ects.locations.collections.dataStores.html |  48 ++-
 ...collections.dataStores.servingConfigs.html |  20 +-
 ...llections.dataStores.sessions.answers.html |   4 +-
 ...tions.collections.dataStores.sessions.html |   8 +-
 ...llections.dataStores.siteSearchEngine.html |   1 +
 ...ons.collections.dataStores.userEvents.html |   8 +-
 ...ocations.collections.engines.controls.html |   8 +-
 ...ons.collections.engines.conversations.html |  13 +-
 ...rojects.locations.collections.engines.html |  22 +-
 ...ns.collections.engines.servingConfigs.html |  20 +-
 ....collections.engines.sessions.answers.html |   4 +-
 ...ocations.collections.engines.sessions.html |   8 +-
 ...rojects.locations.dataStores.branches.html |   2 +-
 ...rojects.locations.dataStores.controls.html |   8 +-
 ...ts.locations.dataStores.conversations.html |  13 +-
 ...v1alpha.projects.locations.dataStores.html |  48 ++-
 ...s.locations.dataStores.servingConfigs.html |  20 +-
 ...locations.dataStores.sessions.answers.html |   4 +-
 ...rojects.locations.dataStores.sessions.html |   8 +-
 ...locations.dataStores.siteSearchEngine.html |   1 +
 ...jects.locations.dataStores.userEvents.html |   8 +-
 ...1alpha.projects.locations.evaluations.html |   3 +
 ...pha.projects.locations.rankingConfigs.html |   2 +-
 ...v1alpha.projects.locations.userEvents.html |   4 +-
 ...tions.collections.dataStores.branches.html |   2 +-
 ...tions.collections.dataStores.controls.html |   8 +-
 ....collections.dataStores.conversations.html |  13 +-
 ...s.collections.dataStores.customModels.html |   2 +-
 ...ects.locations.collections.dataStores.html |  40 +-
 ...collections.dataStores.servingConfigs.html |  20 +-
 ...llections.dataStores.sessions.answers.html |   4 +-
 ...tions.collections.dataStores.sessions.html |   8 +-
 ...llections.dataStores.siteSearchEngine.html |   1 +
 ...ons.collections.dataStores.userEvents.html |   8 +-
 ...ocations.collections.engines.controls.html |   8 +-
 ...ons.collections.engines.conversations.html |  13 +-
 ...rojects.locations.collections.engines.html |  22 +-
 ...ns.collections.engines.servingConfigs.html |  20 +-
 ....collections.engines.sessions.answers.html |   4 +-
 ...ocations.collections.engines.sessions.html |   8 +-
 ...rojects.locations.dataStores.branches.html |   2 +-
 ...rojects.locations.dataStores.controls.html |   8 +-
 ...ts.locations.dataStores.conversations.html |  13 +-
 ..._v1beta.projects.locations.dataStores.html |  40 +-
 ...s.locations.dataStores.servingConfigs.html |  20 +-
 ...locations.dataStores.sessions.answers.html |   4 +-
 ...rojects.locations.dataStores.sessions.html |   8 +-
 ...locations.dataStores.siteSearchEngine.html |   1 +
 ...jects.locations.dataStores.userEvents.html |   8 +-
 ...v1beta.projects.locations.evaluations.html |   3 +
 ...eta.projects.locations.rankingConfigs.html |   2 +-
 ..._v1beta.projects.locations.userEvents.html |   4 +-
 .../documents/discoveryengine.v1.json         | 345 ++++++++++++++----
 .../documents/discoveryengine.v1alpha.json    | 295 ++++++++++-----
 .../documents/discoveryengine.v1beta.json     | 293 +++++++++++----
 87 files changed, 1338 insertions(+), 529 deletions(-)

diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.branches.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.branches.html
index e49c56b6ac6..08fbbad6211 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.branches.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.branches.html
@@ -116,7 +116,7 @@ Method Details
         "fhirResource": "A String", # Required. Format: projects/{project}/locations/{location}/datasets/{dataset}/fhirStores/{fhir_store}/fhir/{resource_type}/{fhir_resource_id}
         "uri": "A String", # If match by URI, the URI of the Document.
       },
-      "status": "A String", # The status of the document.
+      "state": "A String", # The state of the document.
     },
   ],
 }
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.controls.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.controls.html
index 574ee9cf4b7..bd6b3dd381f 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.controls.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.controls.html
@@ -106,7 +106,7 @@ Method Details
   Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -215,7 +215,7 @@ Method Details
   Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -233,7 +233,7 @@ Method Details
   Gets a Control.
 
 Args:
-  name: string, Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -293,7 +293,7 @@ Method Details
   Lists all Controls by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   filter: string, Optional. A filter to apply on the list results. Supported features: * List all the products under the parent branch if filter is unset. Currently this field is unsupported.
   pageSize: integer, Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, Optional. A page token, received from a previous `ListControls` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.conversations.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.conversations.html
index 1a7eff00b93..caed0369ee8 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.conversations.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.conversations.html
@@ -109,7 +109,7 @@ Method Details
   Converses a conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -118,6 +118,17 @@ Method Details
     "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifictions, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
       { # Boost applies to documents which match a condition.
         "boost": 3.14, # Strength of the condition boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the document a big promotion. However, it does not necessarily mean that the boosted document will be the top result at all times, nor that other documents will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant documents. Setting to -1.0 gives the document a big demotion. However, results that are deeply relevant might still be shown. The document will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored. Only one of the (condition, boost) combination or the boost_control_spec below are set. If both are set then the global boost is ignored and the more fine-grained boost_control_spec is applied.
+        "boostControlSpec": { # Specification for custom ranking based on customer specified attribute value. It provides more controls for customized ranking than the simple (condition, boost) combination above. # Complex specification for custom ranking based on customer defined attribute value.
+          "attributeType": "A String", # The attribute type to be used to determine the boost amount. The attribute value can be derived from the field value of the specified field_name. In the case of numerical it is straightforward i.e. attribute_value = numerical_field_value. In the case of freshness however, attribute_value = (time.now() - datetime_field_value).
+          "controlPoints": [ # The control points used to define the curve. The monotonic function (defined through the interpolation_type above) passes through the control points listed here.
+            { # The control points used to define the curve. The curve defined through these control points can only be monotonically increasing or decreasing(constant values are acceptable).
+              "attributeValue": "A String", # Can be one of: 1. The numerical field value. 2. The duration spec for freshness: The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`.
+              "boostAmount": 3.14, # The value between -1 to 1 by which to boost the score if the attribute_value evaluates to the value specified above.
+            },
+          ],
+          "fieldName": "A String", # The name of the field whose value will be used to determine the boost amount.
+          "interpolationType": "A String", # The interpolation type to be applied to connect the control points listed below.
+        },
         "condition": "A String", # An expression which specifies a boost condition. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost documents with document ID "doc_1" or "doc_2", and color "Red" or "Blue": `(document_id: ANY("doc_1", "doc_2")) AND (color: ANY("Red", "Blue"))`
       },
     ],
@@ -199,9 +210,10 @@ Method Details
     "input": "A String", # Text input.
   },
   "safeSearch": True or False, # Whether to turn on safe search.
-  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
+  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
   "summarySpec": { # A specification for configuring a summary returned in a search response. # A specification for configuring the summary returned in the response.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
     "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -414,7 +426,7 @@ Method Details
   Creates a Conversation. If the Conversation to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -566,7 +578,7 @@ Method Details
   Deletes a Conversation. If the Conversation to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -584,7 +596,7 @@ Method Details
   Gets a Conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -666,7 +678,7 @@ Method Details
   Lists all Conversations by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `conversation_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.customModels.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.customModels.html
index 83d55b459f5..371b92fe166 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.customModels.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.customModels.html
@@ -110,7 +110,7 @@ Method Details
       },
       "modelState": "A String", # The state that the model is in (e.g.`TRAINING` or `TRAINING_FAILED`).
       "modelVersion": "A String", # The version of the model.
-      "name": "A String", # Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}` model must be an alpha-numerical string with limit of 40 characters.
+      "name": "A String", # Required. The fully qualified resource name of the model. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}`. Model must be an alpha-numerical string with limit of 40 characters.
       "trainingStartTime": "A String", # Timestamp the model training was initiated.
     },
   ],
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.html
index f6a02354045..f3a9224c75e 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.html
@@ -240,7 +240,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -257,6 +257,9 @@ Method Details
   },
   "industryVertical": "A String", # Immutable. The industry vertical that the data store registers.
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -379,7 +382,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -396,6 +399,9 @@ Method Details
   },
   "industryVertical": "A String", # Immutable. The industry vertical that the data store registers.
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -476,7 +482,7 @@ Method Details
           },
         },
         "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-        "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+        "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
           "a_key": { # Related configurations applied to a specific type of document parser.
             "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
             },
@@ -493,6 +499,9 @@ Method Details
       },
       "industryVertical": "A String", # Immutable. The industry vertical that the data store registers.
       "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+      "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+        "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+      },
       "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
         "A String",
       ],
@@ -561,7 +570,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -578,6 +587,9 @@ Method Details
   },
   "industryVertical": "A String", # Immutable. The industry vertical that the data store registers.
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -628,7 +640,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -645,6 +657,9 @@ Method Details
   },
   "industryVertical": "A String", # Immutable. The industry vertical that the data store registers.
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.servingConfigs.html
index 87b6625f873..6694d5b257e 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.servingConfigs.html
@@ -103,6 +103,7 @@ Method Details
   "answerGenerationSpec": { # Answer generation specification. # Answer generation specification.
     "answerLanguageCode": "A String", # Language code for Answer. Use language tags defined by [BCP47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Note: This is an experimental feature.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No answer is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating answers for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true` or unset, the behavior will be determined automatically by the service.
     "ignoreNonAnswerSeekingQuery": True or False, # Specifies whether to filter out queries that are not answer-seeking. The default value is `false`. Google employs search-query classification to detect answer-seeking queries. No answer is returned if the search query is classified as a non-answer seeking query. If this field is set to `true`, we skip generating answers for non-answer seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citation metadata in the answer. The default value is `false`.
@@ -113,7 +114,7 @@ Method Details
       "preamble": "A String", # Customized preamble.
     },
   },
-  "asynchronousMode": True or False, # Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
+  "asynchronousMode": True or False, # Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
   "query": { # Defines a user inputed query. # Required. Current user query.
     "queryId": "A String", # Unique Id for the query.
     "text": "A String", # Plain text.
@@ -141,6 +142,17 @@ Method Details
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifictions, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
           { # Boost applies to documents which match a condition.
             "boost": 3.14, # Strength of the condition boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the document a big promotion. However, it does not necessarily mean that the boosted document will be the top result at all times, nor that other documents will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant documents. Setting to -1.0 gives the document a big demotion. However, results that are deeply relevant might still be shown. The document will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored. Only one of the (condition, boost) combination or the boost_control_spec below are set. If both are set then the global boost is ignored and the more fine-grained boost_control_spec is applied.
+            "boostControlSpec": { # Specification for custom ranking based on customer specified attribute value. It provides more controls for customized ranking than the simple (condition, boost) combination above. # Complex specification for custom ranking based on customer defined attribute value.
+              "attributeType": "A String", # The attribute type to be used to determine the boost amount. The attribute value can be derived from the field value of the specified field_name. In the case of numerical it is straightforward i.e. attribute_value = numerical_field_value. In the case of freshness however, attribute_value = (time.now() - datetime_field_value).
+              "controlPoints": [ # The control points used to define the curve. The monotonic function (defined through the interpolation_type above) passes through the control points listed here.
+                { # The control points used to define the curve. The curve defined through these control points can only be monotonically increasing or decreasing(constant values are acceptable).
+                  "attributeValue": "A String", # Can be one of: 1. The numerical field value. 2. The duration spec for freshness: The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`.
+                  "boostAmount": 3.14, # The value between -1 to 1 by which to boost the score if the attribute_value evaluates to the value specified above.
+                },
+              ],
+              "fieldName": "A String", # The name of the field whose value will be used to determine the boost amount.
+              "interpolationType": "A String", # The interpolation type to be applied to connect the control points listed below.
+            },
             "condition": "A String", # An expression which specifies a boost condition. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost documents with document ID "doc_1" or "doc_2", and color "Red" or "Blue": `(document_id: ANY("doc_1", "doc_2")) AND (color: ANY("Red", "Blue"))`
           },
         ],
@@ -161,6 +173,10 @@ Method Details
           "chunkInfo": { # Chunk information. # Chunk information.
             "chunk": "A String", # Chunk resource name.
             "content": "A String", # Chunk textual content.
+            "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk.
+              "title": "A String", # Title of the document.
+              "uri": "A String", # Uri of the document.
+            },
           },
           "unstructuredDocumentInfo": { # Unstructured document information. # Unstructured document information.
             "document": "A String", # Document resource name.
@@ -296,7 +312,7 @@ Method Details
                       "snippetStatus": "A String", # Status of the snippet defined by the search team.
                     },
                   ],
-                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                     "a_key": "", # Properties of the object.
                   },
                   "title": "A String", # Title.
@@ -377,7 +393,7 @@ Method Details
       { # Detailed document information associated with a user event.
         "id": "A String", # The Document resource ID.
         "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-        "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+        "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
         "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
           "A String",
         ],
@@ -509,6 +525,17 @@ Method Details
     "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifictions, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
       { # Boost applies to documents which match a condition.
         "boost": 3.14, # Strength of the condition boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the document a big promotion. However, it does not necessarily mean that the boosted document will be the top result at all times, nor that other documents will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant documents. Setting to -1.0 gives the document a big demotion. However, results that are deeply relevant might still be shown. The document will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored. Only one of the (condition, boost) combination or the boost_control_spec below are set. If both are set then the global boost is ignored and the more fine-grained boost_control_spec is applied.
+        "boostControlSpec": { # Specification for custom ranking based on customer specified attribute value. It provides more controls for customized ranking than the simple (condition, boost) combination above. # Complex specification for custom ranking based on customer defined attribute value.
+          "attributeType": "A String", # The attribute type to be used to determine the boost amount. The attribute value can be derived from the field value of the specified field_name. In the case of numerical it is straightforward i.e. attribute_value = numerical_field_value. In the case of freshness however, attribute_value = (time.now() - datetime_field_value).
+          "controlPoints": [ # The control points used to define the curve. The monotonic function (defined through the interpolation_type above) passes through the control points listed here.
+            { # The control points used to define the curve. The curve defined through these control points can only be monotonically increasing or decreasing(constant values are acceptable).
+              "attributeValue": "A String", # Can be one of: 1. The numerical field value. 2. The duration spec for freshness: The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`.
+              "boostAmount": 3.14, # The value between -1 to 1 by which to boost the score if the attribute_value evaluates to the value specified above.
+            },
+          ],
+          "fieldName": "A String", # The name of the field whose value will be used to determine the boost amount.
+          "interpolationType": "A String", # The interpolation type to be applied to connect the control points listed below.
+        },
         "condition": "A String", # An expression which specifies a boost condition. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost documents with document ID "doc_1" or "doc_2", and color "Red" or "Blue": `(document_id: ANY("doc_1", "doc_2")) AND (color: ANY("Red", "Blue"))`
       },
     ],
@@ -535,6 +562,7 @@ Method Details
     },
     "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
       "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+      "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
       "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
       "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
       "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.sessions.answers.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.sessions.answers.html
index f0f45e6749b..ae797773698 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.sessions.answers.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.sessions.answers.html
@@ -91,7 +91,7 @@ Method Details
   Gets a Answer.
 
 Args:
-  name: string, Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
+  name: string, Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -191,7 +191,7 @@ Method Details
                     "snippetStatus": "A String", # Status of the snippet defined by the search team.
                   },
                 ],
-                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                   "a_key": "", # Properties of the object.
                 },
                 "title": "A String", # Title.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.sessions.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.sessions.html
index a9fa899e5e3..acf7b2c3d89 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.sessions.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.sessions.html
@@ -111,7 +111,7 @@ Method Details
   Creates a Session. If the Session to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -163,7 +163,7 @@ Method Details
   Deletes a Session. If the Session to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -181,7 +181,7 @@ Method Details
   Gets a Session.
 
 Args:
-  name: string, Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -213,7 +213,7 @@ Method Details
   Lists all Sessions by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.html
index 7b4ed01f0b2..db64163d6c9 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.siteSearchEngine.html
@@ -301,6 +301,7 @@ Method Details
     The object takes the form of:
 
 { # Request message for SiteSearchEngineService.RecrawlUris method.
+  "siteCredential": "A String", # Optional. Full resource name of the SiteCredential, such as `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCredentials/*`. Only set to crawl private URIs.
   "uris": [ # Required. List of URIs to crawl. At most 10K URIs are supported, otherwise an INVALID_ARGUMENT error is thrown. Each URI should match at least one TargetSite in `site_search_engine`.
     "A String",
   ],
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.userEvents.html
index 40bf7b11a9c..1a871d680b1 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.userEvents.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.userEvents.html
@@ -178,7 +178,7 @@ Method Details
           { # Detailed document information associated with a user event.
             "id": "A String", # The Document resource ID.
             "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-            "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+            "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
             "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
               "A String",
             ],
@@ -270,7 +270,7 @@ Method Details
   Deletes permanently all user events specified by the filter provided. Depending on the number of events specified by the filter, this operation could take hours or days to complete. To test a filter, use the list command first.
 
 Args:
-  parent: string, Required. The resource name of the catalog under which the events are created. The format is `projects/${projectId}/locations/global/collections/{$collectionId}/dataStores/${dataStoreId}` (required)
+  parent: string, Required. The resource name of the catalog under which the events are created. The format is `projects/{project}/locations/global/collections/{collection}/dataStores/{dataStore}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -339,7 +339,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
@@ -425,7 +425,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.controls.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.controls.html
index 4c897c26ac7..9d1072e7aea 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.controls.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.controls.html
@@ -106,7 +106,7 @@ Method Details
   Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -215,7 +215,7 @@ Method Details
   Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -233,7 +233,7 @@ Method Details
   Gets a Control.
 
 Args:
-  name: string, Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -293,7 +293,7 @@ Method Details
   Lists all Controls by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   filter: string, Optional. A filter to apply on the list results. Supported features: * List all the products under the parent branch if filter is unset. Currently this field is unsupported.
   pageSize: integer, Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, Optional. A page token, received from a previous `ListControls` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.conversations.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.conversations.html
index 440a597d9c1..dad4bfa1b77 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.conversations.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.conversations.html
@@ -109,7 +109,7 @@ Method Details
   Converses a conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -118,6 +118,17 @@ Method Details
     "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifictions, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
       { # Boost applies to documents which match a condition.
         "boost": 3.14, # Strength of the condition boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the document a big promotion. However, it does not necessarily mean that the boosted document will be the top result at all times, nor that other documents will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant documents. Setting to -1.0 gives the document a big demotion. However, results that are deeply relevant might still be shown. The document will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored. Only one of the (condition, boost) combination or the boost_control_spec below are set. If both are set then the global boost is ignored and the more fine-grained boost_control_spec is applied.
+        "boostControlSpec": { # Specification for custom ranking based on customer specified attribute value. It provides more controls for customized ranking than the simple (condition, boost) combination above. # Complex specification for custom ranking based on customer defined attribute value.
+          "attributeType": "A String", # The attribute type to be used to determine the boost amount. The attribute value can be derived from the field value of the specified field_name. In the case of numerical it is straightforward i.e. attribute_value = numerical_field_value. In the case of freshness however, attribute_value = (time.now() - datetime_field_value).
+          "controlPoints": [ # The control points used to define the curve. The monotonic function (defined through the interpolation_type above) passes through the control points listed here.
+            { # The control points used to define the curve. The curve defined through these control points can only be monotonically increasing or decreasing(constant values are acceptable).
+              "attributeValue": "A String", # Can be one of: 1. The numerical field value. 2. The duration spec for freshness: The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`.
+              "boostAmount": 3.14, # The value between -1 to 1 by which to boost the score if the attribute_value evaluates to the value specified above.
+            },
+          ],
+          "fieldName": "A String", # The name of the field whose value will be used to determine the boost amount.
+          "interpolationType": "A String", # The interpolation type to be applied to connect the control points listed below.
+        },
         "condition": "A String", # An expression which specifies a boost condition. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost documents with document ID "doc_1" or "doc_2", and color "Red" or "Blue": `(document_id: ANY("doc_1", "doc_2")) AND (color: ANY("Red", "Blue"))`
       },
     ],
@@ -199,9 +210,10 @@ Method Details
     "input": "A String", # Text input.
   },
   "safeSearch": True or False, # Whether to turn on safe search.
-  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
+  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
   "summarySpec": { # A specification for configuring a summary returned in a search response. # A specification for configuring the summary returned in the response.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
     "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -414,7 +426,7 @@ Method Details
   Creates a Conversation. If the Conversation to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -566,7 +578,7 @@ Method Details
   Deletes a Conversation. If the Conversation to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -584,7 +596,7 @@ Method Details
   Gets a Conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -666,7 +678,7 @@ Method Details
   Lists all Conversations by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `conversation_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.html
index b005243c079..2ec61a880a5 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.html
@@ -157,7 +157,7 @@ Method Details
   ],
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
   "industryVertical": "A String", # The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine.
-  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
   "searchEngineConfig": { # Configurations for a Search Engine. # Configurations for the Search Engine. Only applicable if solution_type is SOLUTION_TYPE_SEARCH.
     "searchAddOns": [ # The add-on that this search engine enables.
       "A String",
@@ -269,7 +269,7 @@ Method Details
   ],
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
   "industryVertical": "A String", # The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine.
-  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
   "searchEngineConfig": { # Configurations for a Search Engine. # Configurations for the Search Engine. Only applicable if solution_type is SOLUTION_TYPE_SEARCH.
     "searchAddOns": [ # The add-on that this search engine enables.
       "A String",
@@ -322,7 +322,7 @@ Method Details
       ],
       "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
       "industryVertical": "A String", # The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine.
-      "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+      "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
       "searchEngineConfig": { # Configurations for a Search Engine. # Configurations for the Search Engine. Only applicable if solution_type is SOLUTION_TYPE_SEARCH.
         "searchAddOns": [ # The add-on that this search engine enables.
           "A String",
@@ -356,7 +356,7 @@ Method Details
   Updates an Engine
 
 Args:
-  name: string, Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned. (required)
+  name: string, Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -382,7 +382,7 @@ Method Details
   ],
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
   "industryVertical": "A String", # The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine.
-  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
   "searchEngineConfig": { # Configurations for a Search Engine. # Configurations for the Search Engine. Only applicable if solution_type is SOLUTION_TYPE_SEARCH.
     "searchAddOns": [ # The add-on that this search engine enables.
       "A String",
@@ -424,7 +424,7 @@ Method Details
   ],
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
   "industryVertical": "A String", # The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine.
-  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
   "searchEngineConfig": { # Configurations for a Search Engine. # Configurations for the Search Engine. Only applicable if solution_type is SOLUTION_TYPE_SEARCH.
     "searchAddOns": [ # The add-on that this search engine enables.
       "A String",
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.servingConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.servingConfigs.html
index fc1f9e03b48..e5868fbd062 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.servingConfigs.html
@@ -103,6 +103,7 @@ Method Details
   "answerGenerationSpec": { # Answer generation specification. # Answer generation specification.
     "answerLanguageCode": "A String", # Language code for Answer. Use language tags defined by [BCP47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Note: This is an experimental feature.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No answer is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating answers for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true` or unset, the behavior will be determined automatically by the service.
     "ignoreNonAnswerSeekingQuery": True or False, # Specifies whether to filter out queries that are not answer-seeking. The default value is `false`. Google employs search-query classification to detect answer-seeking queries. No answer is returned if the search query is classified as a non-answer seeking query. If this field is set to `true`, we skip generating answers for non-answer seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citation metadata in the answer. The default value is `false`.
@@ -113,7 +114,7 @@ Method Details
       "preamble": "A String", # Customized preamble.
     },
   },
-  "asynchronousMode": True or False, # Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
+  "asynchronousMode": True or False, # Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
   "query": { # Defines a user inputed query. # Required. Current user query.
     "queryId": "A String", # Unique Id for the query.
     "text": "A String", # Plain text.
@@ -141,6 +142,17 @@ Method Details
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifictions, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
           { # Boost applies to documents which match a condition.
             "boost": 3.14, # Strength of the condition boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the document a big promotion. However, it does not necessarily mean that the boosted document will be the top result at all times, nor that other documents will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant documents. Setting to -1.0 gives the document a big demotion. However, results that are deeply relevant might still be shown. The document will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored. Only one of the (condition, boost) combination or the boost_control_spec below are set. If both are set then the global boost is ignored and the more fine-grained boost_control_spec is applied.
+            "boostControlSpec": { # Specification for custom ranking based on customer specified attribute value. It provides more controls for customized ranking than the simple (condition, boost) combination above. # Complex specification for custom ranking based on customer defined attribute value.
+              "attributeType": "A String", # The attribute type to be used to determine the boost amount. The attribute value can be derived from the field value of the specified field_name. In the case of numerical it is straightforward i.e. attribute_value = numerical_field_value. In the case of freshness however, attribute_value = (time.now() - datetime_field_value).
+              "controlPoints": [ # The control points used to define the curve. The monotonic function (defined through the interpolation_type above) passes through the control points listed here.
+                { # The control points used to define the curve. The curve defined through these control points can only be monotonically increasing or decreasing(constant values are acceptable).
+                  "attributeValue": "A String", # Can be one of: 1. The numerical field value. 2. The duration spec for freshness: The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`.
+                  "boostAmount": 3.14, # The value between -1 to 1 by which to boost the score if the attribute_value evaluates to the value specified above.
+                },
+              ],
+              "fieldName": "A String", # The name of the field whose value will be used to determine the boost amount.
+              "interpolationType": "A String", # The interpolation type to be applied to connect the control points listed below.
+            },
             "condition": "A String", # An expression which specifies a boost condition. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost documents with document ID "doc_1" or "doc_2", and color "Red" or "Blue": `(document_id: ANY("doc_1", "doc_2")) AND (color: ANY("Red", "Blue"))`
           },
         ],
@@ -161,6 +173,10 @@ Method Details
           "chunkInfo": { # Chunk information. # Chunk information.
             "chunk": "A String", # Chunk resource name.
             "content": "A String", # Chunk textual content.
+            "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk.
+              "title": "A String", # Title of the document.
+              "uri": "A String", # Uri of the document.
+            },
           },
           "unstructuredDocumentInfo": { # Unstructured document information. # Unstructured document information.
             "document": "A String", # Document resource name.
@@ -296,7 +312,7 @@ Method Details
                       "snippetStatus": "A String", # Status of the snippet defined by the search team.
                     },
                   ],
-                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                     "a_key": "", # Properties of the object.
                   },
                   "title": "A String", # Title.
@@ -377,7 +393,7 @@ Method Details
       { # Detailed document information associated with a user event.
         "id": "A String", # The Document resource ID.
         "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-        "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+        "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
         "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
           "A String",
         ],
@@ -509,6 +525,17 @@ Method Details
     "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifictions, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
       { # Boost applies to documents which match a condition.
         "boost": 3.14, # Strength of the condition boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the document a big promotion. However, it does not necessarily mean that the boosted document will be the top result at all times, nor that other documents will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant documents. Setting to -1.0 gives the document a big demotion. However, results that are deeply relevant might still be shown. The document will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored. Only one of the (condition, boost) combination or the boost_control_spec below are set. If both are set then the global boost is ignored and the more fine-grained boost_control_spec is applied.
+        "boostControlSpec": { # Specification for custom ranking based on customer specified attribute value. It provides more controls for customized ranking than the simple (condition, boost) combination above. # Complex specification for custom ranking based on customer defined attribute value.
+          "attributeType": "A String", # The attribute type to be used to determine the boost amount. The attribute value can be derived from the field value of the specified field_name. In the case of numerical it is straightforward i.e. attribute_value = numerical_field_value. In the case of freshness however, attribute_value = (time.now() - datetime_field_value).
+          "controlPoints": [ # The control points used to define the curve. The monotonic function (defined through the interpolation_type above) passes through the control points listed here.
+            { # The control points used to define the curve. The curve defined through these control points can only be monotonically increasing or decreasing(constant values are acceptable).
+              "attributeValue": "A String", # Can be one of: 1. The numerical field value. 2. The duration spec for freshness: The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`.
+              "boostAmount": 3.14, # The value between -1 to 1 by which to boost the score if the attribute_value evaluates to the value specified above.
+            },
+          ],
+          "fieldName": "A String", # The name of the field whose value will be used to determine the boost amount.
+          "interpolationType": "A String", # The interpolation type to be applied to connect the control points listed below.
+        },
         "condition": "A String", # An expression which specifies a boost condition. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost documents with document ID "doc_1" or "doc_2", and color "Red" or "Blue": `(document_id: ANY("doc_1", "doc_2")) AND (color: ANY("Red", "Blue"))`
       },
     ],
@@ -535,6 +562,7 @@ Method Details
     },
     "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
       "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+      "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
       "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
       "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
       "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.sessions.answers.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.sessions.answers.html
index de3a013969a..d264e64296e 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.sessions.answers.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.sessions.answers.html
@@ -91,7 +91,7 @@ Method Details
   Gets a Answer.
 
 Args:
-  name: string, Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
+  name: string, Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -191,7 +191,7 @@ Method Details
                     "snippetStatus": "A String", # Status of the snippet defined by the search team.
                   },
                 ],
-                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                   "a_key": "", # Properties of the object.
                 },
                 "title": "A String", # Title.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.sessions.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.sessions.html
index 41a2ec3b0f9..8583e559e6b 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.sessions.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.sessions.html
@@ -111,7 +111,7 @@ Method Details
   Creates a Session. If the Session to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -163,7 +163,7 @@ Method Details
   Deletes a Session. If the Session to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -181,7 +181,7 @@ Method Details
   Gets a Session.
 
 Args:
-  name: string, Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -213,7 +213,7 @@ Method Details
   Lists all Sessions by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.branches.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.branches.html
index 25b72e146db..c3fe5e35515 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.branches.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.branches.html
@@ -116,7 +116,7 @@ Method Details
         "fhirResource": "A String", # Required. Format: projects/{project}/locations/{location}/datasets/{dataset}/fhirStores/{fhir_store}/fhir/{resource_type}/{fhir_resource_id}
         "uri": "A String", # If match by URI, the URI of the Document.
       },
-      "status": "A String", # The status of the document.
+      "state": "A String", # The state of the document.
     },
   ],
 }
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.controls.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.controls.html
index 1b1801f1c71..3eee9693b11 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.controls.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.controls.html
@@ -106,7 +106,7 @@ Method Details
   Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -215,7 +215,7 @@ Method Details
   Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -233,7 +233,7 @@ Method Details
   Gets a Control.
 
 Args:
-  name: string, Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -293,7 +293,7 @@ Method Details
   Lists all Controls by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   filter: string, Optional. A filter to apply on the list results. Supported features: * List all the products under the parent branch if filter is unset. Currently this field is unsupported.
   pageSize: integer, Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, Optional. A page token, received from a previous `ListControls` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.conversations.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.conversations.html
index a87f056ecc0..c262dafbfa5 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.conversations.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.conversations.html
@@ -109,7 +109,7 @@ Method Details
   Converses a conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -118,6 +118,17 @@ Method Details
     "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifictions, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
       { # Boost applies to documents which match a condition.
         "boost": 3.14, # Strength of the condition boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the document a big promotion. However, it does not necessarily mean that the boosted document will be the top result at all times, nor that other documents will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant documents. Setting to -1.0 gives the document a big demotion. However, results that are deeply relevant might still be shown. The document will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored. Only one of the (condition, boost) combination or the boost_control_spec below are set. If both are set then the global boost is ignored and the more fine-grained boost_control_spec is applied.
+        "boostControlSpec": { # Specification for custom ranking based on customer specified attribute value. It provides more controls for customized ranking than the simple (condition, boost) combination above. # Complex specification for custom ranking based on customer defined attribute value.
+          "attributeType": "A String", # The attribute type to be used to determine the boost amount. The attribute value can be derived from the field value of the specified field_name. In the case of numerical it is straightforward i.e. attribute_value = numerical_field_value. In the case of freshness however, attribute_value = (time.now() - datetime_field_value).
+          "controlPoints": [ # The control points used to define the curve. The monotonic function (defined through the interpolation_type above) passes through the control points listed here.
+            { # The control points used to define the curve. The curve defined through these control points can only be monotonically increasing or decreasing(constant values are acceptable).
+              "attributeValue": "A String", # Can be one of: 1. The numerical field value. 2. The duration spec for freshness: The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`.
+              "boostAmount": 3.14, # The value between -1 to 1 by which to boost the score if the attribute_value evaluates to the value specified above.
+            },
+          ],
+          "fieldName": "A String", # The name of the field whose value will be used to determine the boost amount.
+          "interpolationType": "A String", # The interpolation type to be applied to connect the control points listed below.
+        },
         "condition": "A String", # An expression which specifies a boost condition. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost documents with document ID "doc_1" or "doc_2", and color "Red" or "Blue": `(document_id: ANY("doc_1", "doc_2")) AND (color: ANY("Red", "Blue"))`
       },
     ],
@@ -199,9 +210,10 @@ Method Details
     "input": "A String", # Text input.
   },
   "safeSearch": True or False, # Whether to turn on safe search.
-  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
+  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
   "summarySpec": { # A specification for configuring a summary returned in a search response. # A specification for configuring the summary returned in the response.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
     "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -414,7 +426,7 @@ Method Details
   Creates a Conversation. If the Conversation to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -566,7 +578,7 @@ Method Details
   Deletes a Conversation. If the Conversation to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -584,7 +596,7 @@ Method Details
   Gets a Conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -666,7 +678,7 @@ Method Details
   Lists all Conversations by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `conversation_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.html
index db5521e4dd5..d173609b126 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.html
@@ -232,7 +232,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -249,6 +249,9 @@ Method Details
   },
   "industryVertical": "A String", # Immutable. The industry vertical that the data store registers.
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -371,7 +374,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -388,6 +391,9 @@ Method Details
   },
   "industryVertical": "A String", # Immutable. The industry vertical that the data store registers.
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -468,7 +474,7 @@ Method Details
           },
         },
         "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-        "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+        "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
           "a_key": { # Related configurations applied to a specific type of document parser.
             "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
             },
@@ -485,6 +491,9 @@ Method Details
       },
       "industryVertical": "A String", # Immutable. The industry vertical that the data store registers.
       "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+      "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+        "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+      },
       "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
         "A String",
       ],
@@ -553,7 +562,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -570,6 +579,9 @@ Method Details
   },
   "industryVertical": "A String", # Immutable. The industry vertical that the data store registers.
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -620,7 +632,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -637,6 +649,9 @@ Method Details
   },
   "industryVertical": "A String", # Immutable. The industry vertical that the data store registers.
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.servingConfigs.html
index b464696afb4..51c20a60d0b 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.servingConfigs.html
@@ -103,6 +103,7 @@ Method Details
   "answerGenerationSpec": { # Answer generation specification. # Answer generation specification.
     "answerLanguageCode": "A String", # Language code for Answer. Use language tags defined by [BCP47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Note: This is an experimental feature.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No answer is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating answers for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true` or unset, the behavior will be determined automatically by the service.
     "ignoreNonAnswerSeekingQuery": True or False, # Specifies whether to filter out queries that are not answer-seeking. The default value is `false`. Google employs search-query classification to detect answer-seeking queries. No answer is returned if the search query is classified as a non-answer seeking query. If this field is set to `true`, we skip generating answers for non-answer seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citation metadata in the answer. The default value is `false`.
@@ -113,7 +114,7 @@ Method Details
       "preamble": "A String", # Customized preamble.
     },
   },
-  "asynchronousMode": True or False, # Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
+  "asynchronousMode": True or False, # Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
   "query": { # Defines a user inputed query. # Required. Current user query.
     "queryId": "A String", # Unique Id for the query.
     "text": "A String", # Plain text.
@@ -141,6 +142,17 @@ Method Details
         "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifictions, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
           { # Boost applies to documents which match a condition.
             "boost": 3.14, # Strength of the condition boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the document a big promotion. However, it does not necessarily mean that the boosted document will be the top result at all times, nor that other documents will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant documents. Setting to -1.0 gives the document a big demotion. However, results that are deeply relevant might still be shown. The document will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored. Only one of the (condition, boost) combination or the boost_control_spec below are set. If both are set then the global boost is ignored and the more fine-grained boost_control_spec is applied.
+            "boostControlSpec": { # Specification for custom ranking based on customer specified attribute value. It provides more controls for customized ranking than the simple (condition, boost) combination above. # Complex specification for custom ranking based on customer defined attribute value.
+              "attributeType": "A String", # The attribute type to be used to determine the boost amount. The attribute value can be derived from the field value of the specified field_name. In the case of numerical it is straightforward i.e. attribute_value = numerical_field_value. In the case of freshness however, attribute_value = (time.now() - datetime_field_value).
+              "controlPoints": [ # The control points used to define the curve. The monotonic function (defined through the interpolation_type above) passes through the control points listed here.
+                { # The control points used to define the curve. The curve defined through these control points can only be monotonically increasing or decreasing(constant values are acceptable).
+                  "attributeValue": "A String", # Can be one of: 1. The numerical field value. 2. The duration spec for freshness: The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`.
+                  "boostAmount": 3.14, # The value between -1 to 1 by which to boost the score if the attribute_value evaluates to the value specified above.
+                },
+              ],
+              "fieldName": "A String", # The name of the field whose value will be used to determine the boost amount.
+              "interpolationType": "A String", # The interpolation type to be applied to connect the control points listed below.
+            },
             "condition": "A String", # An expression which specifies a boost condition. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost documents with document ID "doc_1" or "doc_2", and color "Red" or "Blue": `(document_id: ANY("doc_1", "doc_2")) AND (color: ANY("Red", "Blue"))`
           },
         ],
@@ -161,6 +173,10 @@ Method Details
           "chunkInfo": { # Chunk information. # Chunk information.
             "chunk": "A String", # Chunk resource name.
             "content": "A String", # Chunk textual content.
+            "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk.
+              "title": "A String", # Title of the document.
+              "uri": "A String", # Uri of the document.
+            },
           },
           "unstructuredDocumentInfo": { # Unstructured document information. # Unstructured document information.
             "document": "A String", # Document resource name.
@@ -296,7 +312,7 @@ Method Details
                       "snippetStatus": "A String", # Status of the snippet defined by the search team.
                     },
                   ],
-                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                     "a_key": "", # Properties of the object.
                   },
                   "title": "A String", # Title.
@@ -377,7 +393,7 @@ Method Details
       { # Detailed document information associated with a user event.
         "id": "A String", # The Document resource ID.
         "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-        "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+        "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
         "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
           "A String",
         ],
@@ -509,6 +525,17 @@ Method Details
     "conditionBoostSpecs": [ # Condition boost specifications. If a document matches multiple conditions in the specifictions, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
       { # Boost applies to documents which match a condition.
         "boost": 3.14, # Strength of the condition boost, which should be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the document a big promotion. However, it does not necessarily mean that the boosted document will be the top result at all times, nor that other documents will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant documents. Setting to -1.0 gives the document a big demotion. However, results that are deeply relevant might still be shown. The document will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored. Only one of the (condition, boost) combination or the boost_control_spec below are set. If both are set then the global boost is ignored and the more fine-grained boost_control_spec is applied.
+        "boostControlSpec": { # Specification for custom ranking based on customer specified attribute value. It provides more controls for customized ranking than the simple (condition, boost) combination above. # Complex specification for custom ranking based on customer defined attribute value.
+          "attributeType": "A String", # The attribute type to be used to determine the boost amount. The attribute value can be derived from the field value of the specified field_name. In the case of numerical it is straightforward i.e. attribute_value = numerical_field_value. In the case of freshness however, attribute_value = (time.now() - datetime_field_value).
+          "controlPoints": [ # The control points used to define the curve. The monotonic function (defined through the interpolation_type above) passes through the control points listed here.
+            { # The control points used to define the curve. The curve defined through these control points can only be monotonically increasing or decreasing(constant values are acceptable).
+              "attributeValue": "A String", # Can be one of: 1. The numerical field value. 2. The duration spec for freshness: The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`.
+              "boostAmount": 3.14, # The value between -1 to 1 by which to boost the score if the attribute_value evaluates to the value specified above.
+            },
+          ],
+          "fieldName": "A String", # The name of the field whose value will be used to determine the boost amount.
+          "interpolationType": "A String", # The interpolation type to be applied to connect the control points listed below.
+        },
         "condition": "A String", # An expression which specifies a boost condition. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost documents with document ID "doc_1" or "doc_2", and color "Red" or "Blue": `(document_id: ANY("doc_1", "doc_2")) AND (color: ANY("Red", "Blue"))`
       },
     ],
@@ -535,6 +562,7 @@ Method Details
     },
     "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
       "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+      "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
       "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
       "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
       "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.sessions.answers.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.sessions.answers.html
index 11cf676ae3c..03932e9b8d9 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.sessions.answers.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.sessions.answers.html
@@ -91,7 +91,7 @@ Method Details
   Gets a Answer.
 
 Args:
-  name: string, Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
+  name: string, Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -191,7 +191,7 @@ Method Details
                     "snippetStatus": "A String", # Status of the snippet defined by the search team.
                   },
                 ],
-                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                   "a_key": "", # Properties of the object.
                 },
                 "title": "A String", # Title.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.sessions.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.sessions.html
index 7c44107d19e..458121440f2 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.sessions.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.sessions.html
@@ -111,7 +111,7 @@ Method Details
   Creates a Session. If the Session to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -163,7 +163,7 @@ Method Details
   Deletes a Session. If the Session to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -181,7 +181,7 @@ Method Details
   Gets a Session.
 
 Args:
-  name: string, Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -213,7 +213,7 @@ Method Details
   Lists all Sessions by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.siteSearchEngine.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.siteSearchEngine.html
index 0aaeb839ec3..fda4d3b3833 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.siteSearchEngine.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.siteSearchEngine.html
@@ -189,6 +189,7 @@ Method Details
     The object takes the form of:
 
 { # Request message for SiteSearchEngineService.RecrawlUris method.
+  "siteCredential": "A String", # Optional. Full resource name of the SiteCredential, such as `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCredentials/*`. Only set to crawl private URIs.
   "uris": [ # Required. List of URIs to crawl. At most 10K URIs are supported, otherwise an INVALID_ARGUMENT error is thrown. Each URI should match at least one TargetSite in `site_search_engine`.
     "A String",
   ],
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.userEvents.html
index 28c3bd4dcbf..4514d266772 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.userEvents.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.userEvents.html
@@ -178,7 +178,7 @@ Method Details
           { # Detailed document information associated with a user event.
             "id": "A String", # The Document resource ID.
             "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-            "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+            "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
             "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
               "A String",
             ],
@@ -270,7 +270,7 @@ Method Details
   Deletes permanently all user events specified by the filter provided. Depending on the number of events specified by the filter, this operation could take hours or days to complete. To test a filter, use the list command first.
 
 Args:
-  parent: string, Required. The resource name of the catalog under which the events are created. The format is `projects/${projectId}/locations/global/collections/{$collectionId}/dataStores/${dataStoreId}` (required)
+  parent: string, Required. The resource name of the catalog under which the events are created. The format is `projects/{project}/locations/global/collections/{collection}/dataStores/{dataStore}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -339,7 +339,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
@@ -425,7 +425,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.rankingConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.rankingConfigs.html
index 02e3420ee47..4059d71c374 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.rankingConfigs.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.rankingConfigs.html
@@ -91,7 +91,7 @@ Method Details
   Ranks a list of text records based on the given input query.
 
 Args:
-  rankingConfig: string, Required. The resource name of the rank service config, such as `projects/{project_num}/locations/{location_id}/rankingConfigs/default_ranking_config`. (required)
+  rankingConfig: string, Required. The resource name of the rank service config, such as `projects/{project_num}/locations/{location}/rankingConfigs/default_ranking_config`. (required)
   body: object, The request body.
     The object takes the form of:
 
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.userEvents.html b/docs/dyn/discoveryengine_v1.projects.locations.userEvents.html
index 6c57ca10d42..12664a7d4ba 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.userEvents.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.userEvents.html
@@ -148,7 +148,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
@@ -234,7 +234,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.html b/docs/dyn/discoveryengine_v1alpha.projects.html
index 3b357287abf..7fc5271a8ac 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.html
@@ -118,7 +118,7 @@ Method Details
 
     { # Metadata and configurations for a Google Cloud project in the service.
   "createTime": "A String", # Output only. The timestamp when this project is created.
-  "name": "A String", # Output only. Full resource name of the project, for example `projects/{project_number}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.
+  "name": "A String", # Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.
   "provisionCompletionTime": "A String", # Output only. The timestamp when this project is successfully provisioned. Empty value means this project is still provisioning and is not ready for use.
   "serviceTermsMap": { # Output only. A map of terms of services. The key is the `id` of ServiceTerms.
     "a_key": { # Metadata about the terms of service.
@@ -200,7 +200,7 @@ Method Details
 
     { # Metadata and configurations for a Google Cloud project in the service.
   "createTime": "A String", # Output only. The timestamp when this project is created.
-  "name": "A String", # Output only. Full resource name of the project, for example `projects/{project_number}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.
+  "name": "A String", # Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.
   "provisionCompletionTime": "A String", # Output only. The timestamp when this project is successfully provisioned. Empty value means this project is still provisioning and is not ready for use.
   "serviceTermsMap": { # Output only. A map of terms of services. The key is the `id` of ServiceTerms.
     "a_key": { # Metadata about the terms of service.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.html
index 543222500db..7411804104e 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.branches.html
@@ -116,7 +116,7 @@ Method Details
         "fhirResource": "A String", # Required. Format: projects/{project}/locations/{location}/datasets/{dataset}/fhirStores/{fhir_store}/fhir/{resource_type}/{fhir_resource_id}
         "uri": "A String", # If match by URI, the URI of the Document.
       },
-      "status": "A String", # The status of the document.
+      "state": "A String", # The state of the document.
     },
   ],
 }
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.controls.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.controls.html
index bc0be4976bd..fa7b779c1c4 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.controls.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.controls.html
@@ -106,7 +106,7 @@ Method Details
   Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -215,7 +215,7 @@ Method Details
   Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -233,7 +233,7 @@ Method Details
   Gets a Control.
 
 Args:
-  name: string, Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -293,7 +293,7 @@ Method Details
   Lists all Controls by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   filter: string, Optional. A filter to apply on the list results. Supported features: * List all the products under the parent branch if filter is unset. Currently this field is unsupported.
   pageSize: integer, Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, Optional. A page token, received from a previous `ListControls` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.conversations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.conversations.html
index 20572f3d272..ba8eb9e30d1 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.conversations.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.conversations.html
@@ -109,7 +109,7 @@ Method Details
   Converses a conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -219,9 +219,10 @@ Method Details
     "input": "A String", # Text input.
   },
   "safeSearch": True or False, # Whether to turn on safe search.
-  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
+  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
   "summarySpec": { # A specification for configuring a summary returned in a search response. # A specification for configuring the summary returned in the response.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
     "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -475,7 +476,7 @@ Method Details
   Creates a Conversation. If the Conversation to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -645,7 +646,7 @@ Method Details
   Deletes a Conversation. If the Conversation to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -663,7 +664,7 @@ Method Details
   Gets a Conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -754,7 +755,7 @@ Method Details
   Lists all Conversations by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `conversation_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.customModels.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.customModels.html
index ac184bff44a..4b08b953552 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.customModels.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.customModels.html
@@ -110,7 +110,7 @@ Method Details
       },
       "modelState": "A String", # The state that the model is in (e.g.`TRAINING` or `TRAINING_FAILED`).
       "modelVersion": "A String", # The version of the model.
-      "name": "A String", # Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}` model must be an alpha-numerical string with limit of 40 characters.
+      "name": "A String", # Required. The fully qualified resource name of the model. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}`. Model must be an alpha-numerical string with limit of 40 characters.
       "trainingStartTime": "A String", # Timestamp the model training was initiated.
     },
   ],
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.html
index 55ae09957fe..3bd508e76f0 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.html
@@ -247,7 +247,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -276,6 +276,12 @@ Method Details
     "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
   },
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+    "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+  },
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -418,7 +424,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -447,6 +453,12 @@ Method Details
     "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
   },
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+    "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+  },
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -488,7 +500,7 @@ Method Details
   Gets a DocumentProcessingConfig.
 
 Args:
-  name: string, Required. Full DocumentProcessingConfig resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/documentProcessingConfig` (required)
+  name: string, Required. Full DocumentProcessingConfig resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/documentProcessingConfig` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -517,7 +529,7 @@ Method Details
     },
   },
   "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-  "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+  "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
     "a_key": { # Related configurations applied to a specific type of document parser.
       "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
       },
@@ -598,7 +610,7 @@ Method Details
           },
         },
         "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-        "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+        "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
           "a_key": { # Related configurations applied to a specific type of document parser.
             "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
             },
@@ -627,6 +639,12 @@ Method Details
         "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
       },
       "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+      "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+        "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+      },
+      "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+        "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+      },
       "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
         "A String",
       ],
@@ -715,7 +733,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -744,6 +762,12 @@ Method Details
     "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
   },
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+    "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+  },
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -814,7 +838,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -843,6 +867,12 @@ Method Details
     "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
   },
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+    "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+  },
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -960,7 +990,7 @@ Method Details
     },
   },
   "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-  "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+  "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
     "a_key": { # Related configurations applied to a specific type of document parser.
       "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
       },
@@ -1005,7 +1035,7 @@ Method Details
     },
   },
   "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-  "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+  "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
     "a_key": { # Related configurations applied to a specific type of document parser.
       "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
       },
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html
index 983c0ae5ffd..c479368f9fc 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.servingConfigs.html
@@ -115,6 +115,7 @@ Method Details
   "answerGenerationSpec": { # Answer generation specification. # Answer generation specification.
     "answerLanguageCode": "A String", # Language code for Answer. Use language tags defined by [BCP47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Note: This is an experimental feature.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No answer is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating answers for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true` or unset, the behavior will be determined automatically by the service.
     "ignoreNonAnswerSeekingQuery": True or False, # Specifies whether to filter out queries that are not answer-seeking. The default value is `false`. Google employs search-query classification to detect answer-seeking queries. No answer is returned if the search query is classified as a non-answer seeking query. If this field is set to `true`, we skip generating answers for non-answer seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citation metadata in the answer. The default value is `false`.
@@ -125,7 +126,7 @@ Method Details
       "preamble": "A String", # Customized preamble.
     },
   },
-  "asynchronousMode": True or False, # Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
+  "asynchronousMode": True or False, # Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
   "query": { # Defines a user inputed query. # Required. Current user query.
     "queryId": "A String", # Unique Id for the query.
     "text": "A String", # Plain text.
@@ -187,6 +188,10 @@ Method Details
           "chunkInfo": { # Chunk information. # Chunk information.
             "chunk": "A String", # Chunk resource name.
             "content": "A String", # Chunk textual content.
+            "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk.
+              "title": "A String", # Title of the document.
+              "uri": "A String", # Uri of the document.
+            },
           },
           "unstructuredDocumentInfo": { # Unstructured document information. # Unstructured document information.
             "document": "A String", # Document resource name.
@@ -322,7 +327,7 @@ Method Details
                       "snippetStatus": "A String", # Status of the snippet defined by the search team.
                     },
                   ],
-                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                     "a_key": "", # Properties of the object.
                   },
                   "title": "A String", # Title.
@@ -371,7 +376,7 @@ Method Details
   Gets a ServingConfig. Returns a NotFound error if the ServingConfig does not exist.
 
 Args:
-  name: string, Required. The resource name of the ServingConfig to get. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}` (required)
+  name: string, Required. The resource name of the ServingConfig to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -420,6 +425,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -474,7 +480,7 @@ Method Details
   Lists all ServingConfigs linked to this dataStore.
 
 Args:
-  parent: string, Required. Full resource name of the parent resource. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` (required)
+  parent: string, Required. Full resource name of the parent resource. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` (required)
   pageSize: integer, Optional. Maximum number of results to return. If unspecified, defaults to 100. If a value greater than 100 is provided, at most 100 results are returned.
   pageToken: string, Optional. A page token, received from a previous `ListServingConfigs` call. Provide this to retrieve the subsequent page.
   x__xgafv: string, V1 error format.
@@ -528,6 +534,7 @@ Method Details
           },
           "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
             "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+            "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
             "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
             "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
             "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -642,6 +649,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -739,6 +747,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -825,7 +834,7 @@ Method Details
       { # Detailed document information associated with a user event.
         "id": "A String", # The Document resource ID.
         "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-        "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+        "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
         "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
           "A String",
         ],
@@ -1007,6 +1016,7 @@ Method Details
     },
     "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
       "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+      "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
       "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
       "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
       "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.sessions.answers.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.sessions.answers.html
index 2bd0239c2ce..0c8c986aff6 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.sessions.answers.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.sessions.answers.html
@@ -91,7 +91,7 @@ Method Details
   Gets a Answer.
 
 Args:
-  name: string, Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
+  name: string, Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -191,7 +191,7 @@ Method Details
                     "snippetStatus": "A String", # Status of the snippet defined by the search team.
                   },
                 ],
-                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                   "a_key": "", # Properties of the object.
                 },
                 "title": "A String", # Title.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.sessions.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.sessions.html
index 153f0e81a61..1b9b186514b 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.sessions.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.sessions.html
@@ -111,7 +111,7 @@ Method Details
   Creates a Session. If the Session to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -163,7 +163,7 @@ Method Details
   Deletes a Session. If the Session to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -181,7 +181,7 @@ Method Details
   Gets a Session.
 
 Args:
-  name: string, Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -213,7 +213,7 @@ Method Details
   Lists all Sessions by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.html
index e19dee476ac..ef6d9736bc3 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.siteSearchEngine.html
@@ -330,6 +330,7 @@ Method Details
     The object takes the form of:
 
 { # Request message for SiteSearchEngineService.RecrawlUris method.
+  "siteCredential": "A String", # Optional. Full resource name of the SiteCredential, such as `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCredentials/*`. Only set to crawl private URIs.
   "uris": [ # Required. List of URIs to crawl. At most 10K URIs are supported, otherwise an INVALID_ARGUMENT error is thrown. Each URI should match at least one TargetSite in `site_search_engine`.
     "A String",
   ],
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.userEvents.html
index 6f0fca63a88..7fa24585584 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.userEvents.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.userEvents.html
@@ -178,7 +178,7 @@ Method Details
           { # Detailed document information associated with a user event.
             "id": "A String", # The Document resource ID.
             "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-            "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+            "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
             "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
               "A String",
             ],
@@ -270,7 +270,7 @@ Method Details
   Deletes permanently all user events specified by the filter provided. Depending on the number of events specified by the filter, this operation could take hours or days to complete. To test a filter, use the list command first.
 
 Args:
-  parent: string, Required. The resource name of the catalog under which the events are created. The format is `projects/${projectId}/locations/global/collections/{$collectionId}/dataStores/${dataStoreId}` (required)
+  parent: string, Required. The resource name of the catalog under which the events are created. The format is `projects/{project}/locations/global/collections/{collection}/dataStores/{dataStore}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -339,7 +339,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
@@ -425,7 +425,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.controls.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.controls.html
index f15c2084294..055d0210947 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.controls.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.controls.html
@@ -106,7 +106,7 @@ Method Details
   Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -215,7 +215,7 @@ Method Details
   Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -233,7 +233,7 @@ Method Details
   Gets a Control.
 
 Args:
-  name: string, Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -293,7 +293,7 @@ Method Details
   Lists all Controls by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   filter: string, Optional. A filter to apply on the list results. Supported features: * List all the products under the parent branch if filter is unset. Currently this field is unsupported.
   pageSize: integer, Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, Optional. A page token, received from a previous `ListControls` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.conversations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.conversations.html
index e7ac1d6f2d4..34a2e36d8b0 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.conversations.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.conversations.html
@@ -109,7 +109,7 @@ Method Details
   Converses a conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -219,9 +219,10 @@ Method Details
     "input": "A String", # Text input.
   },
   "safeSearch": True or False, # Whether to turn on safe search.
-  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
+  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
   "summarySpec": { # A specification for configuring a summary returned in a search response. # A specification for configuring the summary returned in the response.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
     "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -475,7 +476,7 @@ Method Details
   Creates a Conversation. If the Conversation to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -645,7 +646,7 @@ Method Details
   Deletes a Conversation. If the Conversation to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -663,7 +664,7 @@ Method Details
   Gets a Conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -754,7 +755,7 @@ Method Details
   Lists all Conversations by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `conversation_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.html
index e74ee7a8288..d2c332a5442 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.html
@@ -175,7 +175,7 @@ Method Details
     "trainingState": "A String", # The training state that the engine is in (e.g. `TRAINING` or `PAUSED`). Since part of the cost of running the service is frequency of training - this can be used to determine when to train engine in order to control cost. If not specified: the default value for `CreateEngine` method is `TRAINING`. The default value for `UpdateEngine` method is to keep the state the same as before.
     "type": "A String", # Required. The type of engine. e.g., `recommended-for-you`. This field together with optimization_objective describe engine metadata to use to control engine training and serving. Currently supported values: `recommended-for-you`, `others-you-may-like`, `more-like-this`, `most-popular-items`.
   },
-  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
   "recommendationMetadata": { # Additional information of a recommendation engine. # Output only. Additional information of a recommendation engine. Only applicable if solution_type is SOLUTION_TYPE_RECOMMENDATION.
     "dataState": "A String", # Output only. The state of data requirements for this engine: `DATA_OK` and `DATA_ERROR`. Engine cannot be trained if the data is in `DATA_ERROR` state. Engine can have `DATA_ERROR` state even if serving state is `ACTIVE`: engines were trained successfully before, but cannot be refreshed because the underlying engine no longer has sufficient data for training.
     "lastTuneTime": "A String", # Output only. The timestamp when the latest successful tune finished. Only applicable on Media Recommendation engines.
@@ -304,7 +304,7 @@ Method Details
     "trainingState": "A String", # The training state that the engine is in (e.g. `TRAINING` or `PAUSED`). Since part of the cost of running the service is frequency of training - this can be used to determine when to train engine in order to control cost. If not specified: the default value for `CreateEngine` method is `TRAINING`. The default value for `UpdateEngine` method is to keep the state the same as before.
     "type": "A String", # Required. The type of engine. e.g., `recommended-for-you`. This field together with optimization_objective describe engine metadata to use to control engine training and serving. Currently supported values: `recommended-for-you`, `others-you-may-like`, `more-like-this`, `most-popular-items`.
   },
-  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
   "recommendationMetadata": { # Additional information of a recommendation engine. # Output only. Additional information of a recommendation engine. Only applicable if solution_type is SOLUTION_TYPE_RECOMMENDATION.
     "dataState": "A String", # Output only. The state of data requirements for this engine: `DATA_OK` and `DATA_ERROR`. Engine cannot be trained if the data is in `DATA_ERROR` state. Engine can have `DATA_ERROR` state even if serving state is `ACTIVE`: engines were trained successfully before, but cannot be refreshed because the underlying engine no longer has sufficient data for training.
     "lastTuneTime": "A String", # Output only. The timestamp when the latest successful tune finished. Only applicable on Media Recommendation engines.
@@ -374,7 +374,7 @@ Method Details
         "trainingState": "A String", # The training state that the engine is in (e.g. `TRAINING` or `PAUSED`). Since part of the cost of running the service is frequency of training - this can be used to determine when to train engine in order to control cost. If not specified: the default value for `CreateEngine` method is `TRAINING`. The default value for `UpdateEngine` method is to keep the state the same as before.
         "type": "A String", # Required. The type of engine. e.g., `recommended-for-you`. This field together with optimization_objective describe engine metadata to use to control engine training and serving. Currently supported values: `recommended-for-you`, `others-you-may-like`, `more-like-this`, `most-popular-items`.
       },
-      "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+      "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
       "recommendationMetadata": { # Additional information of a recommendation engine. # Output only. Additional information of a recommendation engine. Only applicable if solution_type is SOLUTION_TYPE_RECOMMENDATION.
         "dataState": "A String", # Output only. The state of data requirements for this engine: `DATA_OK` and `DATA_ERROR`. Engine cannot be trained if the data is in `DATA_ERROR` state. Engine can have `DATA_ERROR` state even if serving state is `ACTIVE`: engines were trained successfully before, but cannot be refreshed because the underlying engine no longer has sufficient data for training.
         "lastTuneTime": "A String", # Output only. The timestamp when the latest successful tune finished. Only applicable on Media Recommendation engines.
@@ -416,7 +416,7 @@ Method Details
   Updates an Engine
 
 Args:
-  name: string, Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned. (required)
+  name: string, Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -451,7 +451,7 @@ Method Details
     "trainingState": "A String", # The training state that the engine is in (e.g. `TRAINING` or `PAUSED`). Since part of the cost of running the service is frequency of training - this can be used to determine when to train engine in order to control cost. If not specified: the default value for `CreateEngine` method is `TRAINING`. The default value for `UpdateEngine` method is to keep the state the same as before.
     "type": "A String", # Required. The type of engine. e.g., `recommended-for-you`. This field together with optimization_objective describe engine metadata to use to control engine training and serving. Currently supported values: `recommended-for-you`, `others-you-may-like`, `more-like-this`, `most-popular-items`.
   },
-  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
   "recommendationMetadata": { # Additional information of a recommendation engine. # Output only. Additional information of a recommendation engine. Only applicable if solution_type is SOLUTION_TYPE_RECOMMENDATION.
     "dataState": "A String", # Output only. The state of data requirements for this engine: `DATA_OK` and `DATA_ERROR`. Engine cannot be trained if the data is in `DATA_ERROR` state. Engine can have `DATA_ERROR` state even if serving state is `ACTIVE`: engines were trained successfully before, but cannot be refreshed because the underlying engine no longer has sufficient data for training.
     "lastTuneTime": "A String", # Output only. The timestamp when the latest successful tune finished. Only applicable on Media Recommendation engines.
@@ -510,7 +510,7 @@ Method Details
     "trainingState": "A String", # The training state that the engine is in (e.g. `TRAINING` or `PAUSED`). Since part of the cost of running the service is frequency of training - this can be used to determine when to train engine in order to control cost. If not specified: the default value for `CreateEngine` method is `TRAINING`. The default value for `UpdateEngine` method is to keep the state the same as before.
     "type": "A String", # Required. The type of engine. e.g., `recommended-for-you`. This field together with optimization_objective describe engine metadata to use to control engine training and serving. Currently supported values: `recommended-for-you`, `others-you-may-like`, `more-like-this`, `most-popular-items`.
   },
-  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
   "recommendationMetadata": { # Additional information of a recommendation engine. # Output only. Additional information of a recommendation engine. Only applicable if solution_type is SOLUTION_TYPE_RECOMMENDATION.
     "dataState": "A String", # Output only. The state of data requirements for this engine: `DATA_OK` and `DATA_ERROR`. Engine cannot be trained if the data is in `DATA_ERROR` state. Engine can have `DATA_ERROR` state even if serving state is `ACTIVE`: engines were trained successfully before, but cannot be refreshed because the underlying engine no longer has sufficient data for training.
     "lastTuneTime": "A String", # Output only. The timestamp when the latest successful tune finished. Only applicable on Media Recommendation engines.
@@ -535,7 +535,7 @@ Method Details
   Pauses the training of an existing engine. Only applicable if SolutionType is SOLUTION_TYPE_RECOMMENDATION.
 
 Args:
-  name: string, Required. The name of the engine to pause. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}` (required)
+  name: string, Required. The name of the engine to pause. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -581,7 +581,7 @@ Method Details
     "trainingState": "A String", # The training state that the engine is in (e.g. `TRAINING` or `PAUSED`). Since part of the cost of running the service is frequency of training - this can be used to determine when to train engine in order to control cost. If not specified: the default value for `CreateEngine` method is `TRAINING`. The default value for `UpdateEngine` method is to keep the state the same as before.
     "type": "A String", # Required. The type of engine. e.g., `recommended-for-you`. This field together with optimization_objective describe engine metadata to use to control engine training and serving. Currently supported values: `recommended-for-you`, `others-you-may-like`, `more-like-this`, `most-popular-items`.
   },
-  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
   "recommendationMetadata": { # Additional information of a recommendation engine. # Output only. Additional information of a recommendation engine. Only applicable if solution_type is SOLUTION_TYPE_RECOMMENDATION.
     "dataState": "A String", # Output only. The state of data requirements for this engine: `DATA_OK` and `DATA_ERROR`. Engine cannot be trained if the data is in `DATA_ERROR` state. Engine can have `DATA_ERROR` state even if serving state is `ACTIVE`: engines were trained successfully before, but cannot be refreshed because the underlying engine no longer has sufficient data for training.
     "lastTuneTime": "A String", # Output only. The timestamp when the latest successful tune finished. Only applicable on Media Recommendation engines.
@@ -606,7 +606,7 @@ Method Details
   Resumes the training of an existing engine. Only applicable if SolutionType is SOLUTION_TYPE_RECOMMENDATION.
 
 Args:
-  name: string, Required. The name of the engine to resume. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}` (required)
+  name: string, Required. The name of the engine to resume. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -652,7 +652,7 @@ Method Details
     "trainingState": "A String", # The training state that the engine is in (e.g. `TRAINING` or `PAUSED`). Since part of the cost of running the service is frequency of training - this can be used to determine when to train engine in order to control cost. If not specified: the default value for `CreateEngine` method is `TRAINING`. The default value for `UpdateEngine` method is to keep the state the same as before.
     "type": "A String", # Required. The type of engine. e.g., `recommended-for-you`. This field together with optimization_objective describe engine metadata to use to control engine training and serving. Currently supported values: `recommended-for-you`, `others-you-may-like`, `more-like-this`, `most-popular-items`.
   },
-  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
   "recommendationMetadata": { # Additional information of a recommendation engine. # Output only. Additional information of a recommendation engine. Only applicable if solution_type is SOLUTION_TYPE_RECOMMENDATION.
     "dataState": "A String", # Output only. The state of data requirements for this engine: `DATA_OK` and `DATA_ERROR`. Engine cannot be trained if the data is in `DATA_ERROR` state. Engine can have `DATA_ERROR` state even if serving state is `ACTIVE`: engines were trained successfully before, but cannot be refreshed because the underlying engine no longer has sufficient data for training.
     "lastTuneTime": "A String", # Output only. The timestamp when the latest successful tune finished. Only applicable on Media Recommendation engines.
@@ -677,7 +677,7 @@ Method Details
   Tunes an existing engine. Only applicable if SolutionType is SOLUTION_TYPE_RECOMMENDATION.
 
 Args:
-  name: string, Required. The resource name of the engine to tune. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}` (required)
+  name: string, Required. The resource name of the engine to tune. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.servingConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.servingConfigs.html
index c99900a73ab..e1c22293288 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.servingConfigs.html
@@ -115,6 +115,7 @@ Method Details
   "answerGenerationSpec": { # Answer generation specification. # Answer generation specification.
     "answerLanguageCode": "A String", # Language code for Answer. Use language tags defined by [BCP47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Note: This is an experimental feature.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No answer is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating answers for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true` or unset, the behavior will be determined automatically by the service.
     "ignoreNonAnswerSeekingQuery": True or False, # Specifies whether to filter out queries that are not answer-seeking. The default value is `false`. Google employs search-query classification to detect answer-seeking queries. No answer is returned if the search query is classified as a non-answer seeking query. If this field is set to `true`, we skip generating answers for non-answer seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citation metadata in the answer. The default value is `false`.
@@ -125,7 +126,7 @@ Method Details
       "preamble": "A String", # Customized preamble.
     },
   },
-  "asynchronousMode": True or False, # Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
+  "asynchronousMode": True or False, # Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
   "query": { # Defines a user inputed query. # Required. Current user query.
     "queryId": "A String", # Unique Id for the query.
     "text": "A String", # Plain text.
@@ -187,6 +188,10 @@ Method Details
           "chunkInfo": { # Chunk information. # Chunk information.
             "chunk": "A String", # Chunk resource name.
             "content": "A String", # Chunk textual content.
+            "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk.
+              "title": "A String", # Title of the document.
+              "uri": "A String", # Uri of the document.
+            },
           },
           "unstructuredDocumentInfo": { # Unstructured document information. # Unstructured document information.
             "document": "A String", # Document resource name.
@@ -322,7 +327,7 @@ Method Details
                       "snippetStatus": "A String", # Status of the snippet defined by the search team.
                     },
                   ],
-                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                     "a_key": "", # Properties of the object.
                   },
                   "title": "A String", # Title.
@@ -371,7 +376,7 @@ Method Details
   Gets a ServingConfig. Returns a NotFound error if the ServingConfig does not exist.
 
 Args:
-  name: string, Required. The resource name of the ServingConfig to get. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}` (required)
+  name: string, Required. The resource name of the ServingConfig to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -420,6 +425,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -474,7 +480,7 @@ Method Details
   Lists all ServingConfigs linked to this dataStore.
 
 Args:
-  parent: string, Required. Full resource name of the parent resource. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` (required)
+  parent: string, Required. Full resource name of the parent resource. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` (required)
   pageSize: integer, Optional. Maximum number of results to return. If unspecified, defaults to 100. If a value greater than 100 is provided, at most 100 results are returned.
   pageToken: string, Optional. A page token, received from a previous `ListServingConfigs` call. Provide this to retrieve the subsequent page.
   x__xgafv: string, V1 error format.
@@ -528,6 +534,7 @@ Method Details
           },
           "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
             "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+            "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
             "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
             "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
             "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -642,6 +649,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -739,6 +747,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -825,7 +834,7 @@ Method Details
       { # Detailed document information associated with a user event.
         "id": "A String", # The Document resource ID.
         "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-        "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+        "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
         "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
           "A String",
         ],
@@ -1007,6 +1016,7 @@ Method Details
     },
     "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
       "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+      "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
       "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
       "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
       "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.answers.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.answers.html
index 5c333c5766a..0ab913ee1a6 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.answers.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.answers.html
@@ -91,7 +91,7 @@ Method Details
   Gets a Answer.
 
 Args:
-  name: string, Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
+  name: string, Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -191,7 +191,7 @@ Method Details
                     "snippetStatus": "A String", # Status of the snippet defined by the search team.
                   },
                 ],
-                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                   "a_key": "", # Properties of the object.
                 },
                 "title": "A String", # Title.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.html
index 8b00d343b5e..721ad9ff4ee 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.html
@@ -111,7 +111,7 @@ Method Details
   Creates a Session. If the Session to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -163,7 +163,7 @@ Method Details
   Deletes a Session. If the Session to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -181,7 +181,7 @@ Method Details
   Gets a Session.
 
 Args:
-  name: string, Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -213,7 +213,7 @@ Method Details
   Lists all Sessions by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.html
index 5d371b81240..b37e7c35a81 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.branches.html
@@ -116,7 +116,7 @@ Method Details
         "fhirResource": "A String", # Required. Format: projects/{project}/locations/{location}/datasets/{dataset}/fhirStores/{fhir_store}/fhir/{resource_type}/{fhir_resource_id}
         "uri": "A String", # If match by URI, the URI of the Document.
       },
-      "status": "A String", # The status of the document.
+      "state": "A String", # The state of the document.
     },
   ],
 }
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.controls.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.controls.html
index bceedd99fc8..c60fd059846 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.controls.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.controls.html
@@ -106,7 +106,7 @@ Method Details
   Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -215,7 +215,7 @@ Method Details
   Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -233,7 +233,7 @@ Method Details
   Gets a Control.
 
 Args:
-  name: string, Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -293,7 +293,7 @@ Method Details
   Lists all Controls by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   filter: string, Optional. A filter to apply on the list results. Supported features: * List all the products under the parent branch if filter is unset. Currently this field is unsupported.
   pageSize: integer, Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, Optional. A page token, received from a previous `ListControls` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.conversations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.conversations.html
index d4ca17a2f97..21aa8821c76 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.conversations.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.conversations.html
@@ -109,7 +109,7 @@ Method Details
   Converses a conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -219,9 +219,10 @@ Method Details
     "input": "A String", # Text input.
   },
   "safeSearch": True or False, # Whether to turn on safe search.
-  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
+  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
   "summarySpec": { # A specification for configuring a summary returned in a search response. # A specification for configuring the summary returned in the response.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
     "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -475,7 +476,7 @@ Method Details
   Creates a Conversation. If the Conversation to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -645,7 +646,7 @@ Method Details
   Deletes a Conversation. If the Conversation to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -663,7 +664,7 @@ Method Details
   Gets a Conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -754,7 +755,7 @@ Method Details
   Lists all Conversations by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `conversation_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.html
index a89d5bb5200..35b5e01cba8 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.html
@@ -239,7 +239,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -268,6 +268,12 @@ Method Details
     "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
   },
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+    "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+  },
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -410,7 +416,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -439,6 +445,12 @@ Method Details
     "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
   },
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+    "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+  },
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -480,7 +492,7 @@ Method Details
   Gets a DocumentProcessingConfig.
 
 Args:
-  name: string, Required. Full DocumentProcessingConfig resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/documentProcessingConfig` (required)
+  name: string, Required. Full DocumentProcessingConfig resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/documentProcessingConfig` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -509,7 +521,7 @@ Method Details
     },
   },
   "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-  "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+  "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
     "a_key": { # Related configurations applied to a specific type of document parser.
       "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
       },
@@ -590,7 +602,7 @@ Method Details
           },
         },
         "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-        "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+        "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
           "a_key": { # Related configurations applied to a specific type of document parser.
             "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
             },
@@ -619,6 +631,12 @@ Method Details
         "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
       },
       "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+      "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+        "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+      },
+      "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+        "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+      },
       "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
         "A String",
       ],
@@ -707,7 +725,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -736,6 +754,12 @@ Method Details
     "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
   },
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+    "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+  },
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -806,7 +830,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -835,6 +859,12 @@ Method Details
     "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
   },
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+    "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+  },
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -900,7 +930,7 @@ Method Details
     },
   },
   "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-  "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+  "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
     "a_key": { # Related configurations applied to a specific type of document parser.
       "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
       },
@@ -945,7 +975,7 @@ Method Details
     },
   },
   "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-  "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+  "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
     "a_key": { # Related configurations applied to a specific type of document parser.
       "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
       },
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html
index 04cf7e6a1d8..507c9293be0 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.servingConfigs.html
@@ -115,6 +115,7 @@ Method Details
   "answerGenerationSpec": { # Answer generation specification. # Answer generation specification.
     "answerLanguageCode": "A String", # Language code for Answer. Use language tags defined by [BCP47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Note: This is an experimental feature.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No answer is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating answers for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true` or unset, the behavior will be determined automatically by the service.
     "ignoreNonAnswerSeekingQuery": True or False, # Specifies whether to filter out queries that are not answer-seeking. The default value is `false`. Google employs search-query classification to detect answer-seeking queries. No answer is returned if the search query is classified as a non-answer seeking query. If this field is set to `true`, we skip generating answers for non-answer seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citation metadata in the answer. The default value is `false`.
@@ -125,7 +126,7 @@ Method Details
       "preamble": "A String", # Customized preamble.
     },
   },
-  "asynchronousMode": True or False, # Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
+  "asynchronousMode": True or False, # Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
   "query": { # Defines a user inputed query. # Required. Current user query.
     "queryId": "A String", # Unique Id for the query.
     "text": "A String", # Plain text.
@@ -187,6 +188,10 @@ Method Details
           "chunkInfo": { # Chunk information. # Chunk information.
             "chunk": "A String", # Chunk resource name.
             "content": "A String", # Chunk textual content.
+            "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk.
+              "title": "A String", # Title of the document.
+              "uri": "A String", # Uri of the document.
+            },
           },
           "unstructuredDocumentInfo": { # Unstructured document information. # Unstructured document information.
             "document": "A String", # Document resource name.
@@ -322,7 +327,7 @@ Method Details
                       "snippetStatus": "A String", # Status of the snippet defined by the search team.
                     },
                   ],
-                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                     "a_key": "", # Properties of the object.
                   },
                   "title": "A String", # Title.
@@ -371,7 +376,7 @@ Method Details
   Gets a ServingConfig. Returns a NotFound error if the ServingConfig does not exist.
 
 Args:
-  name: string, Required. The resource name of the ServingConfig to get. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}` (required)
+  name: string, Required. The resource name of the ServingConfig to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -420,6 +425,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -474,7 +480,7 @@ Method Details
   Lists all ServingConfigs linked to this dataStore.
 
 Args:
-  parent: string, Required. Full resource name of the parent resource. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` (required)
+  parent: string, Required. Full resource name of the parent resource. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` (required)
   pageSize: integer, Optional. Maximum number of results to return. If unspecified, defaults to 100. If a value greater than 100 is provided, at most 100 results are returned.
   pageToken: string, Optional. A page token, received from a previous `ListServingConfigs` call. Provide this to retrieve the subsequent page.
   x__xgafv: string, V1 error format.
@@ -528,6 +534,7 @@ Method Details
           },
           "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
             "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+            "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
             "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
             "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
             "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -642,6 +649,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -739,6 +747,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -825,7 +834,7 @@ Method Details
       { # Detailed document information associated with a user event.
         "id": "A String", # The Document resource ID.
         "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-        "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+        "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
         "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
           "A String",
         ],
@@ -1007,6 +1016,7 @@ Method Details
     },
     "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
       "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+      "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
       "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
       "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
       "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.sessions.answers.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.sessions.answers.html
index 10489e34019..abb9c008125 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.sessions.answers.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.sessions.answers.html
@@ -91,7 +91,7 @@ Method Details
   Gets a Answer.
 
 Args:
-  name: string, Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
+  name: string, Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -191,7 +191,7 @@ Method Details
                     "snippetStatus": "A String", # Status of the snippet defined by the search team.
                   },
                 ],
-                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                   "a_key": "", # Properties of the object.
                 },
                 "title": "A String", # Title.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.sessions.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.sessions.html
index 1f065870beb..146b03b4731 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.sessions.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.sessions.html
@@ -111,7 +111,7 @@ Method Details
   Creates a Session. If the Session to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -163,7 +163,7 @@ Method Details
   Deletes a Session. If the Session to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -181,7 +181,7 @@ Method Details
   Gets a Session.
 
 Args:
-  name: string, Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -213,7 +213,7 @@ Method Details
   Lists all Sessions by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.siteSearchEngine.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.siteSearchEngine.html
index 97d0f6cc3e6..b24d1c601eb 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.siteSearchEngine.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.siteSearchEngine.html
@@ -189,6 +189,7 @@ Method Details
     The object takes the form of:
 
 { # Request message for SiteSearchEngineService.RecrawlUris method.
+  "siteCredential": "A String", # Optional. Full resource name of the SiteCredential, such as `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCredentials/*`. Only set to crawl private URIs.
   "uris": [ # Required. List of URIs to crawl. At most 10K URIs are supported, otherwise an INVALID_ARGUMENT error is thrown. Each URI should match at least one TargetSite in `site_search_engine`.
     "A String",
   ],
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.userEvents.html
index 33f036e732f..774181f50dc 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.userEvents.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.userEvents.html
@@ -178,7 +178,7 @@ Method Details
           { # Detailed document information associated with a user event.
             "id": "A String", # The Document resource ID.
             "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-            "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+            "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
             "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
               "A String",
             ],
@@ -270,7 +270,7 @@ Method Details
   Deletes permanently all user events specified by the filter provided. Depending on the number of events specified by the filter, this operation could take hours or days to complete. To test a filter, use the list command first.
 
 Args:
-  parent: string, Required. The resource name of the catalog under which the events are created. The format is `projects/${projectId}/locations/global/collections/{$collectionId}/dataStores/${dataStoreId}` (required)
+  parent: string, Required. The resource name of the catalog under which the events are created. The format is `projects/{project}/locations/global/collections/{collection}/dataStores/{dataStore}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -339,7 +339,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
@@ -425,7 +425,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html
index 733c2b136cd..703a72711f2 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.evaluations.html
@@ -184,6 +184,7 @@ Method Details
         },
         "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
           "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+          "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
           "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
           "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
           "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -444,6 +445,7 @@ Method Details
         },
         "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
           "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+          "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
           "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
           "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
           "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -680,6 +682,7 @@ Method Details
             },
             "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
               "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+              "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
               "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
               "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
               "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.rankingConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.rankingConfigs.html
index 9e3abab27f0..1cc67fa6b79 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.rankingConfigs.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.rankingConfigs.html
@@ -91,7 +91,7 @@ Method Details
   Ranks a list of text records based on the given input query.
 
 Args:
-  rankingConfig: string, Required. The resource name of the rank service config, such as `projects/{project_num}/locations/{location_id}/rankingConfigs/default_ranking_config`. (required)
+  rankingConfig: string, Required. The resource name of the rank service config, such as `projects/{project_num}/locations/{location}/rankingConfigs/default_ranking_config`. (required)
   body: object, The request body.
     The object takes the form of:
 
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.userEvents.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.userEvents.html
index 4c9d59bd7a3..0b393055b49 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.userEvents.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.userEvents.html
@@ -148,7 +148,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
@@ -234,7 +234,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.branches.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.branches.html
index 643a9f05d55..169fd438c0c 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.branches.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.branches.html
@@ -116,7 +116,7 @@ Method Details
         "fhirResource": "A String", # Required. Format: projects/{project}/locations/{location}/datasets/{dataset}/fhirStores/{fhir_store}/fhir/{resource_type}/{fhir_resource_id}
         "uri": "A String", # If match by URI, the URI of the Document.
       },
-      "status": "A String", # The status of the document.
+      "state": "A String", # The state of the document.
     },
   ],
 }
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.controls.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.controls.html
index 0a4e8c7d88e..01019e7df8a 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.controls.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.controls.html
@@ -106,7 +106,7 @@ Method Details
   Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -215,7 +215,7 @@ Method Details
   Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -233,7 +233,7 @@ Method Details
   Gets a Control.
 
 Args:
-  name: string, Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -293,7 +293,7 @@ Method Details
   Lists all Controls by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   filter: string, Optional. A filter to apply on the list results. Supported features: * List all the products under the parent branch if filter is unset. Currently this field is unsupported.
   pageSize: integer, Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, Optional. A page token, received from a previous `ListControls` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.conversations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.conversations.html
index 4fffd88a309..7c60d18c5e1 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.conversations.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.conversations.html
@@ -109,7 +109,7 @@ Method Details
   Converses a conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -219,9 +219,10 @@ Method Details
     "input": "A String", # Text input.
   },
   "safeSearch": True or False, # Whether to turn on safe search.
-  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
+  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
   "summarySpec": { # A specification for configuring a summary returned in a search response. # A specification for configuring the summary returned in the response.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
     "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -462,7 +463,7 @@ Method Details
   Creates a Conversation. If the Conversation to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -632,7 +633,7 @@ Method Details
   Deletes a Conversation. If the Conversation to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -650,7 +651,7 @@ Method Details
   Gets a Conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -741,7 +742,7 @@ Method Details
   Lists all Conversations by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `conversation_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.customModels.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.customModels.html
index 827e6e92e8b..cd55149d9a5 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.customModels.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.customModels.html
@@ -110,7 +110,7 @@ Method Details
       },
       "modelState": "A String", # The state that the model is in (e.g.`TRAINING` or `TRAINING_FAILED`).
       "modelVersion": "A String", # The version of the model.
-      "name": "A String", # Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}` model must be an alpha-numerical string with limit of 40 characters.
+      "name": "A String", # Required. The fully qualified resource name of the model. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}`. Model must be an alpha-numerical string with limit of 40 characters.
       "trainingStartTime": "A String", # Timestamp the model training was initiated.
     },
   ],
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.html
index 745a3f27da5..acb1b642f1b 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.html
@@ -240,7 +240,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -263,6 +263,12 @@ Method Details
     "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
   },
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+    "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+  },
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -385,7 +391,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -408,6 +414,12 @@ Method Details
     "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
   },
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+    "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+  },
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -488,7 +500,7 @@ Method Details
           },
         },
         "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-        "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+        "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
           "a_key": { # Related configurations applied to a specific type of document parser.
             "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
             },
@@ -511,6 +523,12 @@ Method Details
         "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
       },
       "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+      "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+        "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+      },
+      "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+        "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+      },
       "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
         "A String",
       ],
@@ -579,7 +597,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -602,6 +620,12 @@ Method Details
     "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
   },
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+    "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+  },
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -652,7 +676,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -675,6 +699,12 @@ Method Details
     "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
   },
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+    "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+  },
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.servingConfigs.html
index 87ba37f47f6..c366e8a6fe4 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.servingConfigs.html
@@ -115,6 +115,7 @@ Method Details
   "answerGenerationSpec": { # Answer generation specification. # Answer generation specification.
     "answerLanguageCode": "A String", # Language code for Answer. Use language tags defined by [BCP47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Note: This is an experimental feature.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No answer is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating answers for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true` or unset, the behavior will be determined automatically by the service.
     "ignoreNonAnswerSeekingQuery": True or False, # Specifies whether to filter out queries that are not answer-seeking. The default value is `false`. Google employs search-query classification to detect answer-seeking queries. No answer is returned if the search query is classified as a non-answer seeking query. If this field is set to `true`, we skip generating answers for non-answer seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citation metadata in the answer. The default value is `false`.
@@ -125,7 +126,7 @@ Method Details
       "preamble": "A String", # Customized preamble.
     },
   },
-  "asynchronousMode": True or False, # Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
+  "asynchronousMode": True or False, # Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
   "query": { # Defines a user inputed query. # Required. Current user query.
     "queryId": "A String", # Unique Id for the query.
     "text": "A String", # Plain text.
@@ -184,6 +185,10 @@ Method Details
           "chunkInfo": { # Chunk information. # Chunk information.
             "chunk": "A String", # Chunk resource name.
             "content": "A String", # Chunk textual content.
+            "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk.
+              "title": "A String", # Title of the document.
+              "uri": "A String", # Uri of the document.
+            },
           },
           "unstructuredDocumentInfo": { # Unstructured document information. # Unstructured document information.
             "document": "A String", # Document resource name.
@@ -319,7 +324,7 @@ Method Details
                       "snippetStatus": "A String", # Status of the snippet defined by the search team.
                     },
                   ],
-                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                     "a_key": "", # Properties of the object.
                   },
                   "title": "A String", # Title.
@@ -368,7 +373,7 @@ Method Details
   Gets a ServingConfig. Returns a NotFound error if the ServingConfig does not exist.
 
 Args:
-  name: string, Required. The resource name of the ServingConfig to get. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}` (required)
+  name: string, Required. The resource name of the ServingConfig to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -414,6 +419,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -463,7 +469,7 @@ Method Details
   Lists all ServingConfigs linked to this dataStore.
 
 Args:
-  parent: string, Required. Full resource name of the parent resource. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` (required)
+  parent: string, Required. Full resource name of the parent resource. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` (required)
   pageSize: integer, Optional. Maximum number of results to return. If unspecified, defaults to 100. If a value greater than 100 is provided, at most 100 results are returned.
   pageToken: string, Optional. A page token, received from a previous `ListServingConfigs` call. Provide this to retrieve the subsequent page.
   x__xgafv: string, V1 error format.
@@ -514,6 +520,7 @@ Method Details
           },
           "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
             "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+            "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
             "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
             "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
             "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -620,6 +627,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -709,6 +717,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -790,7 +799,7 @@ Method Details
       { # Detailed document information associated with a user event.
         "id": "A String", # The Document resource ID.
         "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-        "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+        "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
         "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
           "A String",
         ],
@@ -959,6 +968,7 @@ Method Details
     },
     "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
       "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+      "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
       "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
       "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
       "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.sessions.answers.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.sessions.answers.html
index 9acc36badec..c6776533368 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.sessions.answers.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.sessions.answers.html
@@ -91,7 +91,7 @@ Method Details
   Gets a Answer.
 
 Args:
-  name: string, Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
+  name: string, Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -191,7 +191,7 @@ Method Details
                     "snippetStatus": "A String", # Status of the snippet defined by the search team.
                   },
                 ],
-                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                   "a_key": "", # Properties of the object.
                 },
                 "title": "A String", # Title.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.sessions.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.sessions.html
index 22cd87f01f5..8325627648e 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.sessions.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.sessions.html
@@ -111,7 +111,7 @@ Method Details
   Creates a Session. If the Session to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -163,7 +163,7 @@ Method Details
   Deletes a Session. If the Session to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -181,7 +181,7 @@ Method Details
   Gets a Session.
 
 Args:
-  name: string, Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -213,7 +213,7 @@ Method Details
   Lists all Sessions by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.html
index 0082c890d86..aa6ae36cd57 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.siteSearchEngine.html
@@ -301,6 +301,7 @@ Method Details
     The object takes the form of:
 
 { # Request message for SiteSearchEngineService.RecrawlUris method.
+  "siteCredential": "A String", # Optional. Full resource name of the SiteCredential, such as `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCredentials/*`. Only set to crawl private URIs.
   "uris": [ # Required. List of URIs to crawl. At most 10K URIs are supported, otherwise an INVALID_ARGUMENT error is thrown. Each URI should match at least one TargetSite in `site_search_engine`.
     "A String",
   ],
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.userEvents.html
index fd768429f1e..c54c8641854 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.userEvents.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.userEvents.html
@@ -178,7 +178,7 @@ Method Details
           { # Detailed document information associated with a user event.
             "id": "A String", # The Document resource ID.
             "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-            "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+            "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
             "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
               "A String",
             ],
@@ -270,7 +270,7 @@ Method Details
   Deletes permanently all user events specified by the filter provided. Depending on the number of events specified by the filter, this operation could take hours or days to complete. To test a filter, use the list command first.
 
 Args:
-  parent: string, Required. The resource name of the catalog under which the events are created. The format is `projects/${projectId}/locations/global/collections/{$collectionId}/dataStores/${dataStoreId}` (required)
+  parent: string, Required. The resource name of the catalog under which the events are created. The format is `projects/{project}/locations/global/collections/{collection}/dataStores/{dataStore}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -339,7 +339,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
@@ -425,7 +425,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.controls.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.controls.html
index 06cc50dc1d9..7544d710ed9 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.controls.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.controls.html
@@ -106,7 +106,7 @@ Method Details
   Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -215,7 +215,7 @@ Method Details
   Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -233,7 +233,7 @@ Method Details
   Gets a Control.
 
 Args:
-  name: string, Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -293,7 +293,7 @@ Method Details
   Lists all Controls by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   filter: string, Optional. A filter to apply on the list results. Supported features: * List all the products under the parent branch if filter is unset. Currently this field is unsupported.
   pageSize: integer, Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, Optional. A page token, received from a previous `ListControls` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.conversations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.conversations.html
index 0195db939e9..2275ac9383a 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.conversations.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.conversations.html
@@ -109,7 +109,7 @@ Method Details
   Converses a conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -219,9 +219,10 @@ Method Details
     "input": "A String", # Text input.
   },
   "safeSearch": True or False, # Whether to turn on safe search.
-  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
+  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
   "summarySpec": { # A specification for configuring a summary returned in a search response. # A specification for configuring the summary returned in the response.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
     "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -462,7 +463,7 @@ Method Details
   Creates a Conversation. If the Conversation to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -632,7 +633,7 @@ Method Details
   Deletes a Conversation. If the Conversation to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -650,7 +651,7 @@ Method Details
   Gets a Conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -741,7 +742,7 @@ Method Details
   Lists all Conversations by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `conversation_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.html
index de237054496..5abd1dab652 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.html
@@ -166,7 +166,7 @@ Method Details
   ],
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
   "industryVertical": "A String", # The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine.
-  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
   "searchEngineConfig": { # Configurations for a Search Engine. # Configurations for the Search Engine. Only applicable if solution_type is SOLUTION_TYPE_SEARCH.
     "searchAddOns": [ # The add-on that this search engine enables.
       "A String",
@@ -278,7 +278,7 @@ Method Details
   ],
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
   "industryVertical": "A String", # The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine.
-  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
   "searchEngineConfig": { # Configurations for a Search Engine. # Configurations for the Search Engine. Only applicable if solution_type is SOLUTION_TYPE_SEARCH.
     "searchAddOns": [ # The add-on that this search engine enables.
       "A String",
@@ -331,7 +331,7 @@ Method Details
       ],
       "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
       "industryVertical": "A String", # The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine.
-      "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+      "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
       "searchEngineConfig": { # Configurations for a Search Engine. # Configurations for the Search Engine. Only applicable if solution_type is SOLUTION_TYPE_SEARCH.
         "searchAddOns": [ # The add-on that this search engine enables.
           "A String",
@@ -365,7 +365,7 @@ Method Details
   Updates an Engine
 
 Args:
-  name: string, Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned. (required)
+  name: string, Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -391,7 +391,7 @@ Method Details
   ],
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
   "industryVertical": "A String", # The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine.
-  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
   "searchEngineConfig": { # Configurations for a Search Engine. # Configurations for the Search Engine. Only applicable if solution_type is SOLUTION_TYPE_SEARCH.
     "searchAddOns": [ # The add-on that this search engine enables.
       "A String",
@@ -433,7 +433,7 @@ Method Details
   ],
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
   "industryVertical": "A String", # The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine.
-  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
   "searchEngineConfig": { # Configurations for a Search Engine. # Configurations for the Search Engine. Only applicable if solution_type is SOLUTION_TYPE_SEARCH.
     "searchAddOns": [ # The add-on that this search engine enables.
       "A String",
@@ -450,7 +450,7 @@ Method Details
   Pauses the training of an existing engine. Only applicable if SolutionType is SOLUTION_TYPE_RECOMMENDATION.
 
 Args:
-  name: string, Required. The name of the engine to pause. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}` (required)
+  name: string, Required. The name of the engine to pause. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -487,7 +487,7 @@ Method Details
   ],
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
   "industryVertical": "A String", # The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine.
-  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
   "searchEngineConfig": { # Configurations for a Search Engine. # Configurations for the Search Engine. Only applicable if solution_type is SOLUTION_TYPE_SEARCH.
     "searchAddOns": [ # The add-on that this search engine enables.
       "A String",
@@ -504,7 +504,7 @@ Method Details
   Resumes the training of an existing engine. Only applicable if SolutionType is SOLUTION_TYPE_RECOMMENDATION.
 
 Args:
-  name: string, Required. The name of the engine to resume. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}` (required)
+  name: string, Required. The name of the engine to resume. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -541,7 +541,7 @@ Method Details
   ],
   "displayName": "A String", # Required. The display name of the engine. Should be human readable. UTF-8 encoded string with limit of 1024 characters.
   "industryVertical": "A String", # The industry vertical that the engine registers. The restriction of the Engine industry vertical is based on DataStore: If unspecified, default to `GENERIC`. Vertical on Engine has to match vertical of the DataStore linked to the engine.
-  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
+  "name": "A String", # Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.
   "searchEngineConfig": { # Configurations for a Search Engine. # Configurations for the Search Engine. Only applicable if solution_type is SOLUTION_TYPE_SEARCH.
     "searchAddOns": [ # The add-on that this search engine enables.
       "A String",
@@ -558,7 +558,7 @@ Method Details
   Tunes an existing engine. Only applicable if SolutionType is SOLUTION_TYPE_RECOMMENDATION.
 
 Args:
-  name: string, Required. The resource name of the engine to tune. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}` (required)
+  name: string, Required. The resource name of the engine to tune. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.servingConfigs.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.servingConfigs.html
index 16454bd3976..24f4d249c77 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.servingConfigs.html
@@ -115,6 +115,7 @@ Method Details
   "answerGenerationSpec": { # Answer generation specification. # Answer generation specification.
     "answerLanguageCode": "A String", # Language code for Answer. Use language tags defined by [BCP47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Note: This is an experimental feature.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No answer is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating answers for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true` or unset, the behavior will be determined automatically by the service.
     "ignoreNonAnswerSeekingQuery": True or False, # Specifies whether to filter out queries that are not answer-seeking. The default value is `false`. Google employs search-query classification to detect answer-seeking queries. No answer is returned if the search query is classified as a non-answer seeking query. If this field is set to `true`, we skip generating answers for non-answer seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citation metadata in the answer. The default value is `false`.
@@ -125,7 +126,7 @@ Method Details
       "preamble": "A String", # Customized preamble.
     },
   },
-  "asynchronousMode": True or False, # Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
+  "asynchronousMode": True or False, # Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
   "query": { # Defines a user inputed query. # Required. Current user query.
     "queryId": "A String", # Unique Id for the query.
     "text": "A String", # Plain text.
@@ -184,6 +185,10 @@ Method Details
           "chunkInfo": { # Chunk information. # Chunk information.
             "chunk": "A String", # Chunk resource name.
             "content": "A String", # Chunk textual content.
+            "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk.
+              "title": "A String", # Title of the document.
+              "uri": "A String", # Uri of the document.
+            },
           },
           "unstructuredDocumentInfo": { # Unstructured document information. # Unstructured document information.
             "document": "A String", # Document resource name.
@@ -319,7 +324,7 @@ Method Details
                       "snippetStatus": "A String", # Status of the snippet defined by the search team.
                     },
                   ],
-                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                     "a_key": "", # Properties of the object.
                   },
                   "title": "A String", # Title.
@@ -368,7 +373,7 @@ Method Details
   Gets a ServingConfig. Returns a NotFound error if the ServingConfig does not exist.
 
 Args:
-  name: string, Required. The resource name of the ServingConfig to get. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}` (required)
+  name: string, Required. The resource name of the ServingConfig to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -414,6 +419,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -463,7 +469,7 @@ Method Details
   Lists all ServingConfigs linked to this dataStore.
 
 Args:
-  parent: string, Required. Full resource name of the parent resource. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` (required)
+  parent: string, Required. Full resource name of the parent resource. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` (required)
   pageSize: integer, Optional. Maximum number of results to return. If unspecified, defaults to 100. If a value greater than 100 is provided, at most 100 results are returned.
   pageToken: string, Optional. A page token, received from a previous `ListServingConfigs` call. Provide this to retrieve the subsequent page.
   x__xgafv: string, V1 error format.
@@ -514,6 +520,7 @@ Method Details
           },
           "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
             "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+            "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
             "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
             "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
             "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -620,6 +627,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -709,6 +717,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -790,7 +799,7 @@ Method Details
       { # Detailed document information associated with a user event.
         "id": "A String", # The Document resource ID.
         "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-        "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+        "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
         "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
           "A String",
         ],
@@ -959,6 +968,7 @@ Method Details
     },
     "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
       "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+      "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
       "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
       "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
       "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.sessions.answers.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.sessions.answers.html
index 04e67084dc8..f26297521d2 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.sessions.answers.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.sessions.answers.html
@@ -91,7 +91,7 @@ Method Details
   Gets a Answer.
 
 Args:
-  name: string, Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
+  name: string, Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -191,7 +191,7 @@ Method Details
                     "snippetStatus": "A String", # Status of the snippet defined by the search team.
                   },
                 ],
-                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                   "a_key": "", # Properties of the object.
                 },
                 "title": "A String", # Title.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.sessions.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.sessions.html
index 9f041b0f633..57c14bd8e0d 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.sessions.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.sessions.html
@@ -111,7 +111,7 @@ Method Details
   Creates a Session. If the Session to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -163,7 +163,7 @@ Method Details
   Deletes a Session. If the Session to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -181,7 +181,7 @@ Method Details
   Gets a Session.
 
 Args:
-  name: string, Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -213,7 +213,7 @@ Method Details
   Lists all Sessions by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.branches.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.branches.html
index 4c751e966c8..4f7fa514c21 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.branches.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.branches.html
@@ -116,7 +116,7 @@ Method Details
         "fhirResource": "A String", # Required. Format: projects/{project}/locations/{location}/datasets/{dataset}/fhirStores/{fhir_store}/fhir/{resource_type}/{fhir_resource_id}
         "uri": "A String", # If match by URI, the URI of the Document.
       },
-      "status": "A String", # The status of the document.
+      "state": "A String", # The state of the document.
     },
   ],
 }
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.controls.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.controls.html
index 71ed29e99f0..1315af4b9ef 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.controls.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.controls.html
@@ -106,7 +106,7 @@ Method Details
   Creates a Control. By default 1000 controls are allowed for a data store. A request can be submitted to adjust this limit. If the Control to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -215,7 +215,7 @@ Method Details
   Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -233,7 +233,7 @@ Method Details
   Gets a Control.
 
 Args:
-  name: string, Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
+  name: string, Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -293,7 +293,7 @@ Method Details
   Lists all Controls by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`. (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`. (required)
   filter: string, Optional. A filter to apply on the list results. Supported features: * List all the products under the parent branch if filter is unset. Currently this field is unsupported.
   pageSize: integer, Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, Optional. A page token, received from a previous `ListControls` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.conversations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.conversations.html
index 987287ec389..2655ed3fa8c 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.conversations.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.conversations.html
@@ -109,7 +109,7 @@ Method Details
   Converses a conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -219,9 +219,10 @@ Method Details
     "input": "A String", # Text input.
   },
   "safeSearch": True or False, # Whether to turn on safe search.
-  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
+  "servingConfig": "A String", # The resource name of the Serving Config to use. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.
   "summarySpec": { # A specification for configuring a summary returned in a search response. # A specification for configuring the summary returned in the response.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
     "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -462,7 +463,7 @@ Method Details
   Creates a Conversation. If the Conversation to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -632,7 +633,7 @@ Method Details
   Deletes a Conversation. If the Conversation to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -650,7 +651,7 @@ Method Details
   Gets a Conversation.
 
 Args:
-  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
+  name: string, Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -741,7 +742,7 @@ Method Details
   Lists all Conversations by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `conversation_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.html
index 2e4435a2ac6..00186aac779 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.html
@@ -232,7 +232,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -255,6 +255,12 @@ Method Details
     "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
   },
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+    "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+  },
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -377,7 +383,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -400,6 +406,12 @@ Method Details
     "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
   },
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+    "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+  },
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -480,7 +492,7 @@ Method Details
           },
         },
         "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-        "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+        "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
           "a_key": { # Related configurations applied to a specific type of document parser.
             "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
             },
@@ -503,6 +515,12 @@ Method Details
         "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
       },
       "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+      "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+        "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+      },
+      "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+        "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+      },
       "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
         "A String",
       ],
@@ -571,7 +589,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -594,6 +612,12 @@ Method Details
     "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
   },
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+    "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+  },
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
@@ -644,7 +668,7 @@ Method Details
       },
     },
     "name": "A String", # The full resource name of the Document Processing Config. Format: `projects/*/locations/*/collections/*/dataStores/*/documentProcessingConfig`.
-    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
+    "parsingConfigOverrides": { # Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.
       "a_key": { # Related configurations applied to a specific type of document parser.
         "digitalParsingConfig": { # The digital parsing configurations for documents. # Configurations applied to digital parser.
         },
@@ -667,6 +691,12 @@ Method Details
     "region": "A String", # Output only. Region part of normalized_language_code, if present. E.g.: `en-US` -> `US`, `zh-Hans-HK` -> `HK`, `en` -> ``.
   },
   "name": "A String", # Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+  "naturalLanguageQueryUnderstandingConfig": { # Configuration for Natural Language Query Understanding. # Optional. Configuration for Natural Language Query Understanding.
+    "mode": "A String", # Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.
+  },
+  "servingConfigDataStore": { # Stores information regarding the serving configurations at DataStore level. # Optional. Stores serving config at DataStore level.
+    "disabledForServing": True or False, # If set true, the DataStore will not be available for serving search requests.
+  },
   "solutionTypes": [ # The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.
     "A String",
   ],
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html
index e3d0ac9e609..47f8ec5d65a 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.servingConfigs.html
@@ -115,6 +115,7 @@ Method Details
   "answerGenerationSpec": { # Answer generation specification. # Answer generation specification.
     "answerLanguageCode": "A String", # Language code for Answer. Use language tags defined by [BCP47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). Note: This is an experimental feature.
     "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No answer is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating answers for adversarial queries and return fallback messages instead.
+    "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
     "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true` or unset, the behavior will be determined automatically by the service.
     "ignoreNonAnswerSeekingQuery": True or False, # Specifies whether to filter out queries that are not answer-seeking. The default value is `false`. Google employs search-query classification to detect answer-seeking queries. No answer is returned if the search query is classified as a non-answer seeking query. If this field is set to `true`, we skip generating answers for non-answer seeking queries and return fallback messages instead.
     "includeCitations": True or False, # Specifies whether to include citation metadata in the answer. The default value is `false`.
@@ -125,7 +126,7 @@ Method Details
       "preamble": "A String", # Customized preamble.
     },
   },
-  "asynchronousMode": True or False, # Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
+  "asynchronousMode": True or False, # Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.
   "query": { # Defines a user inputed query. # Required. Current user query.
     "queryId": "A String", # Unique Id for the query.
     "text": "A String", # Plain text.
@@ -184,6 +185,10 @@ Method Details
           "chunkInfo": { # Chunk information. # Chunk information.
             "chunk": "A String", # Chunk resource name.
             "content": "A String", # Chunk textual content.
+            "documentMetadata": { # Document metadata contains the information of the document of the current chunk. # Metadata of the document from the current chunk.
+              "title": "A String", # Title of the document.
+              "uri": "A String", # Uri of the document.
+            },
           },
           "unstructuredDocumentInfo": { # Unstructured document information. # Unstructured document information.
             "document": "A String", # Document resource name.
@@ -319,7 +324,7 @@ Method Details
                       "snippetStatus": "A String", # Status of the snippet defined by the search team.
                     },
                   ],
-                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                  "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                     "a_key": "", # Properties of the object.
                   },
                   "title": "A String", # Title.
@@ -368,7 +373,7 @@ Method Details
   Gets a ServingConfig. Returns a NotFound error if the ServingConfig does not exist.
 
 Args:
-  name: string, Required. The resource name of the ServingConfig to get. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}` (required)
+  name: string, Required. The resource name of the ServingConfig to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -414,6 +419,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -463,7 +469,7 @@ Method Details
   Lists all ServingConfigs linked to this dataStore.
 
 Args:
-  parent: string, Required. Full resource name of the parent resource. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` (required)
+  parent: string, Required. Full resource name of the parent resource. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` (required)
   pageSize: integer, Optional. Maximum number of results to return. If unspecified, defaults to 100. If a value greater than 100 is provided, at most 100 results are returned.
   pageToken: string, Optional. A page token, received from a previous `ListServingConfigs` call. Provide this to retrieve the subsequent page.
   x__xgafv: string, V1 error format.
@@ -514,6 +520,7 @@ Method Details
           },
           "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
             "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+            "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
             "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
             "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
             "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -620,6 +627,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -709,6 +717,7 @@ Method Details
       },
       "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
         "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+        "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
         "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
         "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
         "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -790,7 +799,7 @@ Method Details
       { # Detailed document information associated with a user event.
         "id": "A String", # The Document resource ID.
         "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-        "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+        "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
         "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
           "A String",
         ],
@@ -959,6 +968,7 @@ Method Details
     },
     "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
       "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+      "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
       "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
       "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
       "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.sessions.answers.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.sessions.answers.html
index faa3c6e79aa..4f90079c558 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.sessions.answers.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.sessions.answers.html
@@ -91,7 +91,7 @@ Method Details
   Gets a Answer.
 
 Args:
-  name: string, Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
+  name: string, Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -191,7 +191,7 @@ Method Details
                     "snippetStatus": "A String", # Status of the snippet defined by the search team.
                   },
                 ],
-                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .
+                "structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .
                   "a_key": "", # Properties of the object.
                 },
                 "title": "A String", # Title.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.sessions.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.sessions.html
index 5ef6a8ddb52..193b71df24f 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.sessions.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.sessions.html
@@ -111,7 +111,7 @@ Method Details
   Creates a Session. If the Session to create already exists, an ALREADY_EXISTS error is returned.
 
 Args:
-  parent: string, Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -163,7 +163,7 @@ Method Details
   Deletes a Session. If the Session to delete does not exist, a NOT_FOUND error is returned.
 
 Args:
-  name: string, Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -181,7 +181,7 @@ Method Details
   Gets a Session.
 
 Args:
-  name: string, Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
+  name: string, Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}` (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -213,7 +213,7 @@ Method Details
   Lists all Sessions by their parent DataStore.
 
 Args:
-  parent: string, Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}` (required)
+  parent: string, Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}` (required)
   filter: string, A filter to apply on the list results. The supported features are: user_pseudo_id, state. Example: "user_pseudo_id = some_id"
   orderBy: string, A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. Supported fields: * `update_time` * `create_time` * `session_name` Example: "update_time desc" "create_time"
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.siteSearchEngine.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.siteSearchEngine.html
index e174b09a083..580b86f5c43 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.siteSearchEngine.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.siteSearchEngine.html
@@ -189,6 +189,7 @@ Method Details
     The object takes the form of:
 
 { # Request message for SiteSearchEngineService.RecrawlUris method.
+  "siteCredential": "A String", # Optional. Full resource name of the SiteCredential, such as `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCredentials/*`. Only set to crawl private URIs.
   "uris": [ # Required. List of URIs to crawl. At most 10K URIs are supported, otherwise an INVALID_ARGUMENT error is thrown. Each URI should match at least one TargetSite in `site_search_engine`.
     "A String",
   ],
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.userEvents.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.userEvents.html
index 2072aa6f462..961c4c7ccb2 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.userEvents.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.userEvents.html
@@ -178,7 +178,7 @@ Method Details
           { # Detailed document information associated with a user event.
             "id": "A String", # The Document resource ID.
             "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-            "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+            "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
             "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
               "A String",
             ],
@@ -270,7 +270,7 @@ Method Details
   Deletes permanently all user events specified by the filter provided. Depending on the number of events specified by the filter, this operation could take hours or days to complete. To test a filter, use the list command first.
 
 Args:
-  parent: string, Required. The resource name of the catalog under which the events are created. The format is `projects/${projectId}/locations/global/collections/{$collectionId}/dataStores/${dataStoreId}` (required)
+  parent: string, Required. The resource name of the catalog under which the events are created. The format is `projects/{project}/locations/global/collections/{collection}/dataStores/{dataStore}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -339,7 +339,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
@@ -425,7 +425,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html
index deeedcac997..1d05534fde2 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.evaluations.html
@@ -184,6 +184,7 @@ Method Details
         },
         "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
           "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+          "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
           "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
           "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
           "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -441,6 +442,7 @@ Method Details
         },
         "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
           "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+          "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
           "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
           "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
           "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
@@ -674,6 +676,7 @@ Method Details
             },
             "summarySpec": { # A specification for configuring a summary returned in a search response. # If `summarySpec` is not specified, summaries are not included in the search response.
               "ignoreAdversarialQuery": True or False, # Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.
+              "ignoreJailBreakingQuery": True or False, # Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. "Reply in the tone of a competing company's CEO". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.
               "ignoreLowRelevantContent": True or False, # Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.
               "ignoreNonSummarySeekingQuery": True or False, # Specifies whether to filter out queries that are not summary-seeking. The default value is `false`. Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example, `why is the sky blue` and `Who is the best soccer player in the world?` are summary-seeking queries, but `SFO airport` and `world cup 2026` are not. They are most likely navigational queries. If this field is set to `true`, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
               "includeCitations": True or False, # Specifies whether to include citations in the summary. The default value is `false`. When this field is set to `true`, summaries include in-line citation numbers. Example summary including citations: BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3]. The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.rankingConfigs.html b/docs/dyn/discoveryengine_v1beta.projects.locations.rankingConfigs.html
index e2a966e2e32..278a1f025f4 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.rankingConfigs.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.rankingConfigs.html
@@ -91,7 +91,7 @@ Method Details
   Ranks a list of text records based on the given input query.
 
 Args:
-  rankingConfig: string, Required. The resource name of the rank service config, such as `projects/{project_num}/locations/{location_id}/rankingConfigs/default_ranking_config`. (required)
+  rankingConfig: string, Required. The resource name of the rank service config, such as `projects/{project_num}/locations/{location}/rankingConfigs/default_ranking_config`. (required)
   body: object, The request body.
     The object takes the form of:
 
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.userEvents.html b/docs/dyn/discoveryengine_v1beta.projects.locations.userEvents.html
index 19a916dcc10..172b2c0d42e 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.userEvents.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.userEvents.html
@@ -148,7 +148,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
@@ -234,7 +234,7 @@ Method Details
     { # Detailed document information associated with a user event.
       "id": "A String", # The Document resource ID.
       "joined": True or False, # Output only. Whether the referenced Document can be found in the data store.
-      "name": "A String", # The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
+      "name": "A String", # The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`
       "promotionIds": [ # The promotion IDs associated with this Document. Currently, this field is restricted to at most one ID.
         "A String",
       ],
diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1.json
index fa892da6c8a..f07168b2039 100644
--- a/googleapiclient/discovery_cache/documents/discoveryengine.v1.json
+++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1.json
@@ -14,7 +14,7 @@
 "canonicalName": "Discovery Engine",
 "description": "Discovery Engine API.",
 "discoveryVersion": "v1",
-"documentationLink": "https://cloud.google.com/discovery-engine/docs",
+"documentationLink": "https://cloud.google.com/generative-ai-app-builder/docs/",
 "fullyEncodeReservedExpansion": true,
 "icons": {
 "x16": "http://www.google.com/images/icons/product/search-16.gif",
@@ -921,7 +921,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -949,7 +949,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/controls/[^/]+$",
 "required": true,
@@ -974,7 +974,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/controls/[^/]+$",
 "required": true,
@@ -1015,7 +1015,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -1078,7 +1078,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -1106,7 +1106,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -1134,7 +1134,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -1159,7 +1159,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -1205,7 +1205,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -1757,7 +1757,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -1785,7 +1785,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -1810,7 +1810,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -1856,7 +1856,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -1919,7 +1919,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
+"description": "Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/sessions/[^/]+/answers/[^/]+$",
 "required": true,
@@ -2549,7 +2549,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The resource name of the catalog under which the events are created. The format is `projects/${projectId}/locations/global/collections/{$collectionId}/dataStores/${dataStoreId}`",
+"description": "Required. The resource name of the catalog under which the events are created. The format is `projects/{project}/locations/global/collections/{collection}/dataStores/{dataStore}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -2740,7 +2740,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
+"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -2783,7 +2783,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -2811,7 +2811,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/controls/[^/]+$",
 "required": true,
@@ -2836,7 +2836,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/controls/[^/]+$",
 "required": true,
@@ -2877,7 +2877,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -2940,7 +2940,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -2968,7 +2968,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -2996,7 +2996,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -3021,7 +3021,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -3067,7 +3067,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3288,7 +3288,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3316,7 +3316,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -3341,7 +3341,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -3387,7 +3387,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3450,7 +3450,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
+"description": "Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/sessions/[^/]+/answers/[^/]+$",
 "required": true,
@@ -4221,7 +4221,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -4249,7 +4249,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/controls/[^/]+$",
 "required": true,
@@ -4274,7 +4274,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/controls/[^/]+$",
 "required": true,
@@ -4315,7 +4315,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -4378,7 +4378,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -4406,7 +4406,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -4434,7 +4434,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -4459,7 +4459,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -4505,7 +4505,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -4956,7 +4956,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -4984,7 +4984,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -5009,7 +5009,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -5055,7 +5055,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -5118,7 +5118,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
+"description": "Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/sessions/[^/]+/answers/[^/]+$",
 "required": true,
@@ -5542,7 +5542,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The resource name of the catalog under which the events are created. The format is `projects/${projectId}/locations/global/collections/{$collectionId}/dataStores/${dataStoreId}`",
+"description": "Required. The resource name of the catalog under which the events are created. The format is `projects/{project}/locations/global/collections/{collection}/dataStores/{dataStore}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -5785,7 +5785,7 @@
 ],
 "parameters": {
 "rankingConfig": {
-"description": "Required. The resource name of the rank service config, such as `projects/{project_num}/locations/{location_id}/rankingConfigs/default_ranking_config`.",
+"description": "Required. The resource name of the rank service config, such as `projects/{project_num}/locations/{location}/rankingConfigs/default_ranking_config`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/rankingConfigs/[^/]+$",
 "required": true,
@@ -5986,7 +5986,7 @@
 }
 }
 },
-"revision": "20240829",
+"revision": "20240906",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiHttpBody": {
@@ -6314,7 +6314,8 @@
 "description": "Answer generation specification."
 },
 "asynchronousMode": {
-"description": "Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.",
+"deprecated": true,
+"description": "Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.",
 "type": "boolean"
 },
 "query": {
@@ -6367,6 +6368,10 @@
 "description": "Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No answer is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating answers for adversarial queries and return fallback messages instead.",
 "type": "boolean"
 },
+"ignoreJailBreakingQuery": {
+"description": "Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. \"Reply in the tone of a competing company's CEO\". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.",
+"type": "boolean"
+},
 "ignoreLowRelevantContent": {
 "description": "Specifies whether to filter out queries that have low relevance. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true` or unset, the behavior will be determined automatically by the service.",
 "type": "boolean"
@@ -6593,6 +6598,25 @@
 "content": {
 "description": "Chunk textual content.",
 "type": "string"
+},
+"documentMetadata": {
+"$ref": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfoDocumentMetadata",
+"description": "Metadata of the document from the current chunk."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfoDocumentMetadata": {
+"description": "Document metadata contains the information of the document of the current chunk.",
+"id": "GoogleCloudDiscoveryengineV1AnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfoDocumentMetadata",
+"properties": {
+"title": {
+"description": "Title of the document.",
+"type": "string"
+},
+"uri": {
+"description": "Uri of the document.",
+"type": "string"
 }
 },
 "type": "object"
@@ -6984,7 +7008,7 @@
 "description": "Properties of the object.",
 "type": "any"
 },
-"description": "Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .",
+"description": "Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .",
 "type": "object"
 },
 "title": {
@@ -7120,13 +7144,13 @@
 "$ref": "GoogleCloudDiscoveryengineV1BatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue",
 "description": "The value of the matcher that was used to match the Document."
 },
-"status": {
-"description": "The status of the document.",
+"state": {
+"description": "The state of the document.",
 "enum": [
-"STATUS_UNSPECIFIED",
-"STATUS_INDEXED",
-"STATUS_NOT_IN_TARGET_SITE",
-"STATUS_NOT_IN_INDEX"
+"STATE_UNSPECIFIED",
+"INDEXED",
+"NOT_IN_TARGET_SITE",
+"NOT_IN_INDEX"
 ],
 "enumDescriptions": [
 "Should never be set.",
@@ -7980,7 +8004,7 @@
 "type": "boolean"
 },
 "servingConfig": {
-"description": "The resource name of the Serving Config to use. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.",
+"description": "The resource name of the Serving Config to use. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.",
 "type": "string"
 },
 "summarySpec": {
@@ -8176,7 +8200,7 @@
 "type": "string"
 },
 "name": {
-"description": "Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}` model must be an alpha-numerical string with limit of 40 characters.",
+"description": "Required. The fully qualified resource name of the model. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}`. Model must be an alpha-numerical string with limit of 40 characters.",
 "type": "string"
 },
 "trainingStartTime": {
@@ -8248,6 +8272,10 @@
 "description": "Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.",
 "type": "string"
 },
+"servingConfigDataStore": {
+"$ref": "GoogleCloudDiscoveryengineV1ServingConfigDataStore",
+"description": "Optional. Stores serving config at DataStore level."
+},
 "solutionTypes": {
 "description": "The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.",
 "items": {
@@ -8489,7 +8517,7 @@
 "type": "boolean"
 },
 "name": {
-"description": "The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`",
+"description": "The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`",
 "type": "string"
 },
 "promotionIds": {
@@ -8531,7 +8559,7 @@
 "additionalProperties": {
 "$ref": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfig"
 },
-"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
+"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
 "type": "object"
 }
 },
@@ -8694,7 +8722,7 @@
 "type": "string"
 },
 "name": {
-"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
+"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
 "type": "string"
 },
 "searchEngineConfig": {
@@ -9614,7 +9642,7 @@
 "type": "string"
 },
 "name": {
-"description": "Output only. Full resource name of the project, for example `projects/{project_number}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
+"description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
 "readOnly": true,
 "type": "string"
 },
@@ -10082,6 +10110,10 @@
 "description": "Request message for SiteSearchEngineService.RecrawlUris method.",
 "id": "GoogleCloudDiscoveryengineV1RecrawlUrisRequest",
 "properties": {
+"siteCredential": {
+"description": "Optional. Full resource name of the SiteCredential, such as `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCredentials/*`. Only set to crawl private URIs.",
+"type": "string"
+},
 "uris": {
 "description": "Required. List of URIs to crawl. At most 10K URIs are supported, otherwise an INVALID_ARGUMENT error is thrown. Each URI should match at least one TargetSite in `site_search_engine`.",
 "items": {
@@ -10286,6 +10318,10 @@
 "format": "float",
 "type": "number"
 },
+"boostControlSpec": {
+"$ref": "GoogleCloudDiscoveryengineV1SearchRequestBoostSpecConditionBoostSpecBoostControlSpec",
+"description": "Complex specification for custom ranking based on customer defined attribute value."
+},
 "condition": {
 "description": "An expression which specifies a boost condition. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost documents with document ID \"doc_1\" or \"doc_2\", and color \"Red\" or \"Blue\": `(document_id: ANY(\"doc_1\", \"doc_2\")) AND (color: ANY(\"Red\", \"Blue\"))`",
 "type": "string"
@@ -10293,6 +10329,66 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1SearchRequestBoostSpecConditionBoostSpecBoostControlSpec": {
+"description": "Specification for custom ranking based on customer specified attribute value. It provides more controls for customized ranking than the simple (condition, boost) combination above.",
+"id": "GoogleCloudDiscoveryengineV1SearchRequestBoostSpecConditionBoostSpecBoostControlSpec",
+"properties": {
+"attributeType": {
+"description": "The attribute type to be used to determine the boost amount. The attribute value can be derived from the field value of the specified field_name. In the case of numerical it is straightforward i.e. attribute_value = numerical_field_value. In the case of freshness however, attribute_value = (time.now() - datetime_field_value).",
+"enum": [
+"ATTRIBUTE_TYPE_UNSPECIFIED",
+"NUMERICAL",
+"FRESHNESS"
+],
+"enumDescriptions": [
+"Unspecified AttributeType.",
+"The value of the numerical field will be used to dynamically update the boost amount. In this case, the attribute_value (the x value) of the control point will be the actual value of the numerical field for which the boost_amount is specified.",
+"For the freshness use case the attribute value will be the duration between the current time and the date in the datetime field specified. The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`. For example, `5D`, `3DT12H30M`, `T24H`."
+],
+"type": "string"
+},
+"controlPoints": {
+"description": "The control points used to define the curve. The monotonic function (defined through the interpolation_type above) passes through the control points listed here.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1SearchRequestBoostSpecConditionBoostSpecBoostControlSpecControlPoint"
+},
+"type": "array"
+},
+"fieldName": {
+"description": "The name of the field whose value will be used to determine the boost amount.",
+"type": "string"
+},
+"interpolationType": {
+"description": "The interpolation type to be applied to connect the control points listed below.",
+"enum": [
+"INTERPOLATION_TYPE_UNSPECIFIED",
+"LINEAR"
+],
+"enumDescriptions": [
+"Interpolation type is unspecified. In this case, it defaults to Linear.",
+"Piecewise linear interpolation will be applied."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1SearchRequestBoostSpecConditionBoostSpecBoostControlSpecControlPoint": {
+"description": "The control points used to define the curve. The curve defined through these control points can only be monotonically increasing or decreasing(constant values are acceptable).",
+"id": "GoogleCloudDiscoveryengineV1SearchRequestBoostSpecConditionBoostSpecBoostControlSpecControlPoint",
+"properties": {
+"attributeValue": {
+"description": "Can be one of: 1. The numerical field value. 2. The duration spec for freshness: The value must be formatted as an XSD `dayTimeDuration` value (a restricted subset of an ISO 8601 duration value). The pattern for this is: `nDnM]`.",
+"type": "string"
+},
+"boostAmount": {
+"description": "The value between -1 to 1 by which to boost the score if the attribute_value evaluates to the value specified above.",
+"format": "float",
+"type": "number"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpec": {
 "description": "A specification for configuring the behavior of content search.",
 "id": "GoogleCloudDiscoveryengineV1SearchRequestContentSearchSpec",
@@ -10408,6 +10504,10 @@
 "description": "Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.",
 "type": "boolean"
 },
+"ignoreJailBreakingQuery": {
+"description": "Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. \"Reply in the tone of a competing company's CEO\". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.",
+"type": "boolean"
+},
 "ignoreLowRelevantContent": {
 "description": "Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.",
 "type": "boolean"
@@ -10976,6 +11076,17 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1ServingConfigDataStore": {
+"description": "Stores information regarding the serving configurations at DataStore level.",
+"id": "GoogleCloudDiscoveryengineV1ServingConfigDataStore",
+"properties": {
+"disabledForServing": {
+"description": "If set true, the DataStore will not be available for serving search requests.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1Session": {
 "description": "External session proto definition.",
 "id": "GoogleCloudDiscoveryengineV1Session",
@@ -11998,7 +12109,7 @@
 "description": "Properties of the object.",
 "type": "any"
 },
-"description": "Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .",
+"description": "Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .",
 "type": "object"
 },
 "title": {
@@ -12420,7 +12531,7 @@
 "type": "string"
 },
 "name": {
-"description": "Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}` model must be an alpha-numerical string with limit of 40 characters.",
+"description": "Required. The fully qualified resource name of the model. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}`. Model must be an alpha-numerical string with limit of 40 characters.",
 "type": "string"
 },
 "trainingStartTime": {
@@ -12505,6 +12616,14 @@
 "description": "Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.",
 "type": "string"
 },
+"naturalLanguageQueryUnderstandingConfig": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig",
+"description": "Optional. Configuration for Natural Language Query Understanding."
+},
+"servingConfigDataStore": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaServingConfigDataStore",
+"description": "Optional. Stores serving config at DataStore level."
+},
 "solutionTypes": {
 "description": "The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.",
 "items": {
@@ -12648,7 +12767,7 @@
 "additionalProperties": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfigParsingConfig"
 },
-"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
+"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
 "type": "object"
 }
 },
@@ -12809,7 +12928,7 @@
 "description": "Configurations for the Media Engine. Only applicable on the data stores with solution_type SOLUTION_TYPE_RECOMMENDATION and IndustryVertical.MEDIA vertical."
 },
 "name": {
-"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
+"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
 "type": "string"
 },
 "recommendationMetadata": {
@@ -13698,6 +13817,27 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig": {
+"description": "Configuration for Natural Language Query Understanding.",
+"id": "GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig",
+"properties": {
+"mode": {
+"description": "Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.",
+"enum": [
+"MODE_UNSPECIFIED",
+"DISABLED",
+"ENABLED"
+],
+"enumDescriptions": [
+"Default value.",
+"Natural Language Query Understanding is disabled.",
+"Natural Language Query Understanding is enabled."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaProject": {
 "description": "Metadata and configurations for a Google Cloud project in the service.",
 "id": "GoogleCloudDiscoveryengineV1alphaProject",
@@ -13709,7 +13849,7 @@
 "type": "string"
 },
 "name": {
-"description": "Output only. Full resource name of the project, for example `projects/{project_number}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
+"description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
 "readOnly": true,
 "type": "string"
 },
@@ -14514,6 +14654,10 @@
 "description": "Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.",
 "type": "boolean"
 },
+"ignoreJailBreakingQuery": {
+"description": "Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. \"Reply in the tone of a competing company's CEO\". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.",
+"type": "boolean"
+},
 "ignoreLowRelevantContent": {
 "description": "Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.",
 "type": "boolean"
@@ -14812,6 +14956,17 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaServingConfigDataStore": {
+"description": "Stores information regarding the serving configurations at DataStore level.",
+"id": "GoogleCloudDiscoveryengineV1alphaServingConfigDataStore",
+"properties": {
+"disabledForServing": {
+"description": "If set true, the DataStore will not be available for serving search requests.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaSession": {
 "description": "External session proto definition.",
 "id": "GoogleCloudDiscoveryengineV1alphaSession",
@@ -15082,7 +15237,7 @@
 "id": "GoogleCloudDiscoveryengineV1alphaTuneEngineMetadata",
 "properties": {
 "engine": {
-"description": "Required. The resource name of the engine that this tune applies to. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`",
+"description": "Required. The resource name of the engine that this tune applies to. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`",
 "type": "string"
 }
 },
@@ -15529,7 +15684,7 @@
 "type": "string"
 },
 "name": {
-"description": "Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}` model must be an alpha-numerical string with limit of 40 characters.",
+"description": "Required. The fully qualified resource name of the model. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}`. Model must be an alpha-numerical string with limit of 40 characters.",
 "type": "string"
 },
 "trainingStartTime": {
@@ -15605,6 +15760,14 @@
 "description": "Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.",
 "type": "string"
 },
+"naturalLanguageQueryUnderstandingConfig": {
+"$ref": "GoogleCloudDiscoveryengineV1betaNaturalLanguageQueryUnderstandingConfig",
+"description": "Optional. Configuration for Natural Language Query Understanding."
+},
+"servingConfigDataStore": {
+"$ref": "GoogleCloudDiscoveryengineV1betaServingConfigDataStore",
+"description": "Optional. Stores serving config at DataStore level."
+},
 "solutionTypes": {
 "description": "The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.",
 "items": {
@@ -15748,7 +15911,7 @@
 "additionalProperties": {
 "$ref": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfig"
 },
-"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
+"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
 "type": "object"
 }
 },
@@ -15905,7 +16068,7 @@
 "type": "string"
 },
 "name": {
-"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
+"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
 "type": "string"
 },
 "searchEngineConfig": {
@@ -16444,6 +16607,27 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaNaturalLanguageQueryUnderstandingConfig": {
+"description": "Configuration for Natural Language Query Understanding.",
+"id": "GoogleCloudDiscoveryengineV1betaNaturalLanguageQueryUnderstandingConfig",
+"properties": {
+"mode": {
+"description": "Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.",
+"enum": [
+"MODE_UNSPECIFIED",
+"DISABLED",
+"ENABLED"
+],
+"enumDescriptions": [
+"Default value.",
+"Natural Language Query Understanding is disabled.",
+"Natural Language Query Understanding is enabled."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaProject": {
 "description": "Metadata and configurations for a Google Cloud project in the service.",
 "id": "GoogleCloudDiscoveryengineV1betaProject",
@@ -16455,7 +16639,7 @@
 "type": "string"
 },
 "name": {
-"description": "Output only. Full resource name of the project, for example `projects/{project_number}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
+"description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
 "readOnly": true,
 "type": "string"
 },
@@ -17051,6 +17235,10 @@
 "description": "Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.",
 "type": "boolean"
 },
+"ignoreJailBreakingQuery": {
+"description": "Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. \"Reply in the tone of a competing company's CEO\". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.",
+"type": "boolean"
+},
 "ignoreLowRelevantContent": {
 "description": "Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.",
 "type": "boolean"
@@ -17349,6 +17537,17 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaServingConfigDataStore": {
+"description": "Stores information regarding the serving configurations at DataStore level.",
+"id": "GoogleCloudDiscoveryengineV1betaServingConfigDataStore",
+"properties": {
+"disabledForServing": {
+"description": "If set true, the DataStore will not be available for serving search requests.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaSiteVerificationInfo": {
 "description": "Verification information for target sites in advanced site search.",
 "id": "GoogleCloudDiscoveryengineV1betaSiteVerificationInfo",
@@ -17535,7 +17734,7 @@
 "id": "GoogleCloudDiscoveryengineV1betaTuneEngineMetadata",
 "properties": {
 "engine": {
-"description": "Required. The resource name of the engine that this tune applies to. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`",
+"description": "Required. The resource name of the engine that this tune applies to. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`",
 "type": "string"
 }
 },
diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json
index 1a20f833ea9..f2bfd542abe 100644
--- a/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json
+++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json
@@ -14,7 +14,7 @@
 "canonicalName": "Discovery Engine",
 "description": "Discovery Engine API.",
 "discoveryVersion": "v1",
-"documentationLink": "https://cloud.google.com/discovery-engine/docs",
+"documentationLink": "https://cloud.google.com/generative-ai-app-builder/docs/",
 "fullyEncodeReservedExpansion": true,
 "icons": {
 "x16": "http://www.google.com/images/icons/product/search-16.gif",
@@ -501,7 +501,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. Full DocumentProcessingConfig resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/documentProcessingConfig`",
+"description": "Required. Full DocumentProcessingConfig resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/documentProcessingConfig`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/documentProcessingConfig$",
 "required": true,
@@ -1238,7 +1238,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -1266,7 +1266,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/controls/[^/]+$",
 "required": true,
@@ -1291,7 +1291,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/controls/[^/]+$",
 "required": true,
@@ -1332,7 +1332,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -1395,7 +1395,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -1423,7 +1423,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -1451,7 +1451,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -1476,7 +1476,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -1522,7 +1522,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -2014,7 +2014,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the ServingConfig to get. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}`",
+"description": "Required. The resource name of the ServingConfig to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$",
 "required": true,
@@ -2050,7 +2050,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Full resource name of the parent resource. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}`",
+"description": "Required. Full resource name of the parent resource. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -2169,7 +2169,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -2197,7 +2197,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -2222,7 +2222,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -2268,7 +2268,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -2331,7 +2331,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
+"description": "Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/sessions/[^/]+/answers/[^/]+$",
 "required": true,
@@ -3014,7 +3014,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The resource name of the catalog under which the events are created. The format is `projects/${projectId}/locations/global/collections/{$collectionId}/dataStores/${dataStoreId}`",
+"description": "Required. The resource name of the catalog under which the events are created. The format is `projects/{project}/locations/global/collections/{collection}/dataStores/{dataStore}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -3205,7 +3205,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
+"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3239,7 +3239,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The name of the engine to pause. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`",
+"description": "Required. The name of the engine to pause. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3267,7 +3267,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The name of the engine to resume. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`",
+"description": "Required. The name of the engine to resume. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3295,7 +3295,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the engine to tune. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`",
+"description": "Required. The resource name of the engine to tune. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3332,7 +3332,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3360,7 +3360,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/controls/[^/]+$",
 "required": true,
@@ -3385,7 +3385,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/controls/[^/]+$",
 "required": true,
@@ -3426,7 +3426,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3489,7 +3489,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -3517,7 +3517,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3545,7 +3545,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -3570,7 +3570,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -3616,7 +3616,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3777,7 +3777,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the ServingConfig to get. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}`",
+"description": "Required. The resource name of the ServingConfig to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$",
 "required": true,
@@ -3813,7 +3813,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Full resource name of the parent resource. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}`",
+"description": "Required. Full resource name of the parent resource. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3932,7 +3932,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3960,7 +3960,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -3985,7 +3985,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -4031,7 +4031,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -4094,7 +4094,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
+"description": "Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/sessions/[^/]+/answers/[^/]+$",
 "required": true,
@@ -4337,7 +4337,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. Full DocumentProcessingConfig resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/documentProcessingConfig`",
+"description": "Required. Full DocumentProcessingConfig resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/documentProcessingConfig`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/documentProcessingConfig$",
 "required": true,
@@ -5046,7 +5046,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -5074,7 +5074,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/controls/[^/]+$",
 "required": true,
@@ -5099,7 +5099,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/controls/[^/]+$",
 "required": true,
@@ -5140,7 +5140,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -5203,7 +5203,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -5231,7 +5231,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -5259,7 +5259,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -5284,7 +5284,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -5330,7 +5330,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -5721,7 +5721,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the ServingConfig to get. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}`",
+"description": "Required. The resource name of the ServingConfig to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$",
 "required": true,
@@ -5757,7 +5757,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Full resource name of the parent resource. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}`",
+"description": "Required. Full resource name of the parent resource. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -5876,7 +5876,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -5904,7 +5904,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -5929,7 +5929,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -5975,7 +5975,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -6038,7 +6038,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
+"description": "Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/sessions/[^/]+/answers/[^/]+$",
 "required": true,
@@ -6462,7 +6462,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The resource name of the catalog under which the events are created. The format is `projects/${projectId}/locations/global/collections/{$collectionId}/dataStores/${dataStoreId}`",
+"description": "Required. The resource name of the catalog under which the events are created. The format is `projects/{project}/locations/global/collections/{collection}/dataStores/{dataStore}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -6865,7 +6865,7 @@
 ],
 "parameters": {
 "rankingConfig": {
-"description": "Required. The resource name of the rank service config, such as `projects/{project_num}/locations/{location_id}/rankingConfigs/default_ranking_config`.",
+"description": "Required. The resource name of the rank service config, such as `projects/{project_num}/locations/{location}/rankingConfigs/default_ranking_config`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/rankingConfigs/[^/]+$",
 "required": true,
@@ -7517,7 +7517,7 @@
 }
 }
 },
-"revision": "20240829",
+"revision": "20240906",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiDistribution": {
@@ -8206,6 +8206,10 @@
 "description": "Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.",
 "type": "string"
 },
+"servingConfigDataStore": {
+"$ref": "GoogleCloudDiscoveryengineV1ServingConfigDataStore",
+"description": "Optional. Stores serving config at DataStore level."
+},
 "solutionTypes": {
 "description": "The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.",
 "items": {
@@ -8349,7 +8353,7 @@
 "additionalProperties": {
 "$ref": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfig"
 },
-"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
+"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
 "type": "object"
 }
 },
@@ -8506,7 +8510,7 @@
 "type": "string"
 },
 "name": {
-"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
+"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
 "type": "string"
 },
 "searchEngineConfig": {
@@ -8849,7 +8853,7 @@
 "type": "string"
 },
 "name": {
-"description": "Output only. Full resource name of the project, for example `projects/{project_number}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
+"description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
 "readOnly": true,
 "type": "string"
 },
@@ -9062,6 +9066,17 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1ServingConfigDataStore": {
+"description": "Stores information regarding the serving configurations at DataStore level.",
+"id": "GoogleCloudDiscoveryengineV1ServingConfigDataStore",
+"properties": {
+"disabledForServing": {
+"description": "If set true, the DataStore will not be available for serving search requests.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1SiteVerificationInfo": {
 "description": "Verification information for target sites in advanced site search.",
 "id": "GoogleCloudDiscoveryengineV1SiteVerificationInfo",
@@ -9506,7 +9521,8 @@
 "description": "Answer generation specification."
 },
 "asynchronousMode": {
-"description": "Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.",
+"deprecated": true,
+"description": "Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.",
 "type": "boolean"
 },
 "query": {
@@ -9559,6 +9575,10 @@
 "description": "Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No answer is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating answers for adversarial queries and return fallback messages instead.",
 "type": "boolean"
 },
+"ignoreJailBreakingQuery": {
+"description": "Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. \"Reply in the tone of a competing company's CEO\". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.",
+"type": "boolean"
+},
 "ignoreLowRelevantContent": {
 "description": "Specifies whether to filter out queries that have low relevance. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true` or unset, the behavior will be determined automatically by the service.",
 "type": "boolean"
@@ -9789,6 +9809,25 @@
 "content": {
 "description": "Chunk textual content.",
 "type": "string"
+},
+"documentMetadata": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfoDocumentMetadata",
+"description": "Metadata of the document from the current chunk."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfoDocumentMetadata": {
+"description": "Document metadata contains the information of the document of the current chunk.",
+"id": "GoogleCloudDiscoveryengineV1alphaAnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfoDocumentMetadata",
+"properties": {
+"title": {
+"description": "Title of the document.",
+"type": "string"
+},
+"uri": {
+"description": "Uri of the document.",
+"type": "string"
 }
 },
 "type": "object"
@@ -10180,7 +10219,7 @@
 "description": "Properties of the object.",
 "type": "any"
 },
-"description": "Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .",
+"description": "Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .",
 "type": "object"
 },
 "title": {
@@ -10316,13 +10355,13 @@
 "$ref": "GoogleCloudDiscoveryengineV1alphaBatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue",
 "description": "The value of the matcher that was used to match the Document."
 },
-"status": {
-"description": "The status of the document.",
+"state": {
+"description": "The state of the document.",
 "enum": [
-"STATUS_UNSPECIFIED",
-"STATUS_INDEXED",
-"STATUS_NOT_IN_TARGET_SITE",
-"STATUS_NOT_IN_INDEX"
+"STATE_UNSPECIFIED",
+"INDEXED",
+"NOT_IN_TARGET_SITE",
+"NOT_IN_INDEX"
 ],
 "enumDescriptions": [
 "Should never be set.",
@@ -11265,7 +11304,7 @@
 "type": "boolean"
 },
 "servingConfig": {
-"description": "The resource name of the Serving Config to use. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.",
+"description": "The resource name of the Serving Config to use. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.",
 "type": "string"
 },
 "summarySpec": {
@@ -11485,7 +11524,7 @@
 "type": "string"
 },
 "name": {
-"description": "Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}` model must be an alpha-numerical string with limit of 40 characters.",
+"description": "Required. The fully qualified resource name of the model. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}`. Model must be an alpha-numerical string with limit of 40 characters.",
 "type": "string"
 },
 "trainingStartTime": {
@@ -11570,6 +11609,14 @@
 "description": "Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.",
 "type": "string"
 },
+"naturalLanguageQueryUnderstandingConfig": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig",
+"description": "Optional. Configuration for Natural Language Query Understanding."
+},
+"servingConfigDataStore": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaServingConfigDataStore",
+"description": "Optional. Stores serving config at DataStore level."
+},
 "solutionTypes": {
 "description": "The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.",
 "items": {
@@ -11847,7 +11894,7 @@
 "type": "boolean"
 },
 "name": {
-"description": "The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`",
+"description": "The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`",
 "type": "string"
 },
 "promotionIds": {
@@ -11889,7 +11936,7 @@
 "additionalProperties": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfigParsingConfig"
 },
-"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
+"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
 "type": "object"
 }
 },
@@ -12082,7 +12129,7 @@
 "description": "Configurations for the Media Engine. Only applicable on the data stores with solution_type SOLUTION_TYPE_RECOMMENDATION and IndustryVertical.MEDIA vertical."
 },
 "name": {
-"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
+"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
 "type": "string"
 },
 "recommendationMetadata": {
@@ -13704,6 +13751,27 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig": {
+"description": "Configuration for Natural Language Query Understanding.",
+"id": "GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig",
+"properties": {
+"mode": {
+"description": "Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.",
+"enum": [
+"MODE_UNSPECIFIED",
+"DISABLED",
+"ENABLED"
+],
+"enumDescriptions": [
+"Default value.",
+"Natural Language Query Understanding is disabled.",
+"Natural Language Query Understanding is enabled."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaPageInfo": {
 "description": "Detailed page information.",
 "id": "GoogleCloudDiscoveryengineV1alphaPageInfo",
@@ -13799,7 +13867,7 @@
 "type": "string"
 },
 "name": {
-"description": "Output only. Full resource name of the project, for example `projects/{project_number}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
+"description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
 "readOnly": true,
 "type": "string"
 },
@@ -14404,6 +14472,10 @@
 "description": "Request message for SiteSearchEngineService.RecrawlUris method.",
 "id": "GoogleCloudDiscoveryengineV1alphaRecrawlUrisRequest",
 "properties": {
+"siteCredential": {
+"description": "Optional. Full resource name of the SiteCredential, such as `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCredentials/*`. Only set to crawl private URIs.",
+"type": "string"
+},
 "uris": {
 "description": "Required. List of URIs to crawl. At most 10K URIs are supported, otherwise an INVALID_ARGUMENT error is thrown. Each URI should match at least one TargetSite in `site_search_engine`.",
 "items": {
@@ -15183,6 +15255,10 @@
 "description": "Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.",
 "type": "boolean"
 },
+"ignoreJailBreakingQuery": {
+"description": "Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. \"Reply in the tone of a competing company's CEO\". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.",
+"type": "boolean"
+},
 "ignoreLowRelevantContent": {
 "description": "Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.",
 "type": "boolean"
@@ -16238,6 +16314,17 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaServingConfigDataStore": {
+"description": "Stores information regarding the serving configurations at DataStore level.",
+"id": "GoogleCloudDiscoveryengineV1alphaServingConfigDataStore",
+"properties": {
+"disabledForServing": {
+"description": "If set true, the DataStore will not be available for serving search requests.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaServingConfigGenericConfig": {
 "description": "Specifies the configurations needed for Generic Discovery.Currently we support: * `content_search_spec`: configuration for generic content search.",
 "id": "GoogleCloudDiscoveryengineV1alphaServingConfigGenericConfig",
@@ -16734,7 +16821,7 @@
 "id": "GoogleCloudDiscoveryengineV1alphaTuneEngineMetadata",
 "properties": {
 "engine": {
-"description": "Required. The resource name of the engine that this tune applies to. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`",
+"description": "Required. The resource name of the engine that this tune applies to. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`",
 "type": "string"
 }
 },
@@ -17287,7 +17374,7 @@
 "type": "string"
 },
 "name": {
-"description": "Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}` model must be an alpha-numerical string with limit of 40 characters.",
+"description": "Required. The fully qualified resource name of the model. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}`. Model must be an alpha-numerical string with limit of 40 characters.",
 "type": "string"
 },
 "trainingStartTime": {
@@ -17363,6 +17450,14 @@
 "description": "Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.",
 "type": "string"
 },
+"naturalLanguageQueryUnderstandingConfig": {
+"$ref": "GoogleCloudDiscoveryengineV1betaNaturalLanguageQueryUnderstandingConfig",
+"description": "Optional. Configuration for Natural Language Query Understanding."
+},
+"servingConfigDataStore": {
+"$ref": "GoogleCloudDiscoveryengineV1betaServingConfigDataStore",
+"description": "Optional. Stores serving config at DataStore level."
+},
 "solutionTypes": {
 "description": "The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.",
 "items": {
@@ -17506,7 +17601,7 @@
 "additionalProperties": {
 "$ref": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfig"
 },
-"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
+"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
 "type": "object"
 }
 },
@@ -17663,7 +17758,7 @@
 "type": "string"
 },
 "name": {
-"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
+"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
 "type": "string"
 },
 "searchEngineConfig": {
@@ -18202,6 +18297,27 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaNaturalLanguageQueryUnderstandingConfig": {
+"description": "Configuration for Natural Language Query Understanding.",
+"id": "GoogleCloudDiscoveryengineV1betaNaturalLanguageQueryUnderstandingConfig",
+"properties": {
+"mode": {
+"description": "Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.",
+"enum": [
+"MODE_UNSPECIFIED",
+"DISABLED",
+"ENABLED"
+],
+"enumDescriptions": [
+"Default value.",
+"Natural Language Query Understanding is disabled.",
+"Natural Language Query Understanding is enabled."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaProject": {
 "description": "Metadata and configurations for a Google Cloud project in the service.",
 "id": "GoogleCloudDiscoveryengineV1betaProject",
@@ -18213,7 +18329,7 @@
 "type": "string"
 },
 "name": {
-"description": "Output only. Full resource name of the project, for example `projects/{project_number}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
+"description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
 "readOnly": true,
 "type": "string"
 },
@@ -18809,6 +18925,10 @@
 "description": "Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.",
 "type": "boolean"
 },
+"ignoreJailBreakingQuery": {
+"description": "Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. \"Reply in the tone of a competing company's CEO\". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.",
+"type": "boolean"
+},
 "ignoreLowRelevantContent": {
 "description": "Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.",
 "type": "boolean"
@@ -19107,6 +19227,17 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaServingConfigDataStore": {
+"description": "Stores information regarding the serving configurations at DataStore level.",
+"id": "GoogleCloudDiscoveryengineV1betaServingConfigDataStore",
+"properties": {
+"disabledForServing": {
+"description": "If set true, the DataStore will not be available for serving search requests.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaSiteVerificationInfo": {
 "description": "Verification information for target sites in advanced site search.",
 "id": "GoogleCloudDiscoveryengineV1betaSiteVerificationInfo",
@@ -19293,7 +19424,7 @@
 "id": "GoogleCloudDiscoveryengineV1betaTuneEngineMetadata",
 "properties": {
 "engine": {
-"description": "Required. The resource name of the engine that this tune applies to. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`",
+"description": "Required. The resource name of the engine that this tune applies to. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`",
 "type": "string"
 }
 },
diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json
index 2a3806224ca..44cae3e58da 100644
--- a/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json
+++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json
@@ -14,7 +14,7 @@
 "canonicalName": "Discovery Engine",
 "description": "Discovery Engine API.",
 "discoveryVersion": "v1",
-"documentationLink": "https://cloud.google.com/discovery-engine/docs",
+"documentationLink": "https://cloud.google.com/generative-ai-app-builder/docs/",
 "fullyEncodeReservedExpansion": true,
 "icons": {
 "x16": "http://www.google.com/images/icons/product/search-16.gif",
@@ -921,7 +921,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -949,7 +949,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/controls/[^/]+$",
 "required": true,
@@ -974,7 +974,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/controls/[^/]+$",
 "required": true,
@@ -1015,7 +1015,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -1078,7 +1078,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -1106,7 +1106,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -1134,7 +1134,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -1159,7 +1159,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -1205,7 +1205,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -1697,7 +1697,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the ServingConfig to get. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}`",
+"description": "Required. The resource name of the ServingConfig to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$",
 "required": true,
@@ -1733,7 +1733,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Full resource name of the parent resource. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}`",
+"description": "Required. Full resource name of the parent resource. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -1852,7 +1852,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -1880,7 +1880,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -1905,7 +1905,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -1951,7 +1951,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -2014,7 +2014,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
+"description": "Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+/sessions/[^/]+/answers/[^/]+$",
 "required": true,
@@ -2644,7 +2644,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The resource name of the catalog under which the events are created. The format is `projects/${projectId}/locations/global/collections/{$collectionId}/dataStores/${dataStoreId}`",
+"description": "Required. The resource name of the catalog under which the events are created. The format is `projects/{project}/locations/global/collections/{collection}/dataStores/{dataStore}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -2835,7 +2835,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
+"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -2869,7 +2869,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The name of the engine to pause. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`",
+"description": "Required. The name of the engine to pause. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -2897,7 +2897,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The name of the engine to resume. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`",
+"description": "Required. The name of the engine to resume. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -2925,7 +2925,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the engine to tune. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`",
+"description": "Required. The resource name of the engine to tune. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -2962,7 +2962,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -2990,7 +2990,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/controls/[^/]+$",
 "required": true,
@@ -3015,7 +3015,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/controls/[^/]+$",
 "required": true,
@@ -3056,7 +3056,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3119,7 +3119,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -3147,7 +3147,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3175,7 +3175,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -3200,7 +3200,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -3246,7 +3246,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3407,7 +3407,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the ServingConfig to get. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}`",
+"description": "Required. The resource name of the ServingConfig to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/servingConfigs/[^/]+$",
 "required": true,
@@ -3443,7 +3443,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Full resource name of the parent resource. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}`",
+"description": "Required. Full resource name of the parent resource. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3562,7 +3562,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3590,7 +3590,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -3615,7 +3615,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -3661,7 +3661,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+$",
 "required": true,
@@ -3724,7 +3724,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
+"description": "Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/sessions/[^/]+/answers/[^/]+$",
 "required": true,
@@ -4495,7 +4495,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -4523,7 +4523,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to delete. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/controls/[^/]+$",
 "required": true,
@@ -4548,7 +4548,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
+"description": "Required. The resource name of the Control to get. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/controls/{control_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/controls/[^/]+$",
 "required": true,
@@ -4589,7 +4589,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`.",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}` or `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -4652,7 +4652,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`. Use `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/-` to activate auto session mode, which automatically creates a new conversation inside a ConverseConversation session.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -4680,7 +4680,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -4708,7 +4708,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -4733,7 +4733,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Conversation to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
+"description": "Required. The resource name of the Conversation to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/conversations/{conversation_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/conversations/[^/]+$",
 "required": true,
@@ -4779,7 +4779,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -5170,7 +5170,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the ServingConfig to get. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}`",
+"description": "Required. The resource name of the ServingConfig to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/servingConfigs/{serving_config_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/servingConfigs/[^/]+$",
 "required": true,
@@ -5206,7 +5206,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. Full resource name of the parent resource. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}`",
+"description": "Required. Full resource name of the parent resource. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -5325,7 +5325,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. Full resource name of parent data store. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. Full resource name of parent data store. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -5353,7 +5353,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to delete. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to delete. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -5378,7 +5378,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Session to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
+"description": "Required. The resource name of the Session to get. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/sessions/{session_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/sessions/[^/]+$",
 "required": true,
@@ -5424,7 +5424,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The data store resource name. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}`",
+"description": "Required. The data store resource name. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -5487,7 +5487,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The resource name of the Answer to get. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
+"description": "Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+/sessions/[^/]+/answers/[^/]+$",
 "required": true,
@@ -5911,7 +5911,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The resource name of the catalog under which the events are created. The format is `projects/${projectId}/locations/global/collections/{$collectionId}/dataStores/${dataStoreId}`",
+"description": "Required. The resource name of the catalog under which the events are created. The format is `projects/{project}/locations/global/collections/{collection}/dataStores/{dataStore}`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/dataStores/[^/]+$",
 "required": true,
@@ -6240,7 +6240,7 @@
 ],
 "parameters": {
 "rankingConfig": {
-"description": "Required. The resource name of the rank service config, such as `projects/{project_num}/locations/{location_id}/rankingConfigs/default_ranking_config`.",
+"description": "Required. The resource name of the rank service config, such as `projects/{project_num}/locations/{location}/rankingConfigs/default_ranking_config`.",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/rankingConfigs/[^/]+$",
 "required": true,
@@ -6786,7 +6786,7 @@
 }
 }
 },
-"revision": "20240829",
+"revision": "20240906",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiHttpBody": {
@@ -7289,6 +7289,10 @@
 "description": "Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.",
 "type": "string"
 },
+"servingConfigDataStore": {
+"$ref": "GoogleCloudDiscoveryengineV1ServingConfigDataStore",
+"description": "Optional. Stores serving config at DataStore level."
+},
 "solutionTypes": {
 "description": "The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.",
 "items": {
@@ -7432,7 +7436,7 @@
 "additionalProperties": {
 "$ref": "GoogleCloudDiscoveryengineV1DocumentProcessingConfigParsingConfig"
 },
-"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
+"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
 "type": "object"
 }
 },
@@ -7589,7 +7593,7 @@
 "type": "string"
 },
 "name": {
-"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
+"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
 "type": "string"
 },
 "searchEngineConfig": {
@@ -7932,7 +7936,7 @@
 "type": "string"
 },
 "name": {
-"description": "Output only. Full resource name of the project, for example `projects/{project_number}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
+"description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
 "readOnly": true,
 "type": "string"
 },
@@ -8145,6 +8149,17 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1ServingConfigDataStore": {
+"description": "Stores information regarding the serving configurations at DataStore level.",
+"id": "GoogleCloudDiscoveryengineV1ServingConfigDataStore",
+"properties": {
+"disabledForServing": {
+"description": "If set true, the DataStore will not be available for serving search requests.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1SiteVerificationInfo": {
 "description": "Verification information for target sites in advanced site search.",
 "id": "GoogleCloudDiscoveryengineV1SiteVerificationInfo",
@@ -8832,7 +8847,7 @@
 "description": "Properties of the object.",
 "type": "any"
 },
-"description": "Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .",
+"description": "Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .",
 "type": "object"
 },
 "title": {
@@ -9254,7 +9269,7 @@
 "type": "string"
 },
 "name": {
-"description": "Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}` model must be an alpha-numerical string with limit of 40 characters.",
+"description": "Required. The fully qualified resource name of the model. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}`. Model must be an alpha-numerical string with limit of 40 characters.",
 "type": "string"
 },
 "trainingStartTime": {
@@ -9339,6 +9354,14 @@
 "description": "Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.",
 "type": "string"
 },
+"naturalLanguageQueryUnderstandingConfig": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig",
+"description": "Optional. Configuration for Natural Language Query Understanding."
+},
+"servingConfigDataStore": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaServingConfigDataStore",
+"description": "Optional. Stores serving config at DataStore level."
+},
 "solutionTypes": {
 "description": "The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.",
 "items": {
@@ -9482,7 +9505,7 @@
 "additionalProperties": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaDocumentProcessingConfigParsingConfig"
 },
-"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
+"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
 "type": "object"
 }
 },
@@ -9643,7 +9666,7 @@
 "description": "Configurations for the Media Engine. Only applicable on the data stores with solution_type SOLUTION_TYPE_RECOMMENDATION and IndustryVertical.MEDIA vertical."
 },
 "name": {
-"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
+"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
 "type": "string"
 },
 "recommendationMetadata": {
@@ -10532,6 +10555,27 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig": {
+"description": "Configuration for Natural Language Query Understanding.",
+"id": "GoogleCloudDiscoveryengineV1alphaNaturalLanguageQueryUnderstandingConfig",
+"properties": {
+"mode": {
+"description": "Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.",
+"enum": [
+"MODE_UNSPECIFIED",
+"DISABLED",
+"ENABLED"
+],
+"enumDescriptions": [
+"Default value.",
+"Natural Language Query Understanding is disabled.",
+"Natural Language Query Understanding is enabled."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaProject": {
 "description": "Metadata and configurations for a Google Cloud project in the service.",
 "id": "GoogleCloudDiscoveryengineV1alphaProject",
@@ -10543,7 +10587,7 @@
 "type": "string"
 },
 "name": {
-"description": "Output only. Full resource name of the project, for example `projects/{project_number}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
+"description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
 "readOnly": true,
 "type": "string"
 },
@@ -11348,6 +11392,10 @@
 "description": "Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.",
 "type": "boolean"
 },
+"ignoreJailBreakingQuery": {
+"description": "Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. \"Reply in the tone of a competing company's CEO\". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.",
+"type": "boolean"
+},
 "ignoreLowRelevantContent": {
 "description": "Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.",
 "type": "boolean"
@@ -11646,6 +11694,17 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaServingConfigDataStore": {
+"description": "Stores information regarding the serving configurations at DataStore level.",
+"id": "GoogleCloudDiscoveryengineV1alphaServingConfigDataStore",
+"properties": {
+"disabledForServing": {
+"description": "If set true, the DataStore will not be available for serving search requests.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaSession": {
 "description": "External session proto definition.",
 "id": "GoogleCloudDiscoveryengineV1alphaSession",
@@ -11916,7 +11975,7 @@
 "id": "GoogleCloudDiscoveryengineV1alphaTuneEngineMetadata",
 "properties": {
 "engine": {
-"description": "Required. The resource name of the engine that this tune applies to. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`",
+"description": "Required. The resource name of the engine that this tune applies to. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`",
 "type": "string"
 }
 },
@@ -12191,7 +12250,8 @@
 "description": "Answer generation specification."
 },
 "asynchronousMode": {
-"description": "Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.",
+"deprecated": true,
+"description": "Deprecated: This field is deprecated. Streaming Answer API will be supported. Asynchronous mode control. If enabled, the response will be returned with answer/session resource name without final answer. The API users need to do the polling to get the latest status of answer/session by calling ConversationalSearchService.GetAnswer or ConversationalSearchService.GetSession method.",
 "type": "boolean"
 },
 "query": {
@@ -12244,6 +12304,10 @@
 "description": "Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No answer is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating answers for adversarial queries and return fallback messages instead.",
 "type": "boolean"
 },
+"ignoreJailBreakingQuery": {
+"description": "Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. \"Reply in the tone of a competing company's CEO\". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.",
+"type": "boolean"
+},
 "ignoreLowRelevantContent": {
 "description": "Specifies whether to filter out queries that have low relevance. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true` or unset, the behavior will be determined automatically by the service.",
 "type": "boolean"
@@ -12470,6 +12534,25 @@
 "content": {
 "description": "Chunk textual content.",
 "type": "string"
+},
+"documentMetadata": {
+"$ref": "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfoDocumentMetadata",
+"description": "Metadata of the document from the current chunk."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfoDocumentMetadata": {
+"description": "Document metadata contains the information of the document of the current chunk.",
+"id": "GoogleCloudDiscoveryengineV1betaAnswerQueryRequestSearchSpecSearchResultListSearchResultChunkInfoDocumentMetadata",
+"properties": {
+"title": {
+"description": "Title of the document.",
+"type": "string"
+},
+"uri": {
+"description": "Uri of the document.",
+"type": "string"
 }
 },
 "type": "object"
@@ -12861,7 +12944,7 @@
 "description": "Properties of the object.",
 "type": "any"
 },
-"description": "Data representation. The structured JSON data for the document. It's populated from the struct data from the Document , or the Chunk in search result .",
+"description": "Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result. .",
 "type": "object"
 },
 "title": {
@@ -12997,13 +13080,13 @@
 "$ref": "GoogleCloudDiscoveryengineV1betaBatchGetDocumentsMetadataResponseDocumentMetadataMatcherValue",
 "description": "The value of the matcher that was used to match the Document."
 },
-"status": {
-"description": "The status of the document.",
+"state": {
+"description": "The state of the document.",
 "enum": [
-"STATUS_UNSPECIFIED",
-"STATUS_INDEXED",
-"STATUS_NOT_IN_TARGET_SITE",
-"STATUS_NOT_IN_INDEX"
+"STATE_UNSPECIFIED",
+"INDEXED",
+"NOT_IN_TARGET_SITE",
+"NOT_IN_INDEX"
 ],
 "enumDescriptions": [
 "Should never be set.",
@@ -13857,7 +13940,7 @@
 "type": "boolean"
 },
 "servingConfig": {
-"description": "The resource name of the Serving Config to use. Format: `projects/{project_number}/locations/{location_id}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.",
+"description": "The resource name of the Serving Config to use. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store_id}/servingConfigs/{serving_config_id}` If this is not set, the default serving config will be used.",
 "type": "string"
 },
 "summarySpec": {
@@ -14066,7 +14149,7 @@
 "type": "string"
 },
 "name": {
-"description": "Required. The fully qualified resource name of the model. Format: `projects/{project_number}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}` model must be an alpha-numerical string with limit of 40 characters.",
+"description": "Required. The fully qualified resource name of the model. Format: `projects/{project}/locations/{location}/collections/{collection}/dataStores/{data_store}/customTuningModels/{custom_tuning_model}`. Model must be an alpha-numerical string with limit of 40 characters.",
 "type": "string"
 },
 "trainingStartTime": {
@@ -14142,6 +14225,14 @@
 "description": "Immutable. The full resource name of the data store. Format: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.",
 "type": "string"
 },
+"naturalLanguageQueryUnderstandingConfig": {
+"$ref": "GoogleCloudDiscoveryengineV1betaNaturalLanguageQueryUnderstandingConfig",
+"description": "Optional. Configuration for Natural Language Query Understanding."
+},
+"servingConfigDataStore": {
+"$ref": "GoogleCloudDiscoveryengineV1betaServingConfigDataStore",
+"description": "Optional. Stores serving config at DataStore level."
+},
 "solutionTypes": {
 "description": "The solutions that the data store enrolls. Available solutions for each industry_vertical: * `MEDIA`: `SOLUTION_TYPE_RECOMMENDATION` and `SOLUTION_TYPE_SEARCH`. * `SITE_SEARCH`: `SOLUTION_TYPE_SEARCH` is automatically enrolled. Other solutions cannot be enrolled.",
 "items": {
@@ -14383,7 +14474,7 @@
 "type": "boolean"
 },
 "name": {
-"description": "The Document resource full name, of the form: `projects/{project_id}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`",
+"description": "The Document resource full name, of the form: `projects/{project}/locations/{location}/collections/{collection_id}/dataStores/{data_store_id}/branches/{branch_id}/documents/{document_id}`",
 "type": "string"
 },
 "promotionIds": {
@@ -14425,7 +14516,7 @@
 "additionalProperties": {
 "$ref": "GoogleCloudDiscoveryengineV1betaDocumentProcessingConfigParsingConfig"
 },
-"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
+"description": "Map from file type to override the default parsing configuration based on the file type. Supported keys: * `pdf`: Override parsing config for PDF files, either digital parsing, ocr parsing or layout parsing is supported. * `html`: Override parsing config for HTML files, only digital parsing and layout parsing are supported. * `docx`: Override parsing config for DOCX files, only digital parsing and layout parsing are supported. * `pptx`: Override parsing config for PPTX files, only digital parsing and layout parsing are supported. * `xlsm`: Override parsing config for XLSM files, only digital parsing and layout parsing are supported. * `xlsx`: Override parsing config for XLSX files, only digital parsing and layout parsing are supported.",
 "type": "object"
 }
 },
@@ -14614,7 +14705,7 @@
 "type": "string"
 },
 "name": {
-"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project_number}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
+"description": "Immutable. The fully qualified resource name of the engine. This field must be a UTF-8 encoded string with a length limit of 1024 characters. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}` engine should be 1-63 characters, and valid characters are /a-z0-9*/. Otherwise, an INVALID_ARGUMENT error is returned.",
 "type": "string"
 },
 "searchEngineConfig": {
@@ -15785,6 +15876,27 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaNaturalLanguageQueryUnderstandingConfig": {
+"description": "Configuration for Natural Language Query Understanding.",
+"id": "GoogleCloudDiscoveryengineV1betaNaturalLanguageQueryUnderstandingConfig",
+"properties": {
+"mode": {
+"description": "Mode of Natural Language Query Understanding. If this field is unset, the behavior defaults to NaturalLanguageQueryUnderstandingConfig.Mode.DISABLED.",
+"enum": [
+"MODE_UNSPECIFIED",
+"DISABLED",
+"ENABLED"
+],
+"enumDescriptions": [
+"Default value.",
+"Natural Language Query Understanding is disabled.",
+"Natural Language Query Understanding is enabled."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaPageInfo": {
 "description": "Detailed page information.",
 "id": "GoogleCloudDiscoveryengineV1betaPageInfo",
@@ -15850,7 +15962,7 @@
 "type": "string"
 },
 "name": {
-"description": "Output only. Full resource name of the project, for example `projects/{project_number}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
+"description": "Output only. Full resource name of the project, for example `projects/{project}`. Note that when making requests, project number and project id are both acceptable, but the server will always respond in project number.",
 "readOnly": true,
 "type": "string"
 },
@@ -16337,6 +16449,10 @@
 "description": "Request message for SiteSearchEngineService.RecrawlUris method.",
 "id": "GoogleCloudDiscoveryengineV1betaRecrawlUrisRequest",
 "properties": {
+"siteCredential": {
+"description": "Optional. Full resource name of the SiteCredential, such as `projects/*/locations/*/collections/*/dataStores/*/siteSearchEngine/siteCredentials/*`. Only set to crawl private URIs.",
+"type": "string"
+},
 "uris": {
 "description": "Required. List of URIs to crawl. At most 10K URIs are supported, otherwise an INVALID_ARGUMENT error is thrown. Each URI should match at least one TargetSite in `site_search_engine`.",
 "items": {
@@ -16898,6 +17014,10 @@
 "description": "Specifies whether to filter out adversarial queries. The default value is `false`. Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to `true`, we skip generating summaries for adversarial queries and return fallback messages instead.",
 "type": "boolean"
 },
+"ignoreJailBreakingQuery": {
+"description": "Optional. Specifies whether to filter out jail-breaking queries. The default value is `false`. Google employs search-query classification to detect jail-breaking queries. No summary is returned if the search query is classified as a jail-breaking query. A user might add instructions to the query to change the tone, style, language, content of the answer, or ask the model to act as a different entity, e.g. \"Reply in the tone of a competing company's CEO\". If this field is set to `true`, we skip generating summaries for jail-breaking queries and return fallback messages instead.",
+"type": "boolean"
+},
 "ignoreLowRelevantContent": {
 "description": "Specifies whether to filter out queries that have low relevance. The default value is `false`. If this field is set to `false`, all search results are used regardless of relevance to generate answers. If set to `true`, only queries with high relevance search results will generate answers.",
 "type": "boolean"
@@ -17945,6 +18065,17 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaServingConfigDataStore": {
+"description": "Stores information regarding the serving configurations at DataStore level.",
+"id": "GoogleCloudDiscoveryengineV1betaServingConfigDataStore",
+"properties": {
+"disabledForServing": {
+"description": "If set true, the DataStore will not be available for serving search requests.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaServingConfigGenericConfig": {
 "description": "Specifies the configurations needed for Generic Discovery.Currently we support: * `content_search_spec`: configuration for generic content search.",
 "id": "GoogleCloudDiscoveryengineV1betaServingConfigGenericConfig",
@@ -18388,7 +18519,7 @@
 "id": "GoogleCloudDiscoveryengineV1betaTuneEngineMetadata",
 "properties": {
 "engine": {
-"description": "Required. The resource name of the engine that this tune applies to. Format: `projects/{project_number}/locations/{location_id}/collections/{collection_id}/engines/{engine_id}`",
+"description": "Required. The resource name of the engine that this tune applies to. Format: `projects/{project}/locations/{location}/collections/{collection_id}/engines/{engine_id}`",
 "type": "string"
 }
 },

From e93475ddfb63ba5ccfcdbe470c61f4725e9edecb Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:05 +0000
Subject: [PATCH 17/32] feat(documentai): update the api

#### documentai:v1

The following keys were deleted:
- schemas.GoogleCloudDocumentaiV1beta1Barcode (Total Keys: 5)
- schemas.GoogleCloudDocumentaiV1beta1BatchProcessDocumentsResponse (Total Keys: 4)
- schemas.GoogleCloudDocumentaiV1beta1BoundingPoly (Total Keys: 6)
- schemas.GoogleCloudDocumentaiV1beta1Document (Total Keys: 388)
- schemas.GoogleCloudDocumentaiV1beta1GcsDestination (Total Keys: 3)
- schemas.GoogleCloudDocumentaiV1beta1GcsSource (Total Keys: 3)
- schemas.GoogleCloudDocumentaiV1beta1InputConfig (Total Keys: 4)
- schemas.GoogleCloudDocumentaiV1beta1NormalizedVertex (Total Keys: 6)
- schemas.GoogleCloudDocumentaiV1beta1OperationMetadata (Total Keys: 8)
- schemas.GoogleCloudDocumentaiV1beta1OutputConfig (Total Keys: 5)
- schemas.GoogleCloudDocumentaiV1beta1ProcessDocumentResponse (Total Keys: 4)
- schemas.GoogleCloudDocumentaiV1beta1Vertex (Total Keys: 6)
- schemas.GoogleCloudDocumentaiV1beta2Barcode (Total Keys: 5)
- schemas.GoogleCloudDocumentaiV1beta2BatchProcessDocumentsResponse (Total Keys: 4)
- schemas.GoogleCloudDocumentaiV1beta2BoundingPoly (Total Keys: 6)
- schemas.GoogleCloudDocumentaiV1beta2Document (Total Keys: 396)
- schemas.GoogleCloudDocumentaiV1beta2GcsDestination (Total Keys: 3)
- schemas.GoogleCloudDocumentaiV1beta2GcsSource (Total Keys: 3)
- schemas.GoogleCloudDocumentaiV1beta2InputConfig (Total Keys: 6)
- schemas.GoogleCloudDocumentaiV1beta2NormalizedVertex (Total Keys: 6)
- schemas.GoogleCloudDocumentaiV1beta2OperationMetadata (Total Keys: 8)
- schemas.GoogleCloudDocumentaiV1beta2OutputConfig (Total Keys: 5)
- schemas.GoogleCloudDocumentaiV1beta2ProcessDocumentResponse (Total Keys: 4)
- schemas.GoogleCloudDocumentaiV1beta2Vertex (Total Keys: 6)

#### documentai:v1beta3

The following keys were deleted:
- schemas.GoogleCloudDocumentaiV1beta1Barcode (Total Keys: 5)
- schemas.GoogleCloudDocumentaiV1beta1BatchProcessDocumentsResponse (Total Keys: 4)
- schemas.GoogleCloudDocumentaiV1beta1BoundingPoly (Total Keys: 6)
- schemas.GoogleCloudDocumentaiV1beta1Document (Total Keys: 388)
- schemas.GoogleCloudDocumentaiV1beta1GcsDestination (Total Keys: 3)
- schemas.GoogleCloudDocumentaiV1beta1GcsSource (Total Keys: 3)
- schemas.GoogleCloudDocumentaiV1beta1InputConfig (Total Keys: 4)
- schemas.GoogleCloudDocumentaiV1beta1NormalizedVertex (Total Keys: 6)
- schemas.GoogleCloudDocumentaiV1beta1OperationMetadata (Total Keys: 8)
- schemas.GoogleCloudDocumentaiV1beta1OutputConfig (Total Keys: 5)
- schemas.GoogleCloudDocumentaiV1beta1ProcessDocumentResponse (Total Keys: 4)
- schemas.GoogleCloudDocumentaiV1beta1Vertex (Total Keys: 6)
- schemas.GoogleCloudDocumentaiV1beta2Barcode (Total Keys: 5)
- schemas.GoogleCloudDocumentaiV1beta2BatchProcessDocumentsResponse (Total Keys: 4)
- schemas.GoogleCloudDocumentaiV1beta2BoundingPoly (Total Keys: 6)
- schemas.GoogleCloudDocumentaiV1beta2Document (Total Keys: 396)
- schemas.GoogleCloudDocumentaiV1beta2GcsDestination (Total Keys: 3)
- schemas.GoogleCloudDocumentaiV1beta2GcsSource (Total Keys: 3)
- schemas.GoogleCloudDocumentaiV1beta2InputConfig (Total Keys: 6)
- schemas.GoogleCloudDocumentaiV1beta2NormalizedVertex (Total Keys: 6)
- schemas.GoogleCloudDocumentaiV1beta2OperationMetadata (Total Keys: 8)
- schemas.GoogleCloudDocumentaiV1beta2OutputConfig (Total Keys: 5)
- schemas.GoogleCloudDocumentaiV1beta2ProcessDocumentResponse (Total Keys: 4)
- schemas.GoogleCloudDocumentaiV1beta2Vertex (Total Keys: 6)
---
 ...projects.locations.processors.dataset.html |    6 +
 ...v1beta3.projects.locations.processors.html |    4 +
 ...ocations.processors.humanReviewConfig.html |    2 +
 ...ocations.processors.processorVersions.html |   12 +
 .../documents/documentai.v1.json              | 3350 +---------------
 .../documents/documentai.v1beta3.json         | 3358 +----------------
 6 files changed, 34 insertions(+), 6698 deletions(-)

diff --git a/docs/dyn/documentai_v1beta3.projects.locations.processors.dataset.html b/docs/dyn/documentai_v1beta3.projects.locations.processors.dataset.html
index de992616da3..eb8559d2687 100644
--- a/docs/dyn/documentai_v1beta3.projects.locations.processors.dataset.html
+++ b/docs/dyn/documentai_v1beta3.projects.locations.processors.dataset.html
@@ -190,6 +190,7 @@ Method Details
         "baseTypes": [ # The entity type that this type is derived from. For now, one and only one should be set.
           "A String",
         ],
+        "description": "A String", # The description of the entity type. Could be used to provide more information about the entity type for model calls.
         "displayName": "A String", # User defined name for the type.
         "entityTypeMetadata": { # Metadata about an entity type. # Metadata for the entity type.
           "inactive": True or False, # Whether the entity type should be considered inactive.
@@ -202,6 +203,7 @@ Method Details
         "name": "A String", # Name of the type. It must be unique within the schema file and cannot be a "Common Type". The following naming conventions are used: - Use `snake_casing`. - Name matching is case-sensitive. - Maximum 64 characters. - Must start with a letter. - Allowed characters: ASCII letters `[a-z0-9_-]`. (For backward compatibility internal infrastructure and tooling can handle any ascii character.) - The `/` is sometimes used to denote a property of a type. For example `line_item/amount`. This convention is deprecated, but will still be honored for backward compatibility.
         "properties": [ # Description the nested structure, or composition of an entity.
           { # Defines properties that can be part of the entity type.
+            "description": "A String", # The description of the property. Could be used to provide more information about the property for model calls.
             "displayName": "A String", # User defined name for the property.
             "name": "A String", # The name of the property. Follows the same guidelines as the EntityType name.
             "occurrenceType": "A String", # Occurrence type limits the number of instances an entity type appears in the document.
@@ -1345,6 +1347,7 @@ Method Details
         "baseTypes": [ # The entity type that this type is derived from. For now, one and only one should be set.
           "A String",
         ],
+        "description": "A String", # The description of the entity type. Could be used to provide more information about the entity type for model calls.
         "displayName": "A String", # User defined name for the type.
         "entityTypeMetadata": { # Metadata about an entity type. # Metadata for the entity type.
           "inactive": True or False, # Whether the entity type should be considered inactive.
@@ -1357,6 +1360,7 @@ Method Details
         "name": "A String", # Name of the type. It must be unique within the schema file and cannot be a "Common Type". The following naming conventions are used: - Use `snake_casing`. - Name matching is case-sensitive. - Maximum 64 characters. - Must start with a letter. - Allowed characters: ASCII letters `[a-z0-9_-]`. (For backward compatibility internal infrastructure and tooling can handle any ascii character.) - The `/` is sometimes used to denote a property of a type. For example `line_item/amount`. This convention is deprecated, but will still be honored for backward compatibility.
         "properties": [ # Description the nested structure, or composition of an entity.
           { # Defines properties that can be part of the entity type.
+            "description": "A String", # The description of the property. Could be used to provide more information about the property for model calls.
             "displayName": "A String", # User defined name for the property.
             "name": "A String", # The name of the property. Follows the same guidelines as the EntityType name.
             "occurrenceType": "A String", # Occurrence type limits the number of instances an entity type appears in the document.
@@ -1402,6 +1406,7 @@ Method Details
         "baseTypes": [ # The entity type that this type is derived from. For now, one and only one should be set.
           "A String",
         ],
+        "description": "A String", # The description of the entity type. Could be used to provide more information about the entity type for model calls.
         "displayName": "A String", # User defined name for the type.
         "entityTypeMetadata": { # Metadata about an entity type. # Metadata for the entity type.
           "inactive": True or False, # Whether the entity type should be considered inactive.
@@ -1414,6 +1419,7 @@ Method Details
         "name": "A String", # Name of the type. It must be unique within the schema file and cannot be a "Common Type". The following naming conventions are used: - Use `snake_casing`. - Name matching is case-sensitive. - Maximum 64 characters. - Must start with a letter. - Allowed characters: ASCII letters `[a-z0-9_-]`. (For backward compatibility internal infrastructure and tooling can handle any ascii character.) - The `/` is sometimes used to denote a property of a type. For example `line_item/amount`. This convention is deprecated, but will still be honored for backward compatibility.
         "properties": [ # Description the nested structure, or composition of an entity.
           { # Defines properties that can be part of the entity type.
+            "description": "A String", # The description of the property. Could be used to provide more information about the property for model calls.
             "displayName": "A String", # User defined name for the property.
             "name": "A String", # The name of the property. Follows the same guidelines as the EntityType name.
             "occurrenceType": "A String", # Occurrence type limits the number of instances an entity type appears in the document.
diff --git a/docs/dyn/documentai_v1beta3.projects.locations.processors.html b/docs/dyn/documentai_v1beta3.projects.locations.processors.html
index a24721ca50a..ced199d0705 100644
--- a/docs/dyn/documentai_v1beta3.projects.locations.processors.html
+++ b/docs/dyn/documentai_v1beta3.projects.locations.processors.html
@@ -215,6 +215,7 @@ Method Details
           "baseTypes": [ # The entity type that this type is derived from. For now, one and only one should be set.
             "A String",
           ],
+          "description": "A String", # The description of the entity type. Could be used to provide more information about the entity type for model calls.
           "displayName": "A String", # User defined name for the type.
           "entityTypeMetadata": { # Metadata about an entity type. # Metadata for the entity type.
             "inactive": True or False, # Whether the entity type should be considered inactive.
@@ -227,6 +228,7 @@ Method Details
           "name": "A String", # Name of the type. It must be unique within the schema file and cannot be a "Common Type". The following naming conventions are used: - Use `snake_casing`. - Name matching is case-sensitive. - Maximum 64 characters. - Must start with a letter. - Allowed characters: ASCII letters `[a-z0-9_-]`. (For backward compatibility internal infrastructure and tooling can handle any ascii character.) - The `/` is sometimes used to denote a property of a type. For example `line_item/amount`. This convention is deprecated, but will still be honored for backward compatibility.
           "properties": [ # Description the nested structure, or composition of an entity.
             { # Defines properties that can be part of the entity type.
+              "description": "A String", # The description of the property. Could be used to provide more information about the property for model calls.
               "displayName": "A String", # User defined name for the property.
               "name": "A String", # The name of the property. Follows the same guidelines as the EntityType name.
               "occurrenceType": "A String", # Occurrence type limits the number of instances an entity type appears in the document.
@@ -2486,6 +2488,7 @@ Method Details
           "baseTypes": [ # The entity type that this type is derived from. For now, one and only one should be set.
             "A String",
           ],
+          "description": "A String", # The description of the entity type. Could be used to provide more information about the entity type for model calls.
           "displayName": "A String", # User defined name for the type.
           "entityTypeMetadata": { # Metadata about an entity type. # Metadata for the entity type.
             "inactive": True or False, # Whether the entity type should be considered inactive.
@@ -2498,6 +2501,7 @@ Method Details
           "name": "A String", # Name of the type. It must be unique within the schema file and cannot be a "Common Type". The following naming conventions are used: - Use `snake_casing`. - Name matching is case-sensitive. - Maximum 64 characters. - Must start with a letter. - Allowed characters: ASCII letters `[a-z0-9_-]`. (For backward compatibility internal infrastructure and tooling can handle any ascii character.) - The `/` is sometimes used to denote a property of a type. For example `line_item/amount`. This convention is deprecated, but will still be honored for backward compatibility.
           "properties": [ # Description the nested structure, or composition of an entity.
             { # Defines properties that can be part of the entity type.
+              "description": "A String", # The description of the property. Could be used to provide more information about the property for model calls.
               "displayName": "A String", # User defined name for the property.
               "name": "A String", # The name of the property. Follows the same guidelines as the EntityType name.
               "occurrenceType": "A String", # Occurrence type limits the number of instances an entity type appears in the document.
diff --git a/docs/dyn/documentai_v1beta3.projects.locations.processors.humanReviewConfig.html b/docs/dyn/documentai_v1beta3.projects.locations.processors.humanReviewConfig.html
index bc196cb5486..4f97a9c8ab6 100644
--- a/docs/dyn/documentai_v1beta3.projects.locations.processors.humanReviewConfig.html
+++ b/docs/dyn/documentai_v1beta3.projects.locations.processors.humanReviewConfig.html
@@ -1040,6 +1040,7 @@ Method Details
         "baseTypes": [ # The entity type that this type is derived from. For now, one and only one should be set.
           "A String",
         ],
+        "description": "A String", # The description of the entity type. Could be used to provide more information about the entity type for model calls.
         "displayName": "A String", # User defined name for the type.
         "entityTypeMetadata": { # Metadata about an entity type. # Metadata for the entity type.
           "inactive": True or False, # Whether the entity type should be considered inactive.
@@ -1052,6 +1053,7 @@ Method Details
         "name": "A String", # Name of the type. It must be unique within the schema file and cannot be a "Common Type". The following naming conventions are used: - Use `snake_casing`. - Name matching is case-sensitive. - Maximum 64 characters. - Must start with a letter. - Allowed characters: ASCII letters `[a-z0-9_-]`. (For backward compatibility internal infrastructure and tooling can handle any ascii character.) - The `/` is sometimes used to denote a property of a type. For example `line_item/amount`. This convention is deprecated, but will still be honored for backward compatibility.
         "properties": [ # Description the nested structure, or composition of an entity.
           { # Defines properties that can be part of the entity type.
+            "description": "A String", # The description of the property. Could be used to provide more information about the property for model calls.
             "displayName": "A String", # User defined name for the property.
             "name": "A String", # The name of the property. Follows the same guidelines as the EntityType name.
             "occurrenceType": "A String", # Occurrence type limits the number of instances an entity type appears in the document.
diff --git a/docs/dyn/documentai_v1beta3.projects.locations.processors.processorVersions.html b/docs/dyn/documentai_v1beta3.projects.locations.processors.processorVersions.html
index 5fce6daddc4..285bb372bf3 100644
--- a/docs/dyn/documentai_v1beta3.projects.locations.processors.processorVersions.html
+++ b/docs/dyn/documentai_v1beta3.projects.locations.processors.processorVersions.html
@@ -205,6 +205,7 @@ Method Details
           "baseTypes": [ # The entity type that this type is derived from. For now, one and only one should be set.
             "A String",
           ],
+          "description": "A String", # The description of the entity type. Could be used to provide more information about the entity type for model calls.
           "displayName": "A String", # User defined name for the type.
           "entityTypeMetadata": { # Metadata about an entity type. # Metadata for the entity type.
             "inactive": True or False, # Whether the entity type should be considered inactive.
@@ -217,6 +218,7 @@ Method Details
           "name": "A String", # Name of the type. It must be unique within the schema file and cannot be a "Common Type". The following naming conventions are used: - Use `snake_casing`. - Name matching is case-sensitive. - Maximum 64 characters. - Must start with a letter. - Allowed characters: ASCII letters `[a-z0-9_-]`. (For backward compatibility internal infrastructure and tooling can handle any ascii character.) - The `/` is sometimes used to denote a property of a type. For example `line_item/amount`. This convention is deprecated, but will still be honored for backward compatibility.
           "properties": [ # Description the nested structure, or composition of an entity.
             { # Defines properties that can be part of the entity type.
+              "description": "A String", # The description of the property. Could be used to provide more information about the property for model calls.
               "displayName": "A String", # User defined name for the property.
               "name": "A String", # The name of the property. Follows the same guidelines as the EntityType name.
               "occurrenceType": "A String", # Occurrence type limits the number of instances an entity type appears in the document.
@@ -438,6 +440,7 @@ Method Details
         "baseTypes": [ # The entity type that this type is derived from. For now, one and only one should be set.
           "A String",
         ],
+        "description": "A String", # The description of the entity type. Could be used to provide more information about the entity type for model calls.
         "displayName": "A String", # User defined name for the type.
         "entityTypeMetadata": { # Metadata about an entity type. # Metadata for the entity type.
           "inactive": True or False, # Whether the entity type should be considered inactive.
@@ -450,6 +453,7 @@ Method Details
         "name": "A String", # Name of the type. It must be unique within the schema file and cannot be a "Common Type". The following naming conventions are used: - Use `snake_casing`. - Name matching is case-sensitive. - Maximum 64 characters. - Must start with a letter. - Allowed characters: ASCII letters `[a-z0-9_-]`. (For backward compatibility internal infrastructure and tooling can handle any ascii character.) - The `/` is sometimes used to denote a property of a type. For example `line_item/amount`. This convention is deprecated, but will still be honored for backward compatibility.
         "properties": [ # Description the nested structure, or composition of an entity.
           { # Defines properties that can be part of the entity type.
+            "description": "A String", # The description of the property. Could be used to provide more information about the property for model calls.
             "displayName": "A String", # User defined name for the property.
             "name": "A String", # The name of the property. Follows the same guidelines as the EntityType name.
             "occurrenceType": "A String", # Occurrence type limits the number of instances an entity type appears in the document.
@@ -605,6 +609,7 @@ Method Details
             "baseTypes": [ # The entity type that this type is derived from. For now, one and only one should be set.
               "A String",
             ],
+            "description": "A String", # The description of the entity type. Could be used to provide more information about the entity type for model calls.
             "displayName": "A String", # User defined name for the type.
             "entityTypeMetadata": { # Metadata about an entity type. # Metadata for the entity type.
               "inactive": True or False, # Whether the entity type should be considered inactive.
@@ -617,6 +622,7 @@ Method Details
             "name": "A String", # Name of the type. It must be unique within the schema file and cannot be a "Common Type". The following naming conventions are used: - Use `snake_casing`. - Name matching is case-sensitive. - Maximum 64 characters. - Must start with a letter. - Allowed characters: ASCII letters `[a-z0-9_-]`. (For backward compatibility internal infrastructure and tooling can handle any ascii character.) - The `/` is sometimes used to denote a property of a type. For example `line_item/amount`. This convention is deprecated, but will still be honored for backward compatibility.
             "properties": [ # Description the nested structure, or composition of an entity.
               { # Defines properties that can be part of the entity type.
+                "description": "A String", # The description of the property. Could be used to provide more information about the property for model calls.
                 "displayName": "A String", # User defined name for the property.
                 "name": "A String", # The name of the property. Follows the same guidelines as the EntityType name.
                 "occurrenceType": "A String", # Occurrence type limits the number of instances an entity type appears in the document.
@@ -2643,6 +2649,7 @@ Method Details
           "baseTypes": [ # The entity type that this type is derived from. For now, one and only one should be set.
             "A String",
           ],
+          "description": "A String", # The description of the entity type. Could be used to provide more information about the entity type for model calls.
           "displayName": "A String", # User defined name for the type.
           "entityTypeMetadata": { # Metadata about an entity type. # Metadata for the entity type.
             "inactive": True or False, # Whether the entity type should be considered inactive.
@@ -2655,6 +2662,7 @@ Method Details
           "name": "A String", # Name of the type. It must be unique within the schema file and cannot be a "Common Type". The following naming conventions are used: - Use `snake_casing`. - Name matching is case-sensitive. - Maximum 64 characters. - Must start with a letter. - Allowed characters: ASCII letters `[a-z0-9_-]`. (For backward compatibility internal infrastructure and tooling can handle any ascii character.) - The `/` is sometimes used to denote a property of a type. For example `line_item/amount`. This convention is deprecated, but will still be honored for backward compatibility.
           "properties": [ # Description the nested structure, or composition of an entity.
             { # Defines properties that can be part of the entity type.
+              "description": "A String", # The description of the property. Could be used to provide more information about the property for model calls.
               "displayName": "A String", # User defined name for the property.
               "name": "A String", # The name of the property. Follows the same guidelines as the EntityType name.
               "occurrenceType": "A String", # Occurrence type limits the number of instances an entity type appears in the document.
@@ -3664,6 +3672,7 @@ Method Details
         "baseTypes": [ # The entity type that this type is derived from. For now, one and only one should be set.
           "A String",
         ],
+        "description": "A String", # The description of the entity type. Could be used to provide more information about the entity type for model calls.
         "displayName": "A String", # User defined name for the type.
         "entityTypeMetadata": { # Metadata about an entity type. # Metadata for the entity type.
           "inactive": True or False, # Whether the entity type should be considered inactive.
@@ -3676,6 +3685,7 @@ Method Details
         "name": "A String", # Name of the type. It must be unique within the schema file and cannot be a "Common Type". The following naming conventions are used: - Use `snake_casing`. - Name matching is case-sensitive. - Maximum 64 characters. - Must start with a letter. - Allowed characters: ASCII letters `[a-z0-9_-]`. (For backward compatibility internal infrastructure and tooling can handle any ascii character.) - The `/` is sometimes used to denote a property of a type. For example `line_item/amount`. This convention is deprecated, but will still be honored for backward compatibility.
         "properties": [ # Description the nested structure, or composition of an entity.
           { # Defines properties that can be part of the entity type.
+            "description": "A String", # The description of the property. Could be used to provide more information about the property for model calls.
             "displayName": "A String", # User defined name for the property.
             "name": "A String", # The name of the property. Follows the same guidelines as the EntityType name.
             "occurrenceType": "A String", # Occurrence type limits the number of instances an entity type appears in the document.
@@ -3747,6 +3757,7 @@ Method Details
           "baseTypes": [ # The entity type that this type is derived from. For now, one and only one should be set.
             "A String",
           ],
+          "description": "A String", # The description of the entity type. Could be used to provide more information about the entity type for model calls.
           "displayName": "A String", # User defined name for the type.
           "entityTypeMetadata": { # Metadata about an entity type. # Metadata for the entity type.
             "inactive": True or False, # Whether the entity type should be considered inactive.
@@ -3759,6 +3770,7 @@ Method Details
           "name": "A String", # Name of the type. It must be unique within the schema file and cannot be a "Common Type". The following naming conventions are used: - Use `snake_casing`. - Name matching is case-sensitive. - Maximum 64 characters. - Must start with a letter. - Allowed characters: ASCII letters `[a-z0-9_-]`. (For backward compatibility internal infrastructure and tooling can handle any ascii character.) - The `/` is sometimes used to denote a property of a type. For example `line_item/amount`. This convention is deprecated, but will still be honored for backward compatibility.
           "properties": [ # Description the nested structure, or composition of an entity.
             { # Defines properties that can be part of the entity type.
+              "description": "A String", # The description of the property. Could be used to provide more information about the property for model calls.
               "displayName": "A String", # User defined name for the property.
               "name": "A String", # The name of the property. Follows the same guidelines as the EntityType name.
               "occurrenceType": "A String", # Occurrence type limits the number of instances an entity type appears in the document.
diff --git a/googleapiclient/discovery_cache/documents/documentai.v1.json b/googleapiclient/discovery_cache/documents/documentai.v1.json
index 74611b19e29..5f929f37465 100644
--- a/googleapiclient/discovery_cache/documents/documentai.v1.json
+++ b/googleapiclient/discovery_cache/documents/documentai.v1.json
@@ -1042,7 +1042,7 @@
 }
 }
 },
-"revision": "20240813",
+"revision": "20240911",
 "rootUrl": "https://documentai.googleapis.com/",
 "schemas": {
 "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": {
@@ -5166,3354 +5166,6 @@ true
 },
 "type": "object"
 },
-"GoogleCloudDocumentaiV1beta1Barcode": {
-"description": "Encodes the detailed information of a barcode.",
-"id": "GoogleCloudDocumentaiV1beta1Barcode",
-"properties": {
-"format": {
-"description": "Format of a barcode. The supported formats are: - `CODE_128`: Code 128 type. - `CODE_39`: Code 39 type. - `CODE_93`: Code 93 type. - `CODABAR`: Codabar type. - `DATA_MATRIX`: 2D Data Matrix type. - `ITF`: ITF type. - `EAN_13`: EAN-13 type. - `EAN_8`: EAN-8 type. - `QR_CODE`: 2D QR code type. - `UPC_A`: UPC-A type. - `UPC_E`: UPC-E type. - `PDF417`: PDF417 type. - `AZTEC`: 2D Aztec code type. - `DATABAR`: GS1 DataBar code type.",
-"type": "string"
-},
-"rawValue": {
-"description": "Raw value encoded in the barcode. For example: `'MEBKM:TITLE:Google;URL:https://www.google.com;;'`.",
-"type": "string"
-},
-"valueFormat": {
-"description": "Value format describes the format of the value that a barcode encodes. The supported formats are: - `CONTACT_INFO`: Contact information. - `EMAIL`: Email address. - `ISBN`: ISBN identifier. - `PHONE`: Phone number. - `PRODUCT`: Product. - `SMS`: SMS message. - `TEXT`: Text string. - `URL`: URL address. - `WIFI`: Wifi information. - `GEO`: Geo-localization. - `CALENDAR_EVENT`: Calendar event. - `DRIVER_LICENSE`: Driver's license.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1BatchProcessDocumentsResponse": {
-"description": "Response to an batch document processing request. This is returned in the LRO Operation after the operation is complete.",
-"id": "GoogleCloudDocumentaiV1beta1BatchProcessDocumentsResponse",
-"properties": {
-"responses": {
-"description": "Responses for each individual document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1ProcessDocumentResponse"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1BoundingPoly": {
-"description": "A bounding polygon for the detected image annotation.",
-"id": "GoogleCloudDocumentaiV1beta1BoundingPoly",
-"properties": {
-"normalizedVertices": {
-"description": "The bounding polygon normalized vertices.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1NormalizedVertex"
-},
-"type": "array"
-},
-"vertices": {
-"description": "The bounding polygon vertices.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1Vertex"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1Document": {
-"description": "Document represents the canonical document resource in Document AI. It is an interchange format that provides insights into documents and allows for collaboration between users and Document AI to iterate and optimize for quality.",
-"id": "GoogleCloudDocumentaiV1beta1Document",
-"properties": {
-"chunkedDocument": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocument",
-"description": "Document chunked based on chunking config."
-},
-"content": {
-"description": "Optional. Inline document content, represented as a stream of bytes. Note: As with all `bytes` fields, protobuffers use a pure binary representation, whereas JSON representations use base64.",
-"format": "byte",
-"type": "string"
-},
-"documentLayout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayout",
-"description": "Parsed layout of the document."
-},
-"entities": {
-"description": "A list of entities detected on Document.text. For document shards, entities in this list may cross shard boundaries.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentEntity"
-},
-"type": "array"
-},
-"entityRelations": {
-"description": "Placeholder. Relationship among Document.entities.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentEntityRelation"
-},
-"type": "array"
-},
-"error": {
-"$ref": "GoogleRpcStatus",
-"description": "Any error that occurred while processing this document."
-},
-"mimeType": {
-"description": "An IANA published [media type (MIME type)](https://www.iana.org/assignments/media-types/media-types.xhtml).",
-"type": "string"
-},
-"pages": {
-"description": "Visual page layout for the Document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPage"
-},
-"type": "array"
-},
-"revisions": {
-"description": "Placeholder. Revision history of this document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentRevision"
-},
-"type": "array"
-},
-"shardInfo": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentShardInfo",
-"description": "Information about the sharding if this document is sharded part of a larger document. If the document is not sharded, this message is not specified."
-},
-"text": {
-"description": "Optional. UTF-8 encoded text in reading order from the document.",
-"type": "string"
-},
-"textChanges": {
-"description": "Placeholder. A list of text corrections made to Document.text. This is usually used for annotating corrections to OCR mistakes. Text changes for a given revision may not overlap with each other.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentTextChange"
-},
-"type": "array"
-},
-"textStyles": {
-"deprecated": true,
-"description": "Styles for the Document.text.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentStyle"
-},
-"type": "array"
-},
-"uri": {
-"description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. For more information, refer to [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris).",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentChunkedDocument": {
-"description": "Represents the chunks that the document is divided into.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocument",
-"properties": {
-"chunks": {
-"description": "List of chunks.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunk"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunk": {
-"description": "Represents a chunk.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunk",
-"properties": {
-"chunkId": {
-"description": "ID of the chunk.",
-"type": "string"
-},
-"content": {
-"description": "Text content of the chunk.",
-"type": "string"
-},
-"pageFooters": {
-"description": "Page footers associated with the chunk.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageFooter"
-},
-"type": "array"
-},
-"pageHeaders": {
-"description": "Page headers associated with the chunk.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageHeader"
-},
-"type": "array"
-},
-"pageSpan": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageSpan",
-"description": "Page span of the chunk."
-},
-"sourceBlockIds": {
-"description": "Unused.",
-"items": {
-"type": "string"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageFooter": {
-"description": "Represents the page footer associated with the chunk.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageFooter",
-"properties": {
-"pageSpan": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageSpan",
-"description": "Page span of the footer."
-},
-"text": {
-"description": "Footer in text format.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageHeader": {
-"description": "Represents the page header associated with the chunk.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageHeader",
-"properties": {
-"pageSpan": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageSpan",
-"description": "Page span of the header."
-},
-"text": {
-"description": "Header in text format.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageSpan": {
-"description": "Represents where the chunk starts and ends in the document.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageSpan",
-"properties": {
-"pageEnd": {
-"description": "Page where chunk ends in the document.",
-"format": "int32",
-"type": "integer"
-},
-"pageStart": {
-"description": "Page where chunk starts in the document.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayout": {
-"description": "Represents the parsed layout of a document as a collection of blocks that the document is divided into.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayout",
-"properties": {
-"blocks": {
-"description": "List of blocks in the document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlock"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlock": {
-"description": "Represents a block. A block could be one of the various types (text, table, list) supported.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlock",
-"properties": {
-"blockId": {
-"description": "ID of the block.",
-"type": "string"
-},
-"listBlock": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutListBlock",
-"description": "Block consisting of list content/structure."
-},
-"pageSpan": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutPageSpan",
-"description": "Page span of the block."
-},
-"tableBlock": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableBlock",
-"description": "Block consisting of table content/structure."
-},
-"textBlock": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTextBlock",
-"description": "Block consisting of text content."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutListBlock": {
-"description": "Represents a list type block.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutListBlock",
-"properties": {
-"listEntries": {
-"description": "List entries that constitute a list block.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutListEntry"
-},
-"type": "array"
-},
-"type": {
-"description": "Type of the list_entries (if exist). Available options are `ordered` and `unordered`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutListEntry": {
-"description": "Represents an entry in the list.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutListEntry",
-"properties": {
-"blocks": {
-"description": "A list entry is a list of blocks. Repeated blocks support further hierarchies and nested blocks.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlock"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutPageSpan": {
-"description": "Represents where the block starts and ends in the document.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutPageSpan",
-"properties": {
-"pageEnd": {
-"description": "Page where block ends in the document.",
-"format": "int32",
-"type": "integer"
-},
-"pageStart": {
-"description": "Page where block starts in the document.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableBlock": {
-"description": "Represents a table type block.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableBlock",
-"properties": {
-"bodyRows": {
-"description": "Body rows containing main table content.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableRow"
-},
-"type": "array"
-},
-"caption": {
-"description": "Table caption/title.",
-"type": "string"
-},
-"headerRows": {
-"description": "Header rows at the top of the table.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableRow"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableCell": {
-"description": "Represents a cell in a table row.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableCell",
-"properties": {
-"blocks": {
-"description": "A table cell is a list of blocks. Repeated blocks support further hierarchies and nested blocks.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlock"
-},
-"type": "array"
-},
-"colSpan": {
-"description": "How many columns this cell spans.",
-"format": "int32",
-"type": "integer"
-},
-"rowSpan": {
-"description": "How many rows this cell spans.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableRow": {
-"description": "Represents a row in a table.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableRow",
-"properties": {
-"cells": {
-"description": "A table row is a list of table cells.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableCell"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTextBlock": {
-"description": "Represents a text type block.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTextBlock",
-"properties": {
-"blocks": {
-"description": "A text block could further have child blocks. Repeated blocks support further hierarchies and nested blocks.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlock"
-},
-"type": "array"
-},
-"text": {
-"description": "Text content stored in the block.",
-"type": "string"
-},
-"type": {
-"description": "Type of the text in the block. Available options are: `paragraph`, `subtitle`, `heading-1`, `heading-2`, `heading-3`, `heading-4`, `heading-5`, `header`, `footer`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentEntity": {
-"description": "An entity that could be a phrase in the text or a property that belongs to the document. It is a known entity type, such as a person, an organization, or location.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentEntity",
-"properties": {
-"confidence": {
-"description": "Optional. Confidence of detected Schema entity. Range `[0, 1]`.",
-"format": "float",
-"type": "number"
-},
-"id": {
-"description": "Optional. Canonical id. This will be a unique value in the entity list for this document.",
-"type": "string"
-},
-"mentionId": {
-"description": "Optional. Deprecated. Use `id` field instead.",
-"type": "string"
-},
-"mentionText": {
-"description": "Optional. Text value of the entity e.g. `1600 Amphitheatre Pkwy`.",
-"type": "string"
-},
-"normalizedValue": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentEntityNormalizedValue",
-"description": "Optional. Normalized entity value. Absent if the extracted value could not be converted or the type (e.g. address) is not supported for certain parsers. This field is also only populated for certain supported document types."
-},
-"pageAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageAnchor",
-"description": "Optional. Represents the provenance of this entity wrt. the location on the page where it was found."
-},
-"properties": {
-"description": "Optional. Entities can be nested to form a hierarchical data structure representing the content in the document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentEntity"
-},
-"type": "array"
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"description": "Optional. The history of this annotation."
-},
-"redacted": {
-"description": "Optional. Whether the entity will be redacted for de-identification purposes.",
-"type": "boolean"
-},
-"textAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentTextAnchor",
-"description": "Optional. Provenance of the entity. Text anchor indexing into the Document.text."
-},
-"type": {
-"description": "Required. Entity type from a schema e.g. `Address`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentEntityNormalizedValue": {
-"description": "Parsed and normalized entity value.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentEntityNormalizedValue",
-"properties": {
-"addressValue": {
-"$ref": "GoogleTypePostalAddress",
-"description": "Postal address. See also: https://github.com/googleapis/googleapis/blob/master/google/type/postal_address.proto"
-},
-"booleanValue": {
-"description": "Boolean value. Can be used for entities with binary values, or for checkboxes.",
-"type": "boolean"
-},
-"dateValue": {
-"$ref": "GoogleTypeDate",
-"description": "Date value. Includes year, month, day. See also: https://github.com/googleapis/googleapis/blob/master/google/type/date.proto"
-},
-"datetimeValue": {
-"$ref": "GoogleTypeDateTime",
-"description": "DateTime value. Includes date, time, and timezone. See also: https://github.com/googleapis/googleapis/blob/master/google/type/datetime.proto"
-},
-"floatValue": {
-"description": "Float value.",
-"format": "float",
-"type": "number"
-},
-"integerValue": {
-"description": "Integer value.",
-"format": "int32",
-"type": "integer"
-},
-"moneyValue": {
-"$ref": "GoogleTypeMoney",
-"description": "Money value. See also: https://github.com/googleapis/googleapis/blob/master/google/type/money.proto"
-},
-"text": {
-"description": "Optional. An optional field to store a normalized string. For some entity types, one of respective `structured_value` fields may also be populated. Also not all the types of `structured_value` will be normalized. For example, some processors may not generate `float` or `integer` normalized text by default. Below are sample formats mapped to structured values. - Money/Currency type (`money_value`) is in the ISO 4217 text format. - Date type (`date_value`) is in the ISO 8601 text format. - Datetime type (`datetime_value`) is in the ISO 8601 text format.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentEntityRelation": {
-"description": "Relationship between Entities.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentEntityRelation",
-"properties": {
-"objectId": {
-"description": "Object entity id.",
-"type": "string"
-},
-"relation": {
-"description": "Relationship description.",
-"type": "string"
-},
-"subjectId": {
-"description": "Subject entity id.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPage": {
-"description": "A page in a Document.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPage",
-"properties": {
-"blocks": {
-"description": "A list of visually detected text blocks on the page. A block has a set of lines (collected into paragraphs) that have a common line-spacing and orientation.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageBlock"
-},
-"type": "array"
-},
-"detectedBarcodes": {
-"description": "A list of detected barcodes.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedBarcode"
-},
-"type": "array"
-},
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"dimension": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDimension",
-"description": "Physical dimension of the page."
-},
-"formFields": {
-"description": "A list of visually detected form fields on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageFormField"
-},
-"type": "array"
-},
-"image": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageImage",
-"description": "Rendered image for this page. This image is preprocessed to remove any skew, rotation, and distortions such that the annotation bounding boxes can be upright and axis-aligned."
-},
-"imageQualityScores": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores",
-"description": "Image quality scores."
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for the page."
-},
-"lines": {
-"description": "A list of visually detected text lines on the page. A collection of tokens that a human would perceive as a line.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLine"
-},
-"type": "array"
-},
-"pageNumber": {
-"description": "1-based index for current Page in a parent Document. Useful when a page is taken out of a Document for individual processing.",
-"format": "int32",
-"type": "integer"
-},
-"paragraphs": {
-"description": "A list of visually detected text paragraphs on the page. A collection of lines that a human would perceive as a paragraph.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageParagraph"
-},
-"type": "array"
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"deprecated": true,
-"description": "The history of this page."
-},
-"symbols": {
-"description": "A list of visually detected symbols on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageSymbol"
-},
-"type": "array"
-},
-"tables": {
-"description": "A list of visually detected tables on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageTable"
-},
-"type": "array"
-},
-"tokens": {
-"description": "A list of visually detected tokens on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageToken"
-},
-"type": "array"
-},
-"transforms": {
-"description": "Transformation matrices that were applied to the original document image to produce Page.image.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageMatrix"
-},
-"type": "array"
-},
-"visualElements": {
-"description": "A list of detected non-text visual elements e.g. checkbox, signature etc. on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageVisualElement"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageAnchor": {
-"description": "Referencing the visual context of the entity in the Document.pages. Page anchors can be cross-page, consist of multiple bounding polygons and optionally reference specific layout element types.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageAnchor",
-"properties": {
-"pageRefs": {
-"description": "One or more references to visual page elements",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageAnchorPageRef"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageAnchorPageRef": {
-"description": "Represents a weak reference to a page element within a document.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageAnchorPageRef",
-"properties": {
-"boundingPoly": {
-"$ref": "GoogleCloudDocumentaiV1beta1BoundingPoly",
-"description": "Optional. Identifies the bounding polygon of a layout element on the page. If `layout_type` is set, the bounding polygon must be exactly the same to the layout element it's referring to."
-},
-"confidence": {
-"description": "Optional. Confidence of detected page element, if applicable. Range `[0, 1]`.",
-"format": "float",
-"type": "number"
-},
-"layoutId": {
-"deprecated": true,
-"description": "Optional. Deprecated. Use PageRef.bounding_poly instead.",
-"type": "string"
-},
-"layoutType": {
-"description": "Optional. The type of the layout element that is being referenced if any.",
-"enum": [
-"LAYOUT_TYPE_UNSPECIFIED",
-"BLOCK",
-"PARAGRAPH",
-"LINE",
-"TOKEN",
-"VISUAL_ELEMENT",
-"TABLE",
-"FORM_FIELD"
-],
-"enumDescriptions": [
-"Layout Unspecified.",
-"References a Page.blocks element.",
-"References a Page.paragraphs element.",
-"References a Page.lines element.",
-"References a Page.tokens element.",
-"References a Page.visual_elements element.",
-"Refrrences a Page.tables element.",
-"References a Page.form_fields element."
-],
-"type": "string"
-},
-"page": {
-"description": "Required. Index into the Document.pages element, for example using `Document.pages` to locate the related page element. This field is skipped when its value is the default `0`. See https://developers.google.com/protocol-buffers/docs/proto3#json.",
-"format": "int64",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageBlock": {
-"description": "A block has a set of lines (collected into paragraphs) that have a common line-spacing and orientation.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageBlock",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for Block."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"deprecated": true,
-"description": "The history of this annotation."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageDetectedBarcode": {
-"description": "A detected barcode.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedBarcode",
-"properties": {
-"barcode": {
-"$ref": "GoogleCloudDocumentaiV1beta1Barcode",
-"description": "Detailed barcode information of the DetectedBarcode."
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for DetectedBarcode."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage": {
-"description": "Detected language for a structural component.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage",
-"properties": {
-"confidence": {
-"description": "Confidence of detected language. Range `[0, 1]`.",
-"format": "float",
-"type": "number"
-},
-"languageCode": {
-"description": "The [BCP-47 language code](https://www.unicode.org/reports/tr35/#Unicode_locale_identifier), such as `en-US` or `sr-Latn`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageDimension": {
-"description": "Dimension for the page.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageDimension",
-"properties": {
-"height": {
-"description": "Page height.",
-"format": "float",
-"type": "number"
-},
-"unit": {
-"description": "Dimension unit.",
-"type": "string"
-},
-"width": {
-"description": "Page width.",
-"format": "float",
-"type": "number"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageFormField": {
-"description": "A form field detected on the page.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageFormField",
-"properties": {
-"correctedKeyText": {
-"description": "Created for Labeling UI to export key text. If corrections were made to the text identified by the `field_name.text_anchor`, this field will contain the correction.",
-"type": "string"
-},
-"correctedValueText": {
-"description": "Created for Labeling UI to export value text. If corrections were made to the text identified by the `field_value.text_anchor`, this field will contain the correction.",
-"type": "string"
-},
-"fieldName": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for the FormField name. e.g. `Address`, `Email`, `Grand total`, `Phone number`, etc."
-},
-"fieldValue": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for the FormField value."
-},
-"nameDetectedLanguages": {
-"description": "A list of detected languages for name together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"description": "The history of this annotation."
-},
-"valueDetectedLanguages": {
-"description": "A list of detected languages for value together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"valueType": {
-"description": "If the value is non-textual, this field represents the type. Current valid values are: - blank (this indicates the `field_value` is normal text) - `unfilled_checkbox` - `filled_checkbox`",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageImage": {
-"description": "Rendered image contents for this page.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageImage",
-"properties": {
-"content": {
-"description": "Raw byte content of the image.",
-"format": "byte",
-"type": "string"
-},
-"height": {
-"description": "Height of the image in pixels.",
-"format": "int32",
-"type": "integer"
-},
-"mimeType": {
-"description": "Encoding [media type (MIME type)](https://www.iana.org/assignments/media-types/media-types.xhtml) for the image.",
-"type": "string"
-},
-"width": {
-"description": "Width of the image in pixels.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores": {
-"description": "Image quality scores for the page image.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores",
-"properties": {
-"detectedDefects": {
-"description": "A list of detected defects.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScoresDetectedDefect"
-},
-"type": "array"
-},
-"qualityScore": {
-"description": "The overall quality score. Range `[0, 1]` where `1` is perfect quality.",
-"format": "float",
-"type": "number"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScoresDetectedDefect": {
-"description": "Image Quality Defects",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScoresDetectedDefect",
-"properties": {
-"confidence": {
-"description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence that the defect exists.",
-"format": "float",
-"type": "number"
-},
-"type": {
-"description": "Name of the defect type. Supported values are: - `quality/defect_blurry` - `quality/defect_noisy` - `quality/defect_dark` - `quality/defect_faint` - `quality/defect_text_too_small` - `quality/defect_document_cutoff` - `quality/defect_text_cutoff` - `quality/defect_glare`",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageLayout": {
-"description": "Visual element describing a layout unit on a page.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"properties": {
-"boundingPoly": {
-"$ref": "GoogleCloudDocumentaiV1beta1BoundingPoly",
-"description": "The bounding polygon for the Layout."
-},
-"confidence": {
-"description": "Confidence of the current Layout within context of the object this layout is for. e.g. confidence can be for a single token, a table, a visual element, etc. depending on context. Range `[0, 1]`.",
-"format": "float",
-"type": "number"
-},
-"orientation": {
-"description": "Detected orientation for the Layout.",
-"enum": [
-"ORIENTATION_UNSPECIFIED",
-"PAGE_UP",
-"PAGE_RIGHT",
-"PAGE_DOWN",
-"PAGE_LEFT"
-],
-"enumDescriptions": [
-"Unspecified orientation.",
-"Orientation is aligned with page up.",
-"Orientation is aligned with page right. Turn the head 90 degrees clockwise from upright to read.",
-"Orientation is aligned with page down. Turn the head 180 degrees from upright to read.",
-"Orientation is aligned with page left. Turn the head 90 degrees counterclockwise from upright to read."
-],
-"type": "string"
-},
-"textAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentTextAnchor",
-"description": "Text anchor indexing into the Document.text."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageLine": {
-"description": "A collection of tokens that a human would perceive as a line. Does not cross column boundaries, can be horizontal, vertical, etc.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageLine",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for Line."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"deprecated": true,
-"description": "The history of this annotation."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageMatrix": {
-"description": "Representation for transformation matrix, intended to be compatible and used with OpenCV format for image manipulation.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageMatrix",
-"properties": {
-"cols": {
-"description": "Number of columns in the matrix.",
-"format": "int32",
-"type": "integer"
-},
-"data": {
-"description": "The matrix data.",
-"format": "byte",
-"type": "string"
-},
-"rows": {
-"description": "Number of rows in the matrix.",
-"format": "int32",
-"type": "integer"
-},
-"type": {
-"description": "This encodes information about what data type the matrix uses. For example, 0 (CV_8U) is an unsigned 8-bit image. For the full list of OpenCV primitive data types, please refer to https://docs.opencv.org/4.3.0/d1/d1b/group__core__hal__interface.html",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageParagraph": {
-"description": "A collection of lines that a human would perceive as a paragraph.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageParagraph",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for Paragraph."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"deprecated": true,
-"description": "The history of this annotation."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageSymbol": {
-"description": "A detected symbol.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageSymbol",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for Symbol."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageTable": {
-"description": "A table representation similar to HTML table structure.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageTable",
-"properties": {
-"bodyRows": {
-"description": "Body rows of the table.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageTableTableRow"
-},
-"type": "array"
-},
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"headerRows": {
-"description": "Header rows of the table.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageTableTableRow"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for Table."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"deprecated": true,
-"description": "The history of this table."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageTableTableCell": {
-"description": "A cell representation inside the table.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageTableTableCell",
-"properties": {
-"colSpan": {
-"description": "How many columns this cell spans.",
-"format": "int32",
-"type": "integer"
-},
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for TableCell."
-},
-"rowSpan": {
-"description": "How many rows this cell spans.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageTableTableRow": {
-"description": "A row of table cells.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageTableTableRow",
-"properties": {
-"cells": {
-"description": "Cells that make up this row.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageTableTableCell"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageToken": {
-"description": "A detected token.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageToken",
-"properties": {
-"detectedBreak": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageTokenDetectedBreak",
-"description": "Detected break at the end of a Token."
-},
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for Token."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"deprecated": true,
-"description": "The history of this annotation."
-},
-"styleInfo": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageTokenStyleInfo",
-"description": "Text style attributes."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageTokenDetectedBreak": {
-"description": "Detected break at the end of a Token.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageTokenDetectedBreak",
-"properties": {
-"type": {
-"description": "Detected break type.",
-"enum": [
-"TYPE_UNSPECIFIED",
-"SPACE",
-"WIDE_SPACE",
-"HYPHEN"
-],
-"enumDescriptions": [
-"Unspecified break type.",
-"A single whitespace.",
-"A wider whitespace.",
-"A hyphen that indicates that a token has been split across lines."
-],
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageTokenStyleInfo": {
-"description": "Font and other text style attributes.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageTokenStyleInfo",
-"properties": {
-"backgroundColor": {
-"$ref": "GoogleTypeColor",
-"description": "Color of the background."
-},
-"bold": {
-"description": "Whether the text is bold (equivalent to font_weight is at least `700`).",
-"type": "boolean"
-},
-"fontSize": {
-"description": "Font size in points (`1` point is `\u00b9\u2044\u2087\u2082` inches).",
-"format": "int32",
-"type": "integer"
-},
-"fontType": {
-"description": "Name or style of the font.",
-"type": "string"
-},
-"fontWeight": {
-"description": "TrueType weight on a scale `100` (thin) to `1000` (ultra-heavy). Normal is `400`, bold is `700`.",
-"format": "int32",
-"type": "integer"
-},
-"handwritten": {
-"description": "Whether the text is handwritten.",
-"type": "boolean"
-},
-"italic": {
-"description": "Whether the text is italic.",
-"type": "boolean"
-},
-"letterSpacing": {
-"description": "Letter spacing in points.",
-"format": "double",
-"type": "number"
-},
-"pixelFontSize": {
-"description": "Font size in pixels, equal to _unrounded font_size_ * _resolution_ \u00f7 `72.0`.",
-"format": "double",
-"type": "number"
-},
-"smallcaps": {
-"description": "Whether the text is in small caps. This feature is not supported yet.",
-"type": "boolean"
-},
-"strikeout": {
-"description": "Whether the text is strikethrough. This feature is not supported yet.",
-"type": "boolean"
-},
-"subscript": {
-"description": "Whether the text is a subscript. This feature is not supported yet.",
-"type": "boolean"
-},
-"superscript": {
-"description": "Whether the text is a superscript. This feature is not supported yet.",
-"type": "boolean"
-},
-"textColor": {
-"$ref": "GoogleTypeColor",
-"description": "Color of the text."
-},
-"underlined": {
-"description": "Whether the text is underlined.",
-"type": "boolean"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageVisualElement": {
-"description": "Detected non-text visual elements e.g. checkbox, signature etc. on the page.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageVisualElement",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for VisualElement."
-},
-"type": {
-"description": "Type of the VisualElement.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentProvenance": {
-"description": "Structure to identify provenance relationships between annotations in different revisions.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"properties": {
-"id": {
-"deprecated": true,
-"description": "The Id of this operation. Needs to be unique within the scope of the revision.",
-"format": "int32",
-"type": "integer"
-},
-"parents": {
-"description": "References to the original elements that are replaced.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenanceParent"
-},
-"type": "array"
-},
-"revision": {
-"deprecated": true,
-"description": "The index of the revision that produced this element.",
-"format": "int32",
-"type": "integer"
-},
-"type": {
-"description": "The type of provenance operation.",
-"enum": [
-"OPERATION_TYPE_UNSPECIFIED",
-"ADD",
-"REMOVE",
-"UPDATE",
-"REPLACE",
-"EVAL_REQUESTED",
-"EVAL_APPROVED",
-"EVAL_SKIPPED"
-],
-"enumDeprecated": [
-false,
-false,
-false,
-false,
-false,
-true,
-true,
-true
-],
-"enumDescriptions": [
-"Operation type unspecified. If no operation is specified a provenance entry is simply used to match against a `parent`.",
-"Add an element.",
-"Remove an element identified by `parent`.",
-"Updates any fields within the given provenance scope of the message. It overwrites the fields rather than replacing them. Use this when you want to update a field value of an entity without also updating all the child properties.",
-"Currently unused. Replace an element identified by `parent`.",
-"Deprecated. Request human review for the element identified by `parent`.",
-"Deprecated. Element is reviewed and approved at human review, confidence will be set to 1.0.",
-"Deprecated. Element is skipped in the validation process."
-],
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentProvenanceParent": {
-"description": "The parent element the current element is based on. Used for referencing/aligning, removal and replacement operations.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentProvenanceParent",
-"properties": {
-"id": {
-"deprecated": true,
-"description": "The id of the parent provenance.",
-"format": "int32",
-"type": "integer"
-},
-"index": {
-"description": "The index of the parent item in the corresponding item list (eg. list of entities, properties within entities, etc.) in the parent revision.",
-"format": "int32",
-"type": "integer"
-},
-"revision": {
-"description": "The index of the index into current revision's parent_ids list.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentRevision": {
-"description": "Contains past or forward revisions of this document.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentRevision",
-"properties": {
-"agent": {
-"description": "If the change was made by a person specify the name or id of that person.",
-"type": "string"
-},
-"createTime": {
-"description": "The time that the revision was created, internally generated by doc proto storage at the time of create.",
-"format": "google-datetime",
-"type": "string"
-},
-"humanReview": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentRevisionHumanReview",
-"description": "Human Review information of this revision."
-},
-"id": {
-"description": "Id of the revision, internally generated by doc proto storage. Unique within the context of the document.",
-"type": "string"
-},
-"parent": {
-"deprecated": true,
-"description": "The revisions that this revision is based on. This can include one or more parent (when documents are merged.) This field represents the index into the `revisions` field.",
-"items": {
-"format": "int32",
-"type": "integer"
-},
-"type": "array"
-},
-"parentIds": {
-"description": "The revisions that this revision is based on. Must include all the ids that have anything to do with this revision - eg. there are `provenance.parent.revision` fields that index into this field.",
-"items": {
-"type": "string"
-},
-"type": "array"
-},
-"processor": {
-"description": "If the annotation was made by processor identify the processor by its resource name.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentRevisionHumanReview": {
-"description": "Human Review information of the document.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentRevisionHumanReview",
-"properties": {
-"state": {
-"description": "Human review state. e.g. `requested`, `succeeded`, `rejected`.",
-"type": "string"
-},
-"stateMessage": {
-"description": "A message providing more details about the current state of processing. For example, the rejection reason when the state is `rejected`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentShardInfo": {
-"description": "For a large document, sharding may be performed to produce several document shards. Each document shard contains this field to detail which shard it is.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentShardInfo",
-"properties": {
-"shardCount": {
-"description": "Total number of shards.",
-"format": "int64",
-"type": "string"
-},
-"shardIndex": {
-"description": "The 0-based index of this shard.",
-"format": "int64",
-"type": "string"
-},
-"textOffset": {
-"description": "The index of the first character in Document.text in the overall document global text.",
-"format": "int64",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentStyle": {
-"description": "Annotation for common text style attributes. This adheres to CSS conventions as much as possible.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentStyle",
-"properties": {
-"backgroundColor": {
-"$ref": "GoogleTypeColor",
-"description": "Text background color."
-},
-"color": {
-"$ref": "GoogleTypeColor",
-"description": "Text color."
-},
-"fontFamily": {
-"description": "Font family such as `Arial`, `Times New Roman`. https://www.w3schools.com/cssref/pr_font_font-family.asp",
-"type": "string"
-},
-"fontSize": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentStyleFontSize",
-"description": "Font size."
-},
-"fontWeight": {
-"description": "[Font weight](https://www.w3schools.com/cssref/pr_font_weight.asp). Possible values are `normal`, `bold`, `bolder`, and `lighter`.",
-"type": "string"
-},
-"textAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentTextAnchor",
-"description": "Text anchor indexing into the Document.text."
-},
-"textDecoration": {
-"description": "[Text decoration](https://www.w3schools.com/cssref/pr_text_text-decoration.asp). Follows CSS standard. ",
-"type": "string"
-},
-"textStyle": {
-"description": "[Text style](https://www.w3schools.com/cssref/pr_font_font-style.asp). Possible values are `normal`, `italic`, and `oblique`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentStyleFontSize": {
-"description": "Font size with unit.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentStyleFontSize",
-"properties": {
-"size": {
-"description": "Font size for the text.",
-"format": "float",
-"type": "number"
-},
-"unit": {
-"description": "Unit for the font size. Follows CSS naming (such as `in`, `px`, and `pt`).",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentTextAnchor": {
-"description": "Text reference indexing into the Document.text.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentTextAnchor",
-"properties": {
-"content": {
-"description": "Contains the content of the text span so that users do not have to look it up in the text_segments. It is always populated for formFields.",
-"type": "string"
-},
-"textSegments": {
-"description": "The text segments from the Document.text.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentTextAnchorTextSegment"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentTextAnchorTextSegment": {
-"description": "A text segment in the Document.text. The indices may be out of bounds which indicate that the text extends into another document shard for large sharded documents. See ShardInfo.text_offset",
-"id": "GoogleCloudDocumentaiV1beta1DocumentTextAnchorTextSegment",
-"properties": {
-"endIndex": {
-"description": "TextSegment half open end UTF-8 char index in the Document.text.",
-"format": "int64",
-"type": "string"
-},
-"startIndex": {
-"description": "TextSegment start UTF-8 char index in the Document.text.",
-"format": "int64",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentTextChange": {
-"description": "This message is used for text changes aka. OCR corrections.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentTextChange",
-"properties": {
-"changedText": {
-"description": "The text that replaces the text identified in the `text_anchor`.",
-"type": "string"
-},
-"provenance": {
-"deprecated": true,
-"description": "The history of this annotation.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance"
-},
-"type": "array"
-},
-"textAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentTextAnchor",
-"description": "Provenance of the correction. Text anchor indexing into the Document.text. There can only be a single `TextAnchor.text_segments` element. If the start and end index of the text segment are the same, the text change is inserted before that index."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1GcsDestination": {
-"description": "The Google Cloud Storage location where the output file will be written to.",
-"id": "GoogleCloudDocumentaiV1beta1GcsDestination",
-"properties": {
-"uri": {
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1GcsSource": {
-"description": "The Google Cloud Storage location where the input file will be read from.",
-"id": "GoogleCloudDocumentaiV1beta1GcsSource",
-"properties": {
-"uri": {
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1InputConfig": {
-"description": "The desired input location and metadata.",
-"id": "GoogleCloudDocumentaiV1beta1InputConfig",
-"properties": {
-"gcsSource": {
-"$ref": "GoogleCloudDocumentaiV1beta1GcsSource",
-"description": "The Google Cloud Storage location to read the input from. This must be a single file."
-},
-"mimeType": {
-"description": "Required. Mimetype of the input. Current supported mimetypes are application/pdf, image/tiff, and image/gif. In addition, application/json type is supported for requests with ProcessDocumentRequest.automl_params field set. The JSON file needs to be in Document format.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1NormalizedVertex": {
-"description": "A vertex represents a 2D point in the image. NOTE: the normalized vertex coordinates are relative to the original image and range from 0 to 1.",
-"id": "GoogleCloudDocumentaiV1beta1NormalizedVertex",
-"properties": {
-"x": {
-"description": "X coordinate.",
-"format": "float",
-"type": "number"
-},
-"y": {
-"description": "Y coordinate (starts from the top of the image).",
-"format": "float",
-"type": "number"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1OperationMetadata": {
-"description": "Contains metadata for the BatchProcessDocuments operation.",
-"id": "GoogleCloudDocumentaiV1beta1OperationMetadata",
-"properties": {
-"createTime": {
-"description": "The creation time of the operation.",
-"format": "google-datetime",
-"type": "string"
-},
-"state": {
-"description": "The state of the current batch processing.",
-"enum": [
-"STATE_UNSPECIFIED",
-"ACCEPTED",
-"WAITING",
-"RUNNING",
-"SUCCEEDED",
-"CANCELLED",
-"FAILED"
-],
-"enumDescriptions": [
-"The default value. This value is used if the state is omitted.",
-"Request is received.",
-"Request operation is waiting for scheduling.",
-"Request is being processed.",
-"The batch processing completed successfully.",
-"The batch processing was cancelled.",
-"The batch processing has failed."
-],
-"type": "string"
-},
-"stateMessage": {
-"description": "A message providing more details about the current state of processing.",
-"type": "string"
-},
-"updateTime": {
-"description": "The last update time of the operation.",
-"format": "google-datetime",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1OutputConfig": {
-"description": "The desired output location and metadata.",
-"id": "GoogleCloudDocumentaiV1beta1OutputConfig",
-"properties": {
-"gcsDestination": {
-"$ref": "GoogleCloudDocumentaiV1beta1GcsDestination",
-"description": "The Google Cloud Storage location to write the output to."
-},
-"pagesPerShard": {
-"description": "The max number of pages to include into each output Document shard JSON on Google Cloud Storage. The valid range is [1, 100]. If not specified, the default value is 20. For example, for one pdf file with 100 pages, 100 parsed pages will be produced. If `pages_per_shard` = 20, then 5 Document shard JSON files each containing 20 parsed pages will be written under the prefix OutputConfig.gcs_destination.uri and suffix pages-x-to-y.json where x and y are 1-indexed page numbers. Example GCS outputs with 157 pages and pages_per_shard = 50: pages-001-to-050.json pages-051-to-100.json pages-101-to-150.json pages-151-to-157.json",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1ProcessDocumentResponse": {
-"description": "Response to a single document processing request.",
-"id": "GoogleCloudDocumentaiV1beta1ProcessDocumentResponse",
-"properties": {
-"inputConfig": {
-"$ref": "GoogleCloudDocumentaiV1beta1InputConfig",
-"description": "Information about the input file. This is the same as the corresponding input config in the request."
-},
-"outputConfig": {
-"$ref": "GoogleCloudDocumentaiV1beta1OutputConfig",
-"description": "The output location of the parsed responses. The responses are written to this location as JSON-serialized `Document` objects."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1Vertex": {
-"description": "A vertex represents a 2D point in the image. NOTE: the vertex coordinates are in the same scale as the original image.",
-"id": "GoogleCloudDocumentaiV1beta1Vertex",
-"properties": {
-"x": {
-"description": "X coordinate.",
-"format": "int32",
-"type": "integer"
-},
-"y": {
-"description": "Y coordinate (starts from the top of the image).",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2Barcode": {
-"description": "Encodes the detailed information of a barcode.",
-"id": "GoogleCloudDocumentaiV1beta2Barcode",
-"properties": {
-"format": {
-"description": "Format of a barcode. The supported formats are: - `CODE_128`: Code 128 type. - `CODE_39`: Code 39 type. - `CODE_93`: Code 93 type. - `CODABAR`: Codabar type. - `DATA_MATRIX`: 2D Data Matrix type. - `ITF`: ITF type. - `EAN_13`: EAN-13 type. - `EAN_8`: EAN-8 type. - `QR_CODE`: 2D QR code type. - `UPC_A`: UPC-A type. - `UPC_E`: UPC-E type. - `PDF417`: PDF417 type. - `AZTEC`: 2D Aztec code type. - `DATABAR`: GS1 DataBar code type.",
-"type": "string"
-},
-"rawValue": {
-"description": "Raw value encoded in the barcode. For example: `'MEBKM:TITLE:Google;URL:https://www.google.com;;'`.",
-"type": "string"
-},
-"valueFormat": {
-"description": "Value format describes the format of the value that a barcode encodes. The supported formats are: - `CONTACT_INFO`: Contact information. - `EMAIL`: Email address. - `ISBN`: ISBN identifier. - `PHONE`: Phone number. - `PRODUCT`: Product. - `SMS`: SMS message. - `TEXT`: Text string. - `URL`: URL address. - `WIFI`: Wifi information. - `GEO`: Geo-localization. - `CALENDAR_EVENT`: Calendar event. - `DRIVER_LICENSE`: Driver's license.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2BatchProcessDocumentsResponse": {
-"description": "Response to an batch document processing request. This is returned in the LRO Operation after the operation is complete.",
-"id": "GoogleCloudDocumentaiV1beta2BatchProcessDocumentsResponse",
-"properties": {
-"responses": {
-"description": "Responses for each individual document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2ProcessDocumentResponse"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2BoundingPoly": {
-"description": "A bounding polygon for the detected image annotation.",
-"id": "GoogleCloudDocumentaiV1beta2BoundingPoly",
-"properties": {
-"normalizedVertices": {
-"description": "The bounding polygon normalized vertices.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2NormalizedVertex"
-},
-"type": "array"
-},
-"vertices": {
-"description": "The bounding polygon vertices.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2Vertex"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2Document": {
-"description": "Document represents the canonical document resource in Document AI. It is an interchange format that provides insights into documents and allows for collaboration between users and Document AI to iterate and optimize for quality.",
-"id": "GoogleCloudDocumentaiV1beta2Document",
-"properties": {
-"chunkedDocument": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocument",
-"description": "Document chunked based on chunking config."
-},
-"content": {
-"description": "Optional. Inline document content, represented as a stream of bytes. Note: As with all `bytes` fields, protobuffers use a pure binary representation, whereas JSON representations use base64.",
-"format": "byte",
-"type": "string"
-},
-"documentLayout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayout",
-"description": "Parsed layout of the document."
-},
-"entities": {
-"description": "A list of entities detected on Document.text. For document shards, entities in this list may cross shard boundaries.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentEntity"
-},
-"type": "array"
-},
-"entityRelations": {
-"description": "Placeholder. Relationship among Document.entities.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentEntityRelation"
-},
-"type": "array"
-},
-"error": {
-"$ref": "GoogleRpcStatus",
-"description": "Any error that occurred while processing this document."
-},
-"labels": {
-"description": "Labels for this document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentLabel"
-},
-"type": "array"
-},
-"mimeType": {
-"description": "An IANA published [media type (MIME type)](https://www.iana.org/assignments/media-types/media-types.xhtml).",
-"type": "string"
-},
-"pages": {
-"description": "Visual page layout for the Document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPage"
-},
-"type": "array"
-},
-"revisions": {
-"description": "Placeholder. Revision history of this document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentRevision"
-},
-"type": "array"
-},
-"shardInfo": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentShardInfo",
-"description": "Information about the sharding if this document is sharded part of a larger document. If the document is not sharded, this message is not specified."
-},
-"text": {
-"description": "Optional. UTF-8 encoded text in reading order from the document.",
-"type": "string"
-},
-"textChanges": {
-"description": "Placeholder. A list of text corrections made to Document.text. This is usually used for annotating corrections to OCR mistakes. Text changes for a given revision may not overlap with each other.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentTextChange"
-},
-"type": "array"
-},
-"textStyles": {
-"deprecated": true,
-"description": "Styles for the Document.text.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentStyle"
-},
-"type": "array"
-},
-"uri": {
-"description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. For more information, refer to [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris).",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentChunkedDocument": {
-"description": "Represents the chunks that the document is divided into.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocument",
-"properties": {
-"chunks": {
-"description": "List of chunks.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunk"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunk": {
-"description": "Represents a chunk.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunk",
-"properties": {
-"chunkId": {
-"description": "ID of the chunk.",
-"type": "string"
-},
-"content": {
-"description": "Text content of the chunk.",
-"type": "string"
-},
-"pageFooters": {
-"description": "Page footers associated with the chunk.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageFooter"
-},
-"type": "array"
-},
-"pageHeaders": {
-"description": "Page headers associated with the chunk.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageHeader"
-},
-"type": "array"
-},
-"pageSpan": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageSpan",
-"description": "Page span of the chunk."
-},
-"sourceBlockIds": {
-"description": "Unused.",
-"items": {
-"type": "string"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageFooter": {
-"description": "Represents the page footer associated with the chunk.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageFooter",
-"properties": {
-"pageSpan": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageSpan",
-"description": "Page span of the footer."
-},
-"text": {
-"description": "Footer in text format.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageHeader": {
-"description": "Represents the page header associated with the chunk.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageHeader",
-"properties": {
-"pageSpan": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageSpan",
-"description": "Page span of the header."
-},
-"text": {
-"description": "Header in text format.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageSpan": {
-"description": "Represents where the chunk starts and ends in the document.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageSpan",
-"properties": {
-"pageEnd": {
-"description": "Page where chunk ends in the document.",
-"format": "int32",
-"type": "integer"
-},
-"pageStart": {
-"description": "Page where chunk starts in the document.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayout": {
-"description": "Represents the parsed layout of a document as a collection of blocks that the document is divided into.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayout",
-"properties": {
-"blocks": {
-"description": "List of blocks in the document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlock"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlock": {
-"description": "Represents a block. A block could be one of the various types (text, table, list) supported.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlock",
-"properties": {
-"blockId": {
-"description": "ID of the block.",
-"type": "string"
-},
-"listBlock": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutListBlock",
-"description": "Block consisting of list content/structure."
-},
-"pageSpan": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutPageSpan",
-"description": "Page span of the block."
-},
-"tableBlock": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableBlock",
-"description": "Block consisting of table content/structure."
-},
-"textBlock": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTextBlock",
-"description": "Block consisting of text content."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutListBlock": {
-"description": "Represents a list type block.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutListBlock",
-"properties": {
-"listEntries": {
-"description": "List entries that constitute a list block.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutListEntry"
-},
-"type": "array"
-},
-"type": {
-"description": "Type of the list_entries (if exist). Available options are `ordered` and `unordered`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutListEntry": {
-"description": "Represents an entry in the list.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutListEntry",
-"properties": {
-"blocks": {
-"description": "A list entry is a list of blocks. Repeated blocks support further hierarchies and nested blocks.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlock"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutPageSpan": {
-"description": "Represents where the block starts and ends in the document.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutPageSpan",
-"properties": {
-"pageEnd": {
-"description": "Page where block ends in the document.",
-"format": "int32",
-"type": "integer"
-},
-"pageStart": {
-"description": "Page where block starts in the document.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableBlock": {
-"description": "Represents a table type block.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableBlock",
-"properties": {
-"bodyRows": {
-"description": "Body rows containing main table content.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableRow"
-},
-"type": "array"
-},
-"caption": {
-"description": "Table caption/title.",
-"type": "string"
-},
-"headerRows": {
-"description": "Header rows at the top of the table.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableRow"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableCell": {
-"description": "Represents a cell in a table row.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableCell",
-"properties": {
-"blocks": {
-"description": "A table cell is a list of blocks. Repeated blocks support further hierarchies and nested blocks.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlock"
-},
-"type": "array"
-},
-"colSpan": {
-"description": "How many columns this cell spans.",
-"format": "int32",
-"type": "integer"
-},
-"rowSpan": {
-"description": "How many rows this cell spans.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableRow": {
-"description": "Represents a row in a table.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableRow",
-"properties": {
-"cells": {
-"description": "A table row is a list of table cells.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableCell"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTextBlock": {
-"description": "Represents a text type block.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTextBlock",
-"properties": {
-"blocks": {
-"description": "A text block could further have child blocks. Repeated blocks support further hierarchies and nested blocks.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlock"
-},
-"type": "array"
-},
-"text": {
-"description": "Text content stored in the block.",
-"type": "string"
-},
-"type": {
-"description": "Type of the text in the block. Available options are: `paragraph`, `subtitle`, `heading-1`, `heading-2`, `heading-3`, `heading-4`, `heading-5`, `header`, `footer`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentEntity": {
-"description": "An entity that could be a phrase in the text or a property that belongs to the document. It is a known entity type, such as a person, an organization, or location.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentEntity",
-"properties": {
-"confidence": {
-"description": "Optional. Confidence of detected Schema entity. Range `[0, 1]`.",
-"format": "float",
-"type": "number"
-},
-"id": {
-"description": "Optional. Canonical id. This will be a unique value in the entity list for this document.",
-"type": "string"
-},
-"mentionId": {
-"description": "Optional. Deprecated. Use `id` field instead.",
-"type": "string"
-},
-"mentionText": {
-"description": "Optional. Text value of the entity e.g. `1600 Amphitheatre Pkwy`.",
-"type": "string"
-},
-"normalizedValue": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentEntityNormalizedValue",
-"description": "Optional. Normalized entity value. Absent if the extracted value could not be converted or the type (e.g. address) is not supported for certain parsers. This field is also only populated for certain supported document types."
-},
-"pageAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageAnchor",
-"description": "Optional. Represents the provenance of this entity wrt. the location on the page where it was found."
-},
-"properties": {
-"description": "Optional. Entities can be nested to form a hierarchical data structure representing the content in the document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentEntity"
-},
-"type": "array"
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"description": "Optional. The history of this annotation."
-},
-"redacted": {
-"description": "Optional. Whether the entity will be redacted for de-identification purposes.",
-"type": "boolean"
-},
-"textAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentTextAnchor",
-"description": "Optional. Provenance of the entity. Text anchor indexing into the Document.text."
-},
-"type": {
-"description": "Required. Entity type from a schema e.g. `Address`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentEntityNormalizedValue": {
-"description": "Parsed and normalized entity value.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentEntityNormalizedValue",
-"properties": {
-"addressValue": {
-"$ref": "GoogleTypePostalAddress",
-"description": "Postal address. See also: https://github.com/googleapis/googleapis/blob/master/google/type/postal_address.proto"
-},
-"booleanValue": {
-"description": "Boolean value. Can be used for entities with binary values, or for checkboxes.",
-"type": "boolean"
-},
-"dateValue": {
-"$ref": "GoogleTypeDate",
-"description": "Date value. Includes year, month, day. See also: https://github.com/googleapis/googleapis/blob/master/google/type/date.proto"
-},
-"datetimeValue": {
-"$ref": "GoogleTypeDateTime",
-"description": "DateTime value. Includes date, time, and timezone. See also: https://github.com/googleapis/googleapis/blob/master/google/type/datetime.proto"
-},
-"floatValue": {
-"description": "Float value.",
-"format": "float",
-"type": "number"
-},
-"integerValue": {
-"description": "Integer value.",
-"format": "int32",
-"type": "integer"
-},
-"moneyValue": {
-"$ref": "GoogleTypeMoney",
-"description": "Money value. See also: https://github.com/googleapis/googleapis/blob/master/google/type/money.proto"
-},
-"text": {
-"description": "Optional. An optional field to store a normalized string. For some entity types, one of respective `structured_value` fields may also be populated. Also not all the types of `structured_value` will be normalized. For example, some processors may not generate `float` or `integer` normalized text by default. Below are sample formats mapped to structured values. - Money/Currency type (`money_value`) is in the ISO 4217 text format. - Date type (`date_value`) is in the ISO 8601 text format. - Datetime type (`datetime_value`) is in the ISO 8601 text format.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentEntityRelation": {
-"description": "Relationship between Entities.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentEntityRelation",
-"properties": {
-"objectId": {
-"description": "Object entity id.",
-"type": "string"
-},
-"relation": {
-"description": "Relationship description.",
-"type": "string"
-},
-"subjectId": {
-"description": "Subject entity id.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentLabel": {
-"description": "Label attaches schema information and/or other metadata to segments within a Document. Multiple Labels on a single field can denote either different labels, different instances of the same label created at different times, or some combination of both.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentLabel",
-"properties": {
-"automlModel": {
-"description": "Label is generated AutoML model. This field stores the full resource name of the AutoML model. Format: `projects/{project-id}/locations/{location-id}/models/{model-id}`",
-"type": "string"
-},
-"confidence": {
-"description": "Confidence score between 0 and 1 for label assignment.",
-"format": "float",
-"type": "number"
-},
-"name": {
-"description": "Name of the label. When the label is generated from AutoML Text Classification model, this field represents the name of the category.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPage": {
-"description": "A page in a Document.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPage",
-"properties": {
-"blocks": {
-"description": "A list of visually detected text blocks on the page. A block has a set of lines (collected into paragraphs) that have a common line-spacing and orientation.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageBlock"
-},
-"type": "array"
-},
-"detectedBarcodes": {
-"description": "A list of detected barcodes.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedBarcode"
-},
-"type": "array"
-},
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"dimension": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDimension",
-"description": "Physical dimension of the page."
-},
-"formFields": {
-"description": "A list of visually detected form fields on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageFormField"
-},
-"type": "array"
-},
-"image": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageImage",
-"description": "Rendered image for this page. This image is preprocessed to remove any skew, rotation, and distortions such that the annotation bounding boxes can be upright and axis-aligned."
-},
-"imageQualityScores": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores",
-"description": "Image quality scores."
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for the page."
-},
-"lines": {
-"description": "A list of visually detected text lines on the page. A collection of tokens that a human would perceive as a line.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLine"
-},
-"type": "array"
-},
-"pageNumber": {
-"description": "1-based index for current Page in a parent Document. Useful when a page is taken out of a Document for individual processing.",
-"format": "int32",
-"type": "integer"
-},
-"paragraphs": {
-"description": "A list of visually detected text paragraphs on the page. A collection of lines that a human would perceive as a paragraph.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageParagraph"
-},
-"type": "array"
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"deprecated": true,
-"description": "The history of this page."
-},
-"symbols": {
-"description": "A list of visually detected symbols on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageSymbol"
-},
-"type": "array"
-},
-"tables": {
-"description": "A list of visually detected tables on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageTable"
-},
-"type": "array"
-},
-"tokens": {
-"description": "A list of visually detected tokens on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageToken"
-},
-"type": "array"
-},
-"transforms": {
-"description": "Transformation matrices that were applied to the original document image to produce Page.image.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageMatrix"
-},
-"type": "array"
-},
-"visualElements": {
-"description": "A list of detected non-text visual elements e.g. checkbox, signature etc. on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageVisualElement"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageAnchor": {
-"description": "Referencing the visual context of the entity in the Document.pages. Page anchors can be cross-page, consist of multiple bounding polygons and optionally reference specific layout element types.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageAnchor",
-"properties": {
-"pageRefs": {
-"description": "One or more references to visual page elements",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageAnchorPageRef"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageAnchorPageRef": {
-"description": "Represents a weak reference to a page element within a document.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageAnchorPageRef",
-"properties": {
-"boundingPoly": {
-"$ref": "GoogleCloudDocumentaiV1beta2BoundingPoly",
-"description": "Optional. Identifies the bounding polygon of a layout element on the page. If `layout_type` is set, the bounding polygon must be exactly the same to the layout element it's referring to."
-},
-"confidence": {
-"description": "Optional. Confidence of detected page element, if applicable. Range `[0, 1]`.",
-"format": "float",
-"type": "number"
-},
-"layoutId": {
-"deprecated": true,
-"description": "Optional. Deprecated. Use PageRef.bounding_poly instead.",
-"type": "string"
-},
-"layoutType": {
-"description": "Optional. The type of the layout element that is being referenced if any.",
-"enum": [
-"LAYOUT_TYPE_UNSPECIFIED",
-"BLOCK",
-"PARAGRAPH",
-"LINE",
-"TOKEN",
-"VISUAL_ELEMENT",
-"TABLE",
-"FORM_FIELD"
-],
-"enumDescriptions": [
-"Layout Unspecified.",
-"References a Page.blocks element.",
-"References a Page.paragraphs element.",
-"References a Page.lines element.",
-"References a Page.tokens element.",
-"References a Page.visual_elements element.",
-"Refrrences a Page.tables element.",
-"References a Page.form_fields element."
-],
-"type": "string"
-},
-"page": {
-"description": "Required. Index into the Document.pages element, for example using `Document.pages` to locate the related page element. This field is skipped when its value is the default `0`. See https://developers.google.com/protocol-buffers/docs/proto3#json.",
-"format": "int64",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageBlock": {
-"description": "A block has a set of lines (collected into paragraphs) that have a common line-spacing and orientation.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageBlock",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for Block."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"deprecated": true,
-"description": "The history of this annotation."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageDetectedBarcode": {
-"description": "A detected barcode.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedBarcode",
-"properties": {
-"barcode": {
-"$ref": "GoogleCloudDocumentaiV1beta2Barcode",
-"description": "Detailed barcode information of the DetectedBarcode."
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for DetectedBarcode."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage": {
-"description": "Detected language for a structural component.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage",
-"properties": {
-"confidence": {
-"description": "Confidence of detected language. Range `[0, 1]`.",
-"format": "float",
-"type": "number"
-},
-"languageCode": {
-"description": "The [BCP-47 language code](https://www.unicode.org/reports/tr35/#Unicode_locale_identifier), such as `en-US` or `sr-Latn`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageDimension": {
-"description": "Dimension for the page.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageDimension",
-"properties": {
-"height": {
-"description": "Page height.",
-"format": "float",
-"type": "number"
-},
-"unit": {
-"description": "Dimension unit.",
-"type": "string"
-},
-"width": {
-"description": "Page width.",
-"format": "float",
-"type": "number"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageFormField": {
-"description": "A form field detected on the page.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageFormField",
-"properties": {
-"correctedKeyText": {
-"description": "Created for Labeling UI to export key text. If corrections were made to the text identified by the `field_name.text_anchor`, this field will contain the correction.",
-"type": "string"
-},
-"correctedValueText": {
-"description": "Created for Labeling UI to export value text. If corrections were made to the text identified by the `field_value.text_anchor`, this field will contain the correction.",
-"type": "string"
-},
-"fieldName": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for the FormField name. e.g. `Address`, `Email`, `Grand total`, `Phone number`, etc."
-},
-"fieldValue": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for the FormField value."
-},
-"nameDetectedLanguages": {
-"description": "A list of detected languages for name together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"description": "The history of this annotation."
-},
-"valueDetectedLanguages": {
-"description": "A list of detected languages for value together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"valueType": {
-"description": "If the value is non-textual, this field represents the type. Current valid values are: - blank (this indicates the `field_value` is normal text) - `unfilled_checkbox` - `filled_checkbox`",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageImage": {
-"description": "Rendered image contents for this page.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageImage",
-"properties": {
-"content": {
-"description": "Raw byte content of the image.",
-"format": "byte",
-"type": "string"
-},
-"height": {
-"description": "Height of the image in pixels.",
-"format": "int32",
-"type": "integer"
-},
-"mimeType": {
-"description": "Encoding [media type (MIME type)](https://www.iana.org/assignments/media-types/media-types.xhtml) for the image.",
-"type": "string"
-},
-"width": {
-"description": "Width of the image in pixels.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores": {
-"description": "Image quality scores for the page image.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores",
-"properties": {
-"detectedDefects": {
-"description": "A list of detected defects.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScoresDetectedDefect"
-},
-"type": "array"
-},
-"qualityScore": {
-"description": "The overall quality score. Range `[0, 1]` where `1` is perfect quality.",
-"format": "float",
-"type": "number"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScoresDetectedDefect": {
-"description": "Image Quality Defects",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScoresDetectedDefect",
-"properties": {
-"confidence": {
-"description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence that the defect exists.",
-"format": "float",
-"type": "number"
-},
-"type": {
-"description": "Name of the defect type. Supported values are: - `quality/defect_blurry` - `quality/defect_noisy` - `quality/defect_dark` - `quality/defect_faint` - `quality/defect_text_too_small` - `quality/defect_document_cutoff` - `quality/defect_text_cutoff` - `quality/defect_glare`",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageLayout": {
-"description": "Visual element describing a layout unit on a page.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"properties": {
-"boundingPoly": {
-"$ref": "GoogleCloudDocumentaiV1beta2BoundingPoly",
-"description": "The bounding polygon for the Layout."
-},
-"confidence": {
-"description": "Confidence of the current Layout within context of the object this layout is for. e.g. confidence can be for a single token, a table, a visual element, etc. depending on context. Range `[0, 1]`.",
-"format": "float",
-"type": "number"
-},
-"orientation": {
-"description": "Detected orientation for the Layout.",
-"enum": [
-"ORIENTATION_UNSPECIFIED",
-"PAGE_UP",
-"PAGE_RIGHT",
-"PAGE_DOWN",
-"PAGE_LEFT"
-],
-"enumDescriptions": [
-"Unspecified orientation.",
-"Orientation is aligned with page up.",
-"Orientation is aligned with page right. Turn the head 90 degrees clockwise from upright to read.",
-"Orientation is aligned with page down. Turn the head 180 degrees from upright to read.",
-"Orientation is aligned with page left. Turn the head 90 degrees counterclockwise from upright to read."
-],
-"type": "string"
-},
-"textAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentTextAnchor",
-"description": "Text anchor indexing into the Document.text."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageLine": {
-"description": "A collection of tokens that a human would perceive as a line. Does not cross column boundaries, can be horizontal, vertical, etc.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageLine",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for Line."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"deprecated": true,
-"description": "The history of this annotation."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageMatrix": {
-"description": "Representation for transformation matrix, intended to be compatible and used with OpenCV format for image manipulation.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageMatrix",
-"properties": {
-"cols": {
-"description": "Number of columns in the matrix.",
-"format": "int32",
-"type": "integer"
-},
-"data": {
-"description": "The matrix data.",
-"format": "byte",
-"type": "string"
-},
-"rows": {
-"description": "Number of rows in the matrix.",
-"format": "int32",
-"type": "integer"
-},
-"type": {
-"description": "This encodes information about what data type the matrix uses. For example, 0 (CV_8U) is an unsigned 8-bit image. For the full list of OpenCV primitive data types, please refer to https://docs.opencv.org/4.3.0/d1/d1b/group__core__hal__interface.html",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageParagraph": {
-"description": "A collection of lines that a human would perceive as a paragraph.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageParagraph",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for Paragraph."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"deprecated": true,
-"description": "The history of this annotation."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageSymbol": {
-"description": "A detected symbol.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageSymbol",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for Symbol."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageTable": {
-"description": "A table representation similar to HTML table structure.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageTable",
-"properties": {
-"bodyRows": {
-"description": "Body rows of the table.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageTableTableRow"
-},
-"type": "array"
-},
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"headerRows": {
-"description": "Header rows of the table.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageTableTableRow"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for Table."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"deprecated": true,
-"description": "The history of this table."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageTableTableCell": {
-"description": "A cell representation inside the table.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageTableTableCell",
-"properties": {
-"colSpan": {
-"description": "How many columns this cell spans.",
-"format": "int32",
-"type": "integer"
-},
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for TableCell."
-},
-"rowSpan": {
-"description": "How many rows this cell spans.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageTableTableRow": {
-"description": "A row of table cells.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageTableTableRow",
-"properties": {
-"cells": {
-"description": "Cells that make up this row.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageTableTableCell"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageToken": {
-"description": "A detected token.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageToken",
-"properties": {
-"detectedBreak": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageTokenDetectedBreak",
-"description": "Detected break at the end of a Token."
-},
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for Token."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"deprecated": true,
-"description": "The history of this annotation."
-},
-"styleInfo": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageTokenStyleInfo",
-"description": "Text style attributes."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageTokenDetectedBreak": {
-"description": "Detected break at the end of a Token.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageTokenDetectedBreak",
-"properties": {
-"type": {
-"description": "Detected break type.",
-"enum": [
-"TYPE_UNSPECIFIED",
-"SPACE",
-"WIDE_SPACE",
-"HYPHEN"
-],
-"enumDescriptions": [
-"Unspecified break type.",
-"A single whitespace.",
-"A wider whitespace.",
-"A hyphen that indicates that a token has been split across lines."
-],
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageTokenStyleInfo": {
-"description": "Font and other text style attributes.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageTokenStyleInfo",
-"properties": {
-"backgroundColor": {
-"$ref": "GoogleTypeColor",
-"description": "Color of the background."
-},
-"bold": {
-"description": "Whether the text is bold (equivalent to font_weight is at least `700`).",
-"type": "boolean"
-},
-"fontSize": {
-"description": "Font size in points (`1` point is `\u00b9\u2044\u2087\u2082` inches).",
-"format": "int32",
-"type": "integer"
-},
-"fontType": {
-"description": "Name or style of the font.",
-"type": "string"
-},
-"fontWeight": {
-"description": "TrueType weight on a scale `100` (thin) to `1000` (ultra-heavy). Normal is `400`, bold is `700`.",
-"format": "int32",
-"type": "integer"
-},
-"handwritten": {
-"description": "Whether the text is handwritten.",
-"type": "boolean"
-},
-"italic": {
-"description": "Whether the text is italic.",
-"type": "boolean"
-},
-"letterSpacing": {
-"description": "Letter spacing in points.",
-"format": "double",
-"type": "number"
-},
-"pixelFontSize": {
-"description": "Font size in pixels, equal to _unrounded font_size_ * _resolution_ \u00f7 `72.0`.",
-"format": "double",
-"type": "number"
-},
-"smallcaps": {
-"description": "Whether the text is in small caps. This feature is not supported yet.",
-"type": "boolean"
-},
-"strikeout": {
-"description": "Whether the text is strikethrough. This feature is not supported yet.",
-"type": "boolean"
-},
-"subscript": {
-"description": "Whether the text is a subscript. This feature is not supported yet.",
-"type": "boolean"
-},
-"superscript": {
-"description": "Whether the text is a superscript. This feature is not supported yet.",
-"type": "boolean"
-},
-"textColor": {
-"$ref": "GoogleTypeColor",
-"description": "Color of the text."
-},
-"underlined": {
-"description": "Whether the text is underlined.",
-"type": "boolean"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageVisualElement": {
-"description": "Detected non-text visual elements e.g. checkbox, signature etc. on the page.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageVisualElement",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for VisualElement."
-},
-"type": {
-"description": "Type of the VisualElement.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentProvenance": {
-"description": "Structure to identify provenance relationships between annotations in different revisions.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"properties": {
-"id": {
-"deprecated": true,
-"description": "The Id of this operation. Needs to be unique within the scope of the revision.",
-"format": "int32",
-"type": "integer"
-},
-"parents": {
-"description": "References to the original elements that are replaced.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenanceParent"
-},
-"type": "array"
-},
-"revision": {
-"deprecated": true,
-"description": "The index of the revision that produced this element.",
-"format": "int32",
-"type": "integer"
-},
-"type": {
-"description": "The type of provenance operation.",
-"enum": [
-"OPERATION_TYPE_UNSPECIFIED",
-"ADD",
-"REMOVE",
-"UPDATE",
-"REPLACE",
-"EVAL_REQUESTED",
-"EVAL_APPROVED",
-"EVAL_SKIPPED"
-],
-"enumDeprecated": [
-false,
-false,
-false,
-false,
-false,
-true,
-true,
-true
-],
-"enumDescriptions": [
-"Operation type unspecified. If no operation is specified a provenance entry is simply used to match against a `parent`.",
-"Add an element.",
-"Remove an element identified by `parent`.",
-"Updates any fields within the given provenance scope of the message. It overwrites the fields rather than replacing them. Use this when you want to update a field value of an entity without also updating all the child properties.",
-"Currently unused. Replace an element identified by `parent`.",
-"Deprecated. Request human review for the element identified by `parent`.",
-"Deprecated. Element is reviewed and approved at human review, confidence will be set to 1.0.",
-"Deprecated. Element is skipped in the validation process."
-],
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentProvenanceParent": {
-"description": "The parent element the current element is based on. Used for referencing/aligning, removal and replacement operations.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentProvenanceParent",
-"properties": {
-"id": {
-"deprecated": true,
-"description": "The id of the parent provenance.",
-"format": "int32",
-"type": "integer"
-},
-"index": {
-"description": "The index of the parent item in the corresponding item list (eg. list of entities, properties within entities, etc.) in the parent revision.",
-"format": "int32",
-"type": "integer"
-},
-"revision": {
-"description": "The index of the index into current revision's parent_ids list.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentRevision": {
-"description": "Contains past or forward revisions of this document.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentRevision",
-"properties": {
-"agent": {
-"description": "If the change was made by a person specify the name or id of that person.",
-"type": "string"
-},
-"createTime": {
-"description": "The time that the revision was created, internally generated by doc proto storage at the time of create.",
-"format": "google-datetime",
-"type": "string"
-},
-"humanReview": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentRevisionHumanReview",
-"description": "Human Review information of this revision."
-},
-"id": {
-"description": "Id of the revision, internally generated by doc proto storage. Unique within the context of the document.",
-"type": "string"
-},
-"parent": {
-"deprecated": true,
-"description": "The revisions that this revision is based on. This can include one or more parent (when documents are merged.) This field represents the index into the `revisions` field.",
-"items": {
-"format": "int32",
-"type": "integer"
-},
-"type": "array"
-},
-"parentIds": {
-"description": "The revisions that this revision is based on. Must include all the ids that have anything to do with this revision - eg. there are `provenance.parent.revision` fields that index into this field.",
-"items": {
-"type": "string"
-},
-"type": "array"
-},
-"processor": {
-"description": "If the annotation was made by processor identify the processor by its resource name.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentRevisionHumanReview": {
-"description": "Human Review information of the document.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentRevisionHumanReview",
-"properties": {
-"state": {
-"description": "Human review state. e.g. `requested`, `succeeded`, `rejected`.",
-"type": "string"
-},
-"stateMessage": {
-"description": "A message providing more details about the current state of processing. For example, the rejection reason when the state is `rejected`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentShardInfo": {
-"description": "For a large document, sharding may be performed to produce several document shards. Each document shard contains this field to detail which shard it is.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentShardInfo",
-"properties": {
-"shardCount": {
-"description": "Total number of shards.",
-"format": "int64",
-"type": "string"
-},
-"shardIndex": {
-"description": "The 0-based index of this shard.",
-"format": "int64",
-"type": "string"
-},
-"textOffset": {
-"description": "The index of the first character in Document.text in the overall document global text.",
-"format": "int64",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentStyle": {
-"description": "Annotation for common text style attributes. This adheres to CSS conventions as much as possible.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentStyle",
-"properties": {
-"backgroundColor": {
-"$ref": "GoogleTypeColor",
-"description": "Text background color."
-},
-"color": {
-"$ref": "GoogleTypeColor",
-"description": "Text color."
-},
-"fontFamily": {
-"description": "Font family such as `Arial`, `Times New Roman`. https://www.w3schools.com/cssref/pr_font_font-family.asp",
-"type": "string"
-},
-"fontSize": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentStyleFontSize",
-"description": "Font size."
-},
-"fontWeight": {
-"description": "[Font weight](https://www.w3schools.com/cssref/pr_font_weight.asp). Possible values are `normal`, `bold`, `bolder`, and `lighter`.",
-"type": "string"
-},
-"textAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentTextAnchor",
-"description": "Text anchor indexing into the Document.text."
-},
-"textDecoration": {
-"description": "[Text decoration](https://www.w3schools.com/cssref/pr_text_text-decoration.asp). Follows CSS standard. ",
-"type": "string"
-},
-"textStyle": {
-"description": "[Text style](https://www.w3schools.com/cssref/pr_font_font-style.asp). Possible values are `normal`, `italic`, and `oblique`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentStyleFontSize": {
-"description": "Font size with unit.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentStyleFontSize",
-"properties": {
-"size": {
-"description": "Font size for the text.",
-"format": "float",
-"type": "number"
-},
-"unit": {
-"description": "Unit for the font size. Follows CSS naming (such as `in`, `px`, and `pt`).",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentTextAnchor": {
-"description": "Text reference indexing into the Document.text.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentTextAnchor",
-"properties": {
-"content": {
-"description": "Contains the content of the text span so that users do not have to look it up in the text_segments. It is always populated for formFields.",
-"type": "string"
-},
-"textSegments": {
-"description": "The text segments from the Document.text.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentTextAnchorTextSegment"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentTextAnchorTextSegment": {
-"description": "A text segment in the Document.text. The indices may be out of bounds which indicate that the text extends into another document shard for large sharded documents. See ShardInfo.text_offset",
-"id": "GoogleCloudDocumentaiV1beta2DocumentTextAnchorTextSegment",
-"properties": {
-"endIndex": {
-"description": "TextSegment half open end UTF-8 char index in the Document.text.",
-"format": "int64",
-"type": "string"
-},
-"startIndex": {
-"description": "TextSegment start UTF-8 char index in the Document.text.",
-"format": "int64",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentTextChange": {
-"description": "This message is used for text changes aka. OCR corrections.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentTextChange",
-"properties": {
-"changedText": {
-"description": "The text that replaces the text identified in the `text_anchor`.",
-"type": "string"
-},
-"provenance": {
-"deprecated": true,
-"description": "The history of this annotation.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance"
-},
-"type": "array"
-},
-"textAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentTextAnchor",
-"description": "Provenance of the correction. Text anchor indexing into the Document.text. There can only be a single `TextAnchor.text_segments` element. If the start and end index of the text segment are the same, the text change is inserted before that index."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2GcsDestination": {
-"description": "The Google Cloud Storage location where the output file will be written to.",
-"id": "GoogleCloudDocumentaiV1beta2GcsDestination",
-"properties": {
-"uri": {
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2GcsSource": {
-"description": "The Google Cloud Storage location where the input file will be read from.",
-"id": "GoogleCloudDocumentaiV1beta2GcsSource",
-"properties": {
-"uri": {
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2InputConfig": {
-"description": "The desired input location and metadata.",
-"id": "GoogleCloudDocumentaiV1beta2InputConfig",
-"properties": {
-"contents": {
-"description": "Content in bytes, represented as a stream of bytes. Note: As with all `bytes` fields, proto buffer messages use a pure binary representation, whereas JSON representations use base64. This field only works for synchronous ProcessDocument method.",
-"format": "byte",
-"type": "string"
-},
-"gcsSource": {
-"$ref": "GoogleCloudDocumentaiV1beta2GcsSource",
-"description": "The Google Cloud Storage location to read the input from. This must be a single file."
-},
-"mimeType": {
-"description": "Required. Mimetype of the input. Current supported mimetypes are application/pdf, image/tiff, and image/gif. In addition, application/json type is supported for requests with ProcessDocumentRequest.automl_params field set. The JSON file needs to be in Document format.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2NormalizedVertex": {
-"description": "A vertex represents a 2D point in the image. NOTE: the normalized vertex coordinates are relative to the original image and range from 0 to 1.",
-"id": "GoogleCloudDocumentaiV1beta2NormalizedVertex",
-"properties": {
-"x": {
-"description": "X coordinate.",
-"format": "float",
-"type": "number"
-},
-"y": {
-"description": "Y coordinate (starts from the top of the image).",
-"format": "float",
-"type": "number"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2OperationMetadata": {
-"description": "Contains metadata for the BatchProcessDocuments operation.",
-"id": "GoogleCloudDocumentaiV1beta2OperationMetadata",
-"properties": {
-"createTime": {
-"description": "The creation time of the operation.",
-"format": "google-datetime",
-"type": "string"
-},
-"state": {
-"description": "The state of the current batch processing.",
-"enum": [
-"STATE_UNSPECIFIED",
-"ACCEPTED",
-"WAITING",
-"RUNNING",
-"SUCCEEDED",
-"CANCELLED",
-"FAILED"
-],
-"enumDescriptions": [
-"The default value. This value is used if the state is omitted.",
-"Request is received.",
-"Request operation is waiting for scheduling.",
-"Request is being processed.",
-"The batch processing completed successfully.",
-"The batch processing was cancelled.",
-"The batch processing has failed."
-],
-"type": "string"
-},
-"stateMessage": {
-"description": "A message providing more details about the current state of processing.",
-"type": "string"
-},
-"updateTime": {
-"description": "The last update time of the operation.",
-"format": "google-datetime",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2OutputConfig": {
-"description": "The desired output location and metadata.",
-"id": "GoogleCloudDocumentaiV1beta2OutputConfig",
-"properties": {
-"gcsDestination": {
-"$ref": "GoogleCloudDocumentaiV1beta2GcsDestination",
-"description": "The Google Cloud Storage location to write the output to."
-},
-"pagesPerShard": {
-"description": "The max number of pages to include into each output Document shard JSON on Google Cloud Storage. The valid range is [1, 100]. If not specified, the default value is 20. For example, for one pdf file with 100 pages, 100 parsed pages will be produced. If `pages_per_shard` = 20, then 5 Document shard JSON files each containing 20 parsed pages will be written under the prefix OutputConfig.gcs_destination.uri and suffix pages-x-to-y.json where x and y are 1-indexed page numbers. Example GCS outputs with 157 pages and pages_per_shard = 50: pages-001-to-050.json pages-051-to-100.json pages-101-to-150.json pages-151-to-157.json",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2ProcessDocumentResponse": {
-"description": "Response to a single document processing request.",
-"id": "GoogleCloudDocumentaiV1beta2ProcessDocumentResponse",
-"properties": {
-"inputConfig": {
-"$ref": "GoogleCloudDocumentaiV1beta2InputConfig",
-"description": "Information about the input file. This is the same as the corresponding input config in the request."
-},
-"outputConfig": {
-"$ref": "GoogleCloudDocumentaiV1beta2OutputConfig",
-"description": "The output location of the parsed responses. The responses are written to this location as JSON-serialized `Document` objects."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2Vertex": {
-"description": "A vertex represents a 2D point in the image. NOTE: the vertex coordinates are in the same scale as the original image.",
-"id": "GoogleCloudDocumentaiV1beta2Vertex",
-"properties": {
-"x": {
-"description": "X coordinate.",
-"format": "int32",
-"type": "integer"
-},
-"y": {
-"description": "Y coordinate (starts from the top of the image).",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
 "GoogleCloudDocumentaiV1beta3BatchDeleteDocumentsMetadata": {
 "id": "GoogleCloudDocumentaiV1beta3BatchDeleteDocumentsMetadata",
 "properties": {
diff --git a/googleapiclient/discovery_cache/documents/documentai.v1beta3.json b/googleapiclient/discovery_cache/documents/documentai.v1beta3.json
index 50bdfe80234..1503e3eadb4 100644
--- a/googleapiclient/discovery_cache/documents/documentai.v1beta3.json
+++ b/googleapiclient/discovery_cache/documents/documentai.v1beta3.json
@@ -1284,7 +1284,7 @@
 }
 }
 },
-"revision": "20240813",
+"revision": "20240911",
 "rootUrl": "https://documentai.googleapis.com/",
 "schemas": {
 "GoogleCloudDocumentaiUiv1beta3AutoLabelDocumentsMetadata": {
@@ -2569,3354 +2569,6 @@
 "properties": {},
 "type": "object"
 },
-"GoogleCloudDocumentaiV1beta1Barcode": {
-"description": "Encodes the detailed information of a barcode.",
-"id": "GoogleCloudDocumentaiV1beta1Barcode",
-"properties": {
-"format": {
-"description": "Format of a barcode. The supported formats are: - `CODE_128`: Code 128 type. - `CODE_39`: Code 39 type. - `CODE_93`: Code 93 type. - `CODABAR`: Codabar type. - `DATA_MATRIX`: 2D Data Matrix type. - `ITF`: ITF type. - `EAN_13`: EAN-13 type. - `EAN_8`: EAN-8 type. - `QR_CODE`: 2D QR code type. - `UPC_A`: UPC-A type. - `UPC_E`: UPC-E type. - `PDF417`: PDF417 type. - `AZTEC`: 2D Aztec code type. - `DATABAR`: GS1 DataBar code type.",
-"type": "string"
-},
-"rawValue": {
-"description": "Raw value encoded in the barcode. For example: `'MEBKM:TITLE:Google;URL:https://www.google.com;;'`.",
-"type": "string"
-},
-"valueFormat": {
-"description": "Value format describes the format of the value that a barcode encodes. The supported formats are: - `CONTACT_INFO`: Contact information. - `EMAIL`: Email address. - `ISBN`: ISBN identifier. - `PHONE`: Phone number. - `PRODUCT`: Product. - `SMS`: SMS message. - `TEXT`: Text string. - `URL`: URL address. - `WIFI`: Wifi information. - `GEO`: Geo-localization. - `CALENDAR_EVENT`: Calendar event. - `DRIVER_LICENSE`: Driver's license.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1BatchProcessDocumentsResponse": {
-"description": "Response to an batch document processing request. This is returned in the LRO Operation after the operation is complete.",
-"id": "GoogleCloudDocumentaiV1beta1BatchProcessDocumentsResponse",
-"properties": {
-"responses": {
-"description": "Responses for each individual document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1ProcessDocumentResponse"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1BoundingPoly": {
-"description": "A bounding polygon for the detected image annotation.",
-"id": "GoogleCloudDocumentaiV1beta1BoundingPoly",
-"properties": {
-"normalizedVertices": {
-"description": "The bounding polygon normalized vertices.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1NormalizedVertex"
-},
-"type": "array"
-},
-"vertices": {
-"description": "The bounding polygon vertices.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1Vertex"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1Document": {
-"description": "Document represents the canonical document resource in Document AI. It is an interchange format that provides insights into documents and allows for collaboration between users and Document AI to iterate and optimize for quality.",
-"id": "GoogleCloudDocumentaiV1beta1Document",
-"properties": {
-"chunkedDocument": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocument",
-"description": "Document chunked based on chunking config."
-},
-"content": {
-"description": "Optional. Inline document content, represented as a stream of bytes. Note: As with all `bytes` fields, protobuffers use a pure binary representation, whereas JSON representations use base64.",
-"format": "byte",
-"type": "string"
-},
-"documentLayout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayout",
-"description": "Parsed layout of the document."
-},
-"entities": {
-"description": "A list of entities detected on Document.text. For document shards, entities in this list may cross shard boundaries.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentEntity"
-},
-"type": "array"
-},
-"entityRelations": {
-"description": "Placeholder. Relationship among Document.entities.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentEntityRelation"
-},
-"type": "array"
-},
-"error": {
-"$ref": "GoogleRpcStatus",
-"description": "Any error that occurred while processing this document."
-},
-"mimeType": {
-"description": "An IANA published [media type (MIME type)](https://www.iana.org/assignments/media-types/media-types.xhtml).",
-"type": "string"
-},
-"pages": {
-"description": "Visual page layout for the Document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPage"
-},
-"type": "array"
-},
-"revisions": {
-"description": "Placeholder. Revision history of this document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentRevision"
-},
-"type": "array"
-},
-"shardInfo": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentShardInfo",
-"description": "Information about the sharding if this document is sharded part of a larger document. If the document is not sharded, this message is not specified."
-},
-"text": {
-"description": "Optional. UTF-8 encoded text in reading order from the document.",
-"type": "string"
-},
-"textChanges": {
-"description": "Placeholder. A list of text corrections made to Document.text. This is usually used for annotating corrections to OCR mistakes. Text changes for a given revision may not overlap with each other.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentTextChange"
-},
-"type": "array"
-},
-"textStyles": {
-"deprecated": true,
-"description": "Styles for the Document.text.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentStyle"
-},
-"type": "array"
-},
-"uri": {
-"description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. For more information, refer to [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris).",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentChunkedDocument": {
-"description": "Represents the chunks that the document is divided into.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocument",
-"properties": {
-"chunks": {
-"description": "List of chunks.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunk"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunk": {
-"description": "Represents a chunk.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunk",
-"properties": {
-"chunkId": {
-"description": "ID of the chunk.",
-"type": "string"
-},
-"content": {
-"description": "Text content of the chunk.",
-"type": "string"
-},
-"pageFooters": {
-"description": "Page footers associated with the chunk.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageFooter"
-},
-"type": "array"
-},
-"pageHeaders": {
-"description": "Page headers associated with the chunk.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageHeader"
-},
-"type": "array"
-},
-"pageSpan": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageSpan",
-"description": "Page span of the chunk."
-},
-"sourceBlockIds": {
-"description": "Unused.",
-"items": {
-"type": "string"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageFooter": {
-"description": "Represents the page footer associated with the chunk.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageFooter",
-"properties": {
-"pageSpan": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageSpan",
-"description": "Page span of the footer."
-},
-"text": {
-"description": "Footer in text format.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageHeader": {
-"description": "Represents the page header associated with the chunk.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageHeader",
-"properties": {
-"pageSpan": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageSpan",
-"description": "Page span of the header."
-},
-"text": {
-"description": "Header in text format.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageSpan": {
-"description": "Represents where the chunk starts and ends in the document.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentChunkedDocumentChunkChunkPageSpan",
-"properties": {
-"pageEnd": {
-"description": "Page where chunk ends in the document.",
-"format": "int32",
-"type": "integer"
-},
-"pageStart": {
-"description": "Page where chunk starts in the document.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayout": {
-"description": "Represents the parsed layout of a document as a collection of blocks that the document is divided into.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayout",
-"properties": {
-"blocks": {
-"description": "List of blocks in the document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlock"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlock": {
-"description": "Represents a block. A block could be one of the various types (text, table, list) supported.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlock",
-"properties": {
-"blockId": {
-"description": "ID of the block.",
-"type": "string"
-},
-"listBlock": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutListBlock",
-"description": "Block consisting of list content/structure."
-},
-"pageSpan": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutPageSpan",
-"description": "Page span of the block."
-},
-"tableBlock": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableBlock",
-"description": "Block consisting of table content/structure."
-},
-"textBlock": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTextBlock",
-"description": "Block consisting of text content."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutListBlock": {
-"description": "Represents a list type block.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutListBlock",
-"properties": {
-"listEntries": {
-"description": "List entries that constitute a list block.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutListEntry"
-},
-"type": "array"
-},
-"type": {
-"description": "Type of the list_entries (if exist). Available options are `ordered` and `unordered`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutListEntry": {
-"description": "Represents an entry in the list.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutListEntry",
-"properties": {
-"blocks": {
-"description": "A list entry is a list of blocks. Repeated blocks support further hierarchies and nested blocks.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlock"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutPageSpan": {
-"description": "Represents where the block starts and ends in the document.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutPageSpan",
-"properties": {
-"pageEnd": {
-"description": "Page where block ends in the document.",
-"format": "int32",
-"type": "integer"
-},
-"pageStart": {
-"description": "Page where block starts in the document.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableBlock": {
-"description": "Represents a table type block.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableBlock",
-"properties": {
-"bodyRows": {
-"description": "Body rows containing main table content.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableRow"
-},
-"type": "array"
-},
-"caption": {
-"description": "Table caption/title.",
-"type": "string"
-},
-"headerRows": {
-"description": "Header rows at the top of the table.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableRow"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableCell": {
-"description": "Represents a cell in a table row.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableCell",
-"properties": {
-"blocks": {
-"description": "A table cell is a list of blocks. Repeated blocks support further hierarchies and nested blocks.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlock"
-},
-"type": "array"
-},
-"colSpan": {
-"description": "How many columns this cell spans.",
-"format": "int32",
-"type": "integer"
-},
-"rowSpan": {
-"description": "How many rows this cell spans.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableRow": {
-"description": "Represents a row in a table.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableRow",
-"properties": {
-"cells": {
-"description": "A table row is a list of table cells.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTableCell"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTextBlock": {
-"description": "Represents a text type block.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlockLayoutTextBlock",
-"properties": {
-"blocks": {
-"description": "A text block could further have child blocks. Repeated blocks support further hierarchies and nested blocks.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentDocumentLayoutDocumentLayoutBlock"
-},
-"type": "array"
-},
-"text": {
-"description": "Text content stored in the block.",
-"type": "string"
-},
-"type": {
-"description": "Type of the text in the block. Available options are: `paragraph`, `subtitle`, `heading-1`, `heading-2`, `heading-3`, `heading-4`, `heading-5`, `header`, `footer`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentEntity": {
-"description": "An entity that could be a phrase in the text or a property that belongs to the document. It is a known entity type, such as a person, an organization, or location.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentEntity",
-"properties": {
-"confidence": {
-"description": "Optional. Confidence of detected Schema entity. Range `[0, 1]`.",
-"format": "float",
-"type": "number"
-},
-"id": {
-"description": "Optional. Canonical id. This will be a unique value in the entity list for this document.",
-"type": "string"
-},
-"mentionId": {
-"description": "Optional. Deprecated. Use `id` field instead.",
-"type": "string"
-},
-"mentionText": {
-"description": "Optional. Text value of the entity e.g. `1600 Amphitheatre Pkwy`.",
-"type": "string"
-},
-"normalizedValue": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentEntityNormalizedValue",
-"description": "Optional. Normalized entity value. Absent if the extracted value could not be converted or the type (e.g. address) is not supported for certain parsers. This field is also only populated for certain supported document types."
-},
-"pageAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageAnchor",
-"description": "Optional. Represents the provenance of this entity wrt. the location on the page where it was found."
-},
-"properties": {
-"description": "Optional. Entities can be nested to form a hierarchical data structure representing the content in the document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentEntity"
-},
-"type": "array"
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"description": "Optional. The history of this annotation."
-},
-"redacted": {
-"description": "Optional. Whether the entity will be redacted for de-identification purposes.",
-"type": "boolean"
-},
-"textAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentTextAnchor",
-"description": "Optional. Provenance of the entity. Text anchor indexing into the Document.text."
-},
-"type": {
-"description": "Required. Entity type from a schema e.g. `Address`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentEntityNormalizedValue": {
-"description": "Parsed and normalized entity value.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentEntityNormalizedValue",
-"properties": {
-"addressValue": {
-"$ref": "GoogleTypePostalAddress",
-"description": "Postal address. See also: https://github.com/googleapis/googleapis/blob/master/google/type/postal_address.proto"
-},
-"booleanValue": {
-"description": "Boolean value. Can be used for entities with binary values, or for checkboxes.",
-"type": "boolean"
-},
-"dateValue": {
-"$ref": "GoogleTypeDate",
-"description": "Date value. Includes year, month, day. See also: https://github.com/googleapis/googleapis/blob/master/google/type/date.proto"
-},
-"datetimeValue": {
-"$ref": "GoogleTypeDateTime",
-"description": "DateTime value. Includes date, time, and timezone. See also: https://github.com/googleapis/googleapis/blob/master/google/type/datetime.proto"
-},
-"floatValue": {
-"description": "Float value.",
-"format": "float",
-"type": "number"
-},
-"integerValue": {
-"description": "Integer value.",
-"format": "int32",
-"type": "integer"
-},
-"moneyValue": {
-"$ref": "GoogleTypeMoney",
-"description": "Money value. See also: https://github.com/googleapis/googleapis/blob/master/google/type/money.proto"
-},
-"text": {
-"description": "Optional. An optional field to store a normalized string. For some entity types, one of respective `structured_value` fields may also be populated. Also not all the types of `structured_value` will be normalized. For example, some processors may not generate `float` or `integer` normalized text by default. Below are sample formats mapped to structured values. - Money/Currency type (`money_value`) is in the ISO 4217 text format. - Date type (`date_value`) is in the ISO 8601 text format. - Datetime type (`datetime_value`) is in the ISO 8601 text format.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentEntityRelation": {
-"description": "Relationship between Entities.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentEntityRelation",
-"properties": {
-"objectId": {
-"description": "Object entity id.",
-"type": "string"
-},
-"relation": {
-"description": "Relationship description.",
-"type": "string"
-},
-"subjectId": {
-"description": "Subject entity id.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPage": {
-"description": "A page in a Document.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPage",
-"properties": {
-"blocks": {
-"description": "A list of visually detected text blocks on the page. A block has a set of lines (collected into paragraphs) that have a common line-spacing and orientation.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageBlock"
-},
-"type": "array"
-},
-"detectedBarcodes": {
-"description": "A list of detected barcodes.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedBarcode"
-},
-"type": "array"
-},
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"dimension": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDimension",
-"description": "Physical dimension of the page."
-},
-"formFields": {
-"description": "A list of visually detected form fields on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageFormField"
-},
-"type": "array"
-},
-"image": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageImage",
-"description": "Rendered image for this page. This image is preprocessed to remove any skew, rotation, and distortions such that the annotation bounding boxes can be upright and axis-aligned."
-},
-"imageQualityScores": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores",
-"description": "Image quality scores."
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for the page."
-},
-"lines": {
-"description": "A list of visually detected text lines on the page. A collection of tokens that a human would perceive as a line.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLine"
-},
-"type": "array"
-},
-"pageNumber": {
-"description": "1-based index for current Page in a parent Document. Useful when a page is taken out of a Document for individual processing.",
-"format": "int32",
-"type": "integer"
-},
-"paragraphs": {
-"description": "A list of visually detected text paragraphs on the page. A collection of lines that a human would perceive as a paragraph.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageParagraph"
-},
-"type": "array"
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"deprecated": true,
-"description": "The history of this page."
-},
-"symbols": {
-"description": "A list of visually detected symbols on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageSymbol"
-},
-"type": "array"
-},
-"tables": {
-"description": "A list of visually detected tables on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageTable"
-},
-"type": "array"
-},
-"tokens": {
-"description": "A list of visually detected tokens on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageToken"
-},
-"type": "array"
-},
-"transforms": {
-"description": "Transformation matrices that were applied to the original document image to produce Page.image.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageMatrix"
-},
-"type": "array"
-},
-"visualElements": {
-"description": "A list of detected non-text visual elements e.g. checkbox, signature etc. on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageVisualElement"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageAnchor": {
-"description": "Referencing the visual context of the entity in the Document.pages. Page anchors can be cross-page, consist of multiple bounding polygons and optionally reference specific layout element types.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageAnchor",
-"properties": {
-"pageRefs": {
-"description": "One or more references to visual page elements",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageAnchorPageRef"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageAnchorPageRef": {
-"description": "Represents a weak reference to a page element within a document.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageAnchorPageRef",
-"properties": {
-"boundingPoly": {
-"$ref": "GoogleCloudDocumentaiV1beta1BoundingPoly",
-"description": "Optional. Identifies the bounding polygon of a layout element on the page. If `layout_type` is set, the bounding polygon must be exactly the same to the layout element it's referring to."
-},
-"confidence": {
-"description": "Optional. Confidence of detected page element, if applicable. Range `[0, 1]`.",
-"format": "float",
-"type": "number"
-},
-"layoutId": {
-"deprecated": true,
-"description": "Optional. Deprecated. Use PageRef.bounding_poly instead.",
-"type": "string"
-},
-"layoutType": {
-"description": "Optional. The type of the layout element that is being referenced if any.",
-"enum": [
-"LAYOUT_TYPE_UNSPECIFIED",
-"BLOCK",
-"PARAGRAPH",
-"LINE",
-"TOKEN",
-"VISUAL_ELEMENT",
-"TABLE",
-"FORM_FIELD"
-],
-"enumDescriptions": [
-"Layout Unspecified.",
-"References a Page.blocks element.",
-"References a Page.paragraphs element.",
-"References a Page.lines element.",
-"References a Page.tokens element.",
-"References a Page.visual_elements element.",
-"Refrrences a Page.tables element.",
-"References a Page.form_fields element."
-],
-"type": "string"
-},
-"page": {
-"description": "Required. Index into the Document.pages element, for example using `Document.pages` to locate the related page element. This field is skipped when its value is the default `0`. See https://developers.google.com/protocol-buffers/docs/proto3#json.",
-"format": "int64",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageBlock": {
-"description": "A block has a set of lines (collected into paragraphs) that have a common line-spacing and orientation.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageBlock",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for Block."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"deprecated": true,
-"description": "The history of this annotation."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageDetectedBarcode": {
-"description": "A detected barcode.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedBarcode",
-"properties": {
-"barcode": {
-"$ref": "GoogleCloudDocumentaiV1beta1Barcode",
-"description": "Detailed barcode information of the DetectedBarcode."
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for DetectedBarcode."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage": {
-"description": "Detected language for a structural component.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage",
-"properties": {
-"confidence": {
-"description": "Confidence of detected language. Range `[0, 1]`.",
-"format": "float",
-"type": "number"
-},
-"languageCode": {
-"description": "The [BCP-47 language code](https://www.unicode.org/reports/tr35/#Unicode_locale_identifier), such as `en-US` or `sr-Latn`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageDimension": {
-"description": "Dimension for the page.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageDimension",
-"properties": {
-"height": {
-"description": "Page height.",
-"format": "float",
-"type": "number"
-},
-"unit": {
-"description": "Dimension unit.",
-"type": "string"
-},
-"width": {
-"description": "Page width.",
-"format": "float",
-"type": "number"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageFormField": {
-"description": "A form field detected on the page.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageFormField",
-"properties": {
-"correctedKeyText": {
-"description": "Created for Labeling UI to export key text. If corrections were made to the text identified by the `field_name.text_anchor`, this field will contain the correction.",
-"type": "string"
-},
-"correctedValueText": {
-"description": "Created for Labeling UI to export value text. If corrections were made to the text identified by the `field_value.text_anchor`, this field will contain the correction.",
-"type": "string"
-},
-"fieldName": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for the FormField name. e.g. `Address`, `Email`, `Grand total`, `Phone number`, etc."
-},
-"fieldValue": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for the FormField value."
-},
-"nameDetectedLanguages": {
-"description": "A list of detected languages for name together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"description": "The history of this annotation."
-},
-"valueDetectedLanguages": {
-"description": "A list of detected languages for value together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"valueType": {
-"description": "If the value is non-textual, this field represents the type. Current valid values are: - blank (this indicates the `field_value` is normal text) - `unfilled_checkbox` - `filled_checkbox`",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageImage": {
-"description": "Rendered image contents for this page.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageImage",
-"properties": {
-"content": {
-"description": "Raw byte content of the image.",
-"format": "byte",
-"type": "string"
-},
-"height": {
-"description": "Height of the image in pixels.",
-"format": "int32",
-"type": "integer"
-},
-"mimeType": {
-"description": "Encoding [media type (MIME type)](https://www.iana.org/assignments/media-types/media-types.xhtml) for the image.",
-"type": "string"
-},
-"width": {
-"description": "Width of the image in pixels.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores": {
-"description": "Image quality scores for the page image.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScores",
-"properties": {
-"detectedDefects": {
-"description": "A list of detected defects.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScoresDetectedDefect"
-},
-"type": "array"
-},
-"qualityScore": {
-"description": "The overall quality score. Range `[0, 1]` where `1` is perfect quality.",
-"format": "float",
-"type": "number"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScoresDetectedDefect": {
-"description": "Image Quality Defects",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageImageQualityScoresDetectedDefect",
-"properties": {
-"confidence": {
-"description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence that the defect exists.",
-"format": "float",
-"type": "number"
-},
-"type": {
-"description": "Name of the defect type. Supported values are: - `quality/defect_blurry` - `quality/defect_noisy` - `quality/defect_dark` - `quality/defect_faint` - `quality/defect_text_too_small` - `quality/defect_document_cutoff` - `quality/defect_text_cutoff` - `quality/defect_glare`",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageLayout": {
-"description": "Visual element describing a layout unit on a page.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"properties": {
-"boundingPoly": {
-"$ref": "GoogleCloudDocumentaiV1beta1BoundingPoly",
-"description": "The bounding polygon for the Layout."
-},
-"confidence": {
-"description": "Confidence of the current Layout within context of the object this layout is for. e.g. confidence can be for a single token, a table, a visual element, etc. depending on context. Range `[0, 1]`.",
-"format": "float",
-"type": "number"
-},
-"orientation": {
-"description": "Detected orientation for the Layout.",
-"enum": [
-"ORIENTATION_UNSPECIFIED",
-"PAGE_UP",
-"PAGE_RIGHT",
-"PAGE_DOWN",
-"PAGE_LEFT"
-],
-"enumDescriptions": [
-"Unspecified orientation.",
-"Orientation is aligned with page up.",
-"Orientation is aligned with page right. Turn the head 90 degrees clockwise from upright to read.",
-"Orientation is aligned with page down. Turn the head 180 degrees from upright to read.",
-"Orientation is aligned with page left. Turn the head 90 degrees counterclockwise from upright to read."
-],
-"type": "string"
-},
-"textAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentTextAnchor",
-"description": "Text anchor indexing into the Document.text."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageLine": {
-"description": "A collection of tokens that a human would perceive as a line. Does not cross column boundaries, can be horizontal, vertical, etc.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageLine",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for Line."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"deprecated": true,
-"description": "The history of this annotation."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageMatrix": {
-"description": "Representation for transformation matrix, intended to be compatible and used with OpenCV format for image manipulation.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageMatrix",
-"properties": {
-"cols": {
-"description": "Number of columns in the matrix.",
-"format": "int32",
-"type": "integer"
-},
-"data": {
-"description": "The matrix data.",
-"format": "byte",
-"type": "string"
-},
-"rows": {
-"description": "Number of rows in the matrix.",
-"format": "int32",
-"type": "integer"
-},
-"type": {
-"description": "This encodes information about what data type the matrix uses. For example, 0 (CV_8U) is an unsigned 8-bit image. For the full list of OpenCV primitive data types, please refer to https://docs.opencv.org/4.3.0/d1/d1b/group__core__hal__interface.html",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageParagraph": {
-"description": "A collection of lines that a human would perceive as a paragraph.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageParagraph",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for Paragraph."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"deprecated": true,
-"description": "The history of this annotation."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageSymbol": {
-"description": "A detected symbol.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageSymbol",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for Symbol."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageTable": {
-"description": "A table representation similar to HTML table structure.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageTable",
-"properties": {
-"bodyRows": {
-"description": "Body rows of the table.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageTableTableRow"
-},
-"type": "array"
-},
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"headerRows": {
-"description": "Header rows of the table.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageTableTableRow"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for Table."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"deprecated": true,
-"description": "The history of this table."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageTableTableCell": {
-"description": "A cell representation inside the table.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageTableTableCell",
-"properties": {
-"colSpan": {
-"description": "How many columns this cell spans.",
-"format": "int32",
-"type": "integer"
-},
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for TableCell."
-},
-"rowSpan": {
-"description": "How many rows this cell spans.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageTableTableRow": {
-"description": "A row of table cells.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageTableTableRow",
-"properties": {
-"cells": {
-"description": "Cells that make up this row.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageTableTableCell"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageToken": {
-"description": "A detected token.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageToken",
-"properties": {
-"detectedBreak": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageTokenDetectedBreak",
-"description": "Detected break at the end of a Token."
-},
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for Token."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"deprecated": true,
-"description": "The history of this annotation."
-},
-"styleInfo": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageTokenStyleInfo",
-"description": "Text style attributes."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageTokenDetectedBreak": {
-"description": "Detected break at the end of a Token.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageTokenDetectedBreak",
-"properties": {
-"type": {
-"description": "Detected break type.",
-"enum": [
-"TYPE_UNSPECIFIED",
-"SPACE",
-"WIDE_SPACE",
-"HYPHEN"
-],
-"enumDescriptions": [
-"Unspecified break type.",
-"A single whitespace.",
-"A wider whitespace.",
-"A hyphen that indicates that a token has been split across lines."
-],
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageTokenStyleInfo": {
-"description": "Font and other text style attributes.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageTokenStyleInfo",
-"properties": {
-"backgroundColor": {
-"$ref": "GoogleTypeColor",
-"description": "Color of the background."
-},
-"bold": {
-"description": "Whether the text is bold (equivalent to font_weight is at least `700`).",
-"type": "boolean"
-},
-"fontSize": {
-"description": "Font size in points (`1` point is `\u00b9\u2044\u2087\u2082` inches).",
-"format": "int32",
-"type": "integer"
-},
-"fontType": {
-"description": "Name or style of the font.",
-"type": "string"
-},
-"fontWeight": {
-"description": "TrueType weight on a scale `100` (thin) to `1000` (ultra-heavy). Normal is `400`, bold is `700`.",
-"format": "int32",
-"type": "integer"
-},
-"handwritten": {
-"description": "Whether the text is handwritten.",
-"type": "boolean"
-},
-"italic": {
-"description": "Whether the text is italic.",
-"type": "boolean"
-},
-"letterSpacing": {
-"description": "Letter spacing in points.",
-"format": "double",
-"type": "number"
-},
-"pixelFontSize": {
-"description": "Font size in pixels, equal to _unrounded font_size_ * _resolution_ \u00f7 `72.0`.",
-"format": "double",
-"type": "number"
-},
-"smallcaps": {
-"description": "Whether the text is in small caps. This feature is not supported yet.",
-"type": "boolean"
-},
-"strikeout": {
-"description": "Whether the text is strikethrough. This feature is not supported yet.",
-"type": "boolean"
-},
-"subscript": {
-"description": "Whether the text is a subscript. This feature is not supported yet.",
-"type": "boolean"
-},
-"superscript": {
-"description": "Whether the text is a superscript. This feature is not supported yet.",
-"type": "boolean"
-},
-"textColor": {
-"$ref": "GoogleTypeColor",
-"description": "Color of the text."
-},
-"underlined": {
-"description": "Whether the text is underlined.",
-"type": "boolean"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentPageVisualElement": {
-"description": "Detected non-text visual elements e.g. checkbox, signature etc. on the page.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentPageVisualElement",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentPageLayout",
-"description": "Layout for VisualElement."
-},
-"type": {
-"description": "Type of the VisualElement.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentProvenance": {
-"description": "Structure to identify provenance relationships between annotations in different revisions.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentProvenance",
-"properties": {
-"id": {
-"deprecated": true,
-"description": "The Id of this operation. Needs to be unique within the scope of the revision.",
-"format": "int32",
-"type": "integer"
-},
-"parents": {
-"description": "References to the original elements that are replaced.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenanceParent"
-},
-"type": "array"
-},
-"revision": {
-"deprecated": true,
-"description": "The index of the revision that produced this element.",
-"format": "int32",
-"type": "integer"
-},
-"type": {
-"description": "The type of provenance operation.",
-"enum": [
-"OPERATION_TYPE_UNSPECIFIED",
-"ADD",
-"REMOVE",
-"UPDATE",
-"REPLACE",
-"EVAL_REQUESTED",
-"EVAL_APPROVED",
-"EVAL_SKIPPED"
-],
-"enumDeprecated": [
-false,
-false,
-false,
-false,
-false,
-true,
-true,
-true
-],
-"enumDescriptions": [
-"Operation type unspecified. If no operation is specified a provenance entry is simply used to match against a `parent`.",
-"Add an element.",
-"Remove an element identified by `parent`.",
-"Updates any fields within the given provenance scope of the message. It overwrites the fields rather than replacing them. Use this when you want to update a field value of an entity without also updating all the child properties.",
-"Currently unused. Replace an element identified by `parent`.",
-"Deprecated. Request human review for the element identified by `parent`.",
-"Deprecated. Element is reviewed and approved at human review, confidence will be set to 1.0.",
-"Deprecated. Element is skipped in the validation process."
-],
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentProvenanceParent": {
-"description": "The parent element the current element is based on. Used for referencing/aligning, removal and replacement operations.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentProvenanceParent",
-"properties": {
-"id": {
-"deprecated": true,
-"description": "The id of the parent provenance.",
-"format": "int32",
-"type": "integer"
-},
-"index": {
-"description": "The index of the parent item in the corresponding item list (eg. list of entities, properties within entities, etc.) in the parent revision.",
-"format": "int32",
-"type": "integer"
-},
-"revision": {
-"description": "The index of the index into current revision's parent_ids list.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentRevision": {
-"description": "Contains past or forward revisions of this document.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentRevision",
-"properties": {
-"agent": {
-"description": "If the change was made by a person specify the name or id of that person.",
-"type": "string"
-},
-"createTime": {
-"description": "The time that the revision was created, internally generated by doc proto storage at the time of create.",
-"format": "google-datetime",
-"type": "string"
-},
-"humanReview": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentRevisionHumanReview",
-"description": "Human Review information of this revision."
-},
-"id": {
-"description": "Id of the revision, internally generated by doc proto storage. Unique within the context of the document.",
-"type": "string"
-},
-"parent": {
-"deprecated": true,
-"description": "The revisions that this revision is based on. This can include one or more parent (when documents are merged.) This field represents the index into the `revisions` field.",
-"items": {
-"format": "int32",
-"type": "integer"
-},
-"type": "array"
-},
-"parentIds": {
-"description": "The revisions that this revision is based on. Must include all the ids that have anything to do with this revision - eg. there are `provenance.parent.revision` fields that index into this field.",
-"items": {
-"type": "string"
-},
-"type": "array"
-},
-"processor": {
-"description": "If the annotation was made by processor identify the processor by its resource name.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentRevisionHumanReview": {
-"description": "Human Review information of the document.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentRevisionHumanReview",
-"properties": {
-"state": {
-"description": "Human review state. e.g. `requested`, `succeeded`, `rejected`.",
-"type": "string"
-},
-"stateMessage": {
-"description": "A message providing more details about the current state of processing. For example, the rejection reason when the state is `rejected`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentShardInfo": {
-"description": "For a large document, sharding may be performed to produce several document shards. Each document shard contains this field to detail which shard it is.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentShardInfo",
-"properties": {
-"shardCount": {
-"description": "Total number of shards.",
-"format": "int64",
-"type": "string"
-},
-"shardIndex": {
-"description": "The 0-based index of this shard.",
-"format": "int64",
-"type": "string"
-},
-"textOffset": {
-"description": "The index of the first character in Document.text in the overall document global text.",
-"format": "int64",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentStyle": {
-"description": "Annotation for common text style attributes. This adheres to CSS conventions as much as possible.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentStyle",
-"properties": {
-"backgroundColor": {
-"$ref": "GoogleTypeColor",
-"description": "Text background color."
-},
-"color": {
-"$ref": "GoogleTypeColor",
-"description": "Text color."
-},
-"fontFamily": {
-"description": "Font family such as `Arial`, `Times New Roman`. https://www.w3schools.com/cssref/pr_font_font-family.asp",
-"type": "string"
-},
-"fontSize": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentStyleFontSize",
-"description": "Font size."
-},
-"fontWeight": {
-"description": "[Font weight](https://www.w3schools.com/cssref/pr_font_weight.asp). Possible values are `normal`, `bold`, `bolder`, and `lighter`.",
-"type": "string"
-},
-"textAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentTextAnchor",
-"description": "Text anchor indexing into the Document.text."
-},
-"textDecoration": {
-"description": "[Text decoration](https://www.w3schools.com/cssref/pr_text_text-decoration.asp). Follows CSS standard. ",
-"type": "string"
-},
-"textStyle": {
-"description": "[Text style](https://www.w3schools.com/cssref/pr_font_font-style.asp). Possible values are `normal`, `italic`, and `oblique`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentStyleFontSize": {
-"description": "Font size with unit.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentStyleFontSize",
-"properties": {
-"size": {
-"description": "Font size for the text.",
-"format": "float",
-"type": "number"
-},
-"unit": {
-"description": "Unit for the font size. Follows CSS naming (such as `in`, `px`, and `pt`).",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentTextAnchor": {
-"description": "Text reference indexing into the Document.text.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentTextAnchor",
-"properties": {
-"content": {
-"description": "Contains the content of the text span so that users do not have to look it up in the text_segments. It is always populated for formFields.",
-"type": "string"
-},
-"textSegments": {
-"description": "The text segments from the Document.text.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentTextAnchorTextSegment"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentTextAnchorTextSegment": {
-"description": "A text segment in the Document.text. The indices may be out of bounds which indicate that the text extends into another document shard for large sharded documents. See ShardInfo.text_offset",
-"id": "GoogleCloudDocumentaiV1beta1DocumentTextAnchorTextSegment",
-"properties": {
-"endIndex": {
-"description": "TextSegment half open end UTF-8 char index in the Document.text.",
-"format": "int64",
-"type": "string"
-},
-"startIndex": {
-"description": "TextSegment start UTF-8 char index in the Document.text.",
-"format": "int64",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1DocumentTextChange": {
-"description": "This message is used for text changes aka. OCR corrections.",
-"id": "GoogleCloudDocumentaiV1beta1DocumentTextChange",
-"properties": {
-"changedText": {
-"description": "The text that replaces the text identified in the `text_anchor`.",
-"type": "string"
-},
-"provenance": {
-"deprecated": true,
-"description": "The history of this annotation.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentProvenance"
-},
-"type": "array"
-},
-"textAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta1DocumentTextAnchor",
-"description": "Provenance of the correction. Text anchor indexing into the Document.text. There can only be a single `TextAnchor.text_segments` element. If the start and end index of the text segment are the same, the text change is inserted before that index."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1GcsDestination": {
-"description": "The Google Cloud Storage location where the output file will be written to.",
-"id": "GoogleCloudDocumentaiV1beta1GcsDestination",
-"properties": {
-"uri": {
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1GcsSource": {
-"description": "The Google Cloud Storage location where the input file will be read from.",
-"id": "GoogleCloudDocumentaiV1beta1GcsSource",
-"properties": {
-"uri": {
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1InputConfig": {
-"description": "The desired input location and metadata.",
-"id": "GoogleCloudDocumentaiV1beta1InputConfig",
-"properties": {
-"gcsSource": {
-"$ref": "GoogleCloudDocumentaiV1beta1GcsSource",
-"description": "The Google Cloud Storage location to read the input from. This must be a single file."
-},
-"mimeType": {
-"description": "Required. Mimetype of the input. Current supported mimetypes are application/pdf, image/tiff, and image/gif. In addition, application/json type is supported for requests with ProcessDocumentRequest.automl_params field set. The JSON file needs to be in Document format.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1NormalizedVertex": {
-"description": "A vertex represents a 2D point in the image. NOTE: the normalized vertex coordinates are relative to the original image and range from 0 to 1.",
-"id": "GoogleCloudDocumentaiV1beta1NormalizedVertex",
-"properties": {
-"x": {
-"description": "X coordinate.",
-"format": "float",
-"type": "number"
-},
-"y": {
-"description": "Y coordinate (starts from the top of the image).",
-"format": "float",
-"type": "number"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1OperationMetadata": {
-"description": "Contains metadata for the BatchProcessDocuments operation.",
-"id": "GoogleCloudDocumentaiV1beta1OperationMetadata",
-"properties": {
-"createTime": {
-"description": "The creation time of the operation.",
-"format": "google-datetime",
-"type": "string"
-},
-"state": {
-"description": "The state of the current batch processing.",
-"enum": [
-"STATE_UNSPECIFIED",
-"ACCEPTED",
-"WAITING",
-"RUNNING",
-"SUCCEEDED",
-"CANCELLED",
-"FAILED"
-],
-"enumDescriptions": [
-"The default value. This value is used if the state is omitted.",
-"Request is received.",
-"Request operation is waiting for scheduling.",
-"Request is being processed.",
-"The batch processing completed successfully.",
-"The batch processing was cancelled.",
-"The batch processing has failed."
-],
-"type": "string"
-},
-"stateMessage": {
-"description": "A message providing more details about the current state of processing.",
-"type": "string"
-},
-"updateTime": {
-"description": "The last update time of the operation.",
-"format": "google-datetime",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1OutputConfig": {
-"description": "The desired output location and metadata.",
-"id": "GoogleCloudDocumentaiV1beta1OutputConfig",
-"properties": {
-"gcsDestination": {
-"$ref": "GoogleCloudDocumentaiV1beta1GcsDestination",
-"description": "The Google Cloud Storage location to write the output to."
-},
-"pagesPerShard": {
-"description": "The max number of pages to include into each output Document shard JSON on Google Cloud Storage. The valid range is [1, 100]. If not specified, the default value is 20. For example, for one pdf file with 100 pages, 100 parsed pages will be produced. If `pages_per_shard` = 20, then 5 Document shard JSON files each containing 20 parsed pages will be written under the prefix OutputConfig.gcs_destination.uri and suffix pages-x-to-y.json where x and y are 1-indexed page numbers. Example GCS outputs with 157 pages and pages_per_shard = 50: pages-001-to-050.json pages-051-to-100.json pages-101-to-150.json pages-151-to-157.json",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1ProcessDocumentResponse": {
-"description": "Response to a single document processing request.",
-"id": "GoogleCloudDocumentaiV1beta1ProcessDocumentResponse",
-"properties": {
-"inputConfig": {
-"$ref": "GoogleCloudDocumentaiV1beta1InputConfig",
-"description": "Information about the input file. This is the same as the corresponding input config in the request."
-},
-"outputConfig": {
-"$ref": "GoogleCloudDocumentaiV1beta1OutputConfig",
-"description": "The output location of the parsed responses. The responses are written to this location as JSON-serialized `Document` objects."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta1Vertex": {
-"description": "A vertex represents a 2D point in the image. NOTE: the vertex coordinates are in the same scale as the original image.",
-"id": "GoogleCloudDocumentaiV1beta1Vertex",
-"properties": {
-"x": {
-"description": "X coordinate.",
-"format": "int32",
-"type": "integer"
-},
-"y": {
-"description": "Y coordinate (starts from the top of the image).",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2Barcode": {
-"description": "Encodes the detailed information of a barcode.",
-"id": "GoogleCloudDocumentaiV1beta2Barcode",
-"properties": {
-"format": {
-"description": "Format of a barcode. The supported formats are: - `CODE_128`: Code 128 type. - `CODE_39`: Code 39 type. - `CODE_93`: Code 93 type. - `CODABAR`: Codabar type. - `DATA_MATRIX`: 2D Data Matrix type. - `ITF`: ITF type. - `EAN_13`: EAN-13 type. - `EAN_8`: EAN-8 type. - `QR_CODE`: 2D QR code type. - `UPC_A`: UPC-A type. - `UPC_E`: UPC-E type. - `PDF417`: PDF417 type. - `AZTEC`: 2D Aztec code type. - `DATABAR`: GS1 DataBar code type.",
-"type": "string"
-},
-"rawValue": {
-"description": "Raw value encoded in the barcode. For example: `'MEBKM:TITLE:Google;URL:https://www.google.com;;'`.",
-"type": "string"
-},
-"valueFormat": {
-"description": "Value format describes the format of the value that a barcode encodes. The supported formats are: - `CONTACT_INFO`: Contact information. - `EMAIL`: Email address. - `ISBN`: ISBN identifier. - `PHONE`: Phone number. - `PRODUCT`: Product. - `SMS`: SMS message. - `TEXT`: Text string. - `URL`: URL address. - `WIFI`: Wifi information. - `GEO`: Geo-localization. - `CALENDAR_EVENT`: Calendar event. - `DRIVER_LICENSE`: Driver's license.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2BatchProcessDocumentsResponse": {
-"description": "Response to an batch document processing request. This is returned in the LRO Operation after the operation is complete.",
-"id": "GoogleCloudDocumentaiV1beta2BatchProcessDocumentsResponse",
-"properties": {
-"responses": {
-"description": "Responses for each individual document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2ProcessDocumentResponse"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2BoundingPoly": {
-"description": "A bounding polygon for the detected image annotation.",
-"id": "GoogleCloudDocumentaiV1beta2BoundingPoly",
-"properties": {
-"normalizedVertices": {
-"description": "The bounding polygon normalized vertices.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2NormalizedVertex"
-},
-"type": "array"
-},
-"vertices": {
-"description": "The bounding polygon vertices.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2Vertex"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2Document": {
-"description": "Document represents the canonical document resource in Document AI. It is an interchange format that provides insights into documents and allows for collaboration between users and Document AI to iterate and optimize for quality.",
-"id": "GoogleCloudDocumentaiV1beta2Document",
-"properties": {
-"chunkedDocument": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocument",
-"description": "Document chunked based on chunking config."
-},
-"content": {
-"description": "Optional. Inline document content, represented as a stream of bytes. Note: As with all `bytes` fields, protobuffers use a pure binary representation, whereas JSON representations use base64.",
-"format": "byte",
-"type": "string"
-},
-"documentLayout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayout",
-"description": "Parsed layout of the document."
-},
-"entities": {
-"description": "A list of entities detected on Document.text. For document shards, entities in this list may cross shard boundaries.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentEntity"
-},
-"type": "array"
-},
-"entityRelations": {
-"description": "Placeholder. Relationship among Document.entities.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentEntityRelation"
-},
-"type": "array"
-},
-"error": {
-"$ref": "GoogleRpcStatus",
-"description": "Any error that occurred while processing this document."
-},
-"labels": {
-"description": "Labels for this document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentLabel"
-},
-"type": "array"
-},
-"mimeType": {
-"description": "An IANA published [media type (MIME type)](https://www.iana.org/assignments/media-types/media-types.xhtml).",
-"type": "string"
-},
-"pages": {
-"description": "Visual page layout for the Document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPage"
-},
-"type": "array"
-},
-"revisions": {
-"description": "Placeholder. Revision history of this document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentRevision"
-},
-"type": "array"
-},
-"shardInfo": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentShardInfo",
-"description": "Information about the sharding if this document is sharded part of a larger document. If the document is not sharded, this message is not specified."
-},
-"text": {
-"description": "Optional. UTF-8 encoded text in reading order from the document.",
-"type": "string"
-},
-"textChanges": {
-"description": "Placeholder. A list of text corrections made to Document.text. This is usually used for annotating corrections to OCR mistakes. Text changes for a given revision may not overlap with each other.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentTextChange"
-},
-"type": "array"
-},
-"textStyles": {
-"deprecated": true,
-"description": "Styles for the Document.text.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentStyle"
-},
-"type": "array"
-},
-"uri": {
-"description": "Optional. Currently supports Google Cloud Storage URI of the form `gs://bucket_name/object_name`. Object versioning is not supported. For more information, refer to [Google Cloud Storage Request URIs](https://cloud.google.com/storage/docs/reference-uris).",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentChunkedDocument": {
-"description": "Represents the chunks that the document is divided into.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocument",
-"properties": {
-"chunks": {
-"description": "List of chunks.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunk"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunk": {
-"description": "Represents a chunk.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunk",
-"properties": {
-"chunkId": {
-"description": "ID of the chunk.",
-"type": "string"
-},
-"content": {
-"description": "Text content of the chunk.",
-"type": "string"
-},
-"pageFooters": {
-"description": "Page footers associated with the chunk.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageFooter"
-},
-"type": "array"
-},
-"pageHeaders": {
-"description": "Page headers associated with the chunk.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageHeader"
-},
-"type": "array"
-},
-"pageSpan": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageSpan",
-"description": "Page span of the chunk."
-},
-"sourceBlockIds": {
-"description": "Unused.",
-"items": {
-"type": "string"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageFooter": {
-"description": "Represents the page footer associated with the chunk.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageFooter",
-"properties": {
-"pageSpan": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageSpan",
-"description": "Page span of the footer."
-},
-"text": {
-"description": "Footer in text format.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageHeader": {
-"description": "Represents the page header associated with the chunk.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageHeader",
-"properties": {
-"pageSpan": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageSpan",
-"description": "Page span of the header."
-},
-"text": {
-"description": "Header in text format.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageSpan": {
-"description": "Represents where the chunk starts and ends in the document.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentChunkedDocumentChunkChunkPageSpan",
-"properties": {
-"pageEnd": {
-"description": "Page where chunk ends in the document.",
-"format": "int32",
-"type": "integer"
-},
-"pageStart": {
-"description": "Page where chunk starts in the document.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayout": {
-"description": "Represents the parsed layout of a document as a collection of blocks that the document is divided into.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayout",
-"properties": {
-"blocks": {
-"description": "List of blocks in the document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlock"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlock": {
-"description": "Represents a block. A block could be one of the various types (text, table, list) supported.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlock",
-"properties": {
-"blockId": {
-"description": "ID of the block.",
-"type": "string"
-},
-"listBlock": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutListBlock",
-"description": "Block consisting of list content/structure."
-},
-"pageSpan": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutPageSpan",
-"description": "Page span of the block."
-},
-"tableBlock": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableBlock",
-"description": "Block consisting of table content/structure."
-},
-"textBlock": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTextBlock",
-"description": "Block consisting of text content."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutListBlock": {
-"description": "Represents a list type block.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutListBlock",
-"properties": {
-"listEntries": {
-"description": "List entries that constitute a list block.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutListEntry"
-},
-"type": "array"
-},
-"type": {
-"description": "Type of the list_entries (if exist). Available options are `ordered` and `unordered`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutListEntry": {
-"description": "Represents an entry in the list.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutListEntry",
-"properties": {
-"blocks": {
-"description": "A list entry is a list of blocks. Repeated blocks support further hierarchies and nested blocks.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlock"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutPageSpan": {
-"description": "Represents where the block starts and ends in the document.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutPageSpan",
-"properties": {
-"pageEnd": {
-"description": "Page where block ends in the document.",
-"format": "int32",
-"type": "integer"
-},
-"pageStart": {
-"description": "Page where block starts in the document.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableBlock": {
-"description": "Represents a table type block.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableBlock",
-"properties": {
-"bodyRows": {
-"description": "Body rows containing main table content.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableRow"
-},
-"type": "array"
-},
-"caption": {
-"description": "Table caption/title.",
-"type": "string"
-},
-"headerRows": {
-"description": "Header rows at the top of the table.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableRow"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableCell": {
-"description": "Represents a cell in a table row.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableCell",
-"properties": {
-"blocks": {
-"description": "A table cell is a list of blocks. Repeated blocks support further hierarchies and nested blocks.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlock"
-},
-"type": "array"
-},
-"colSpan": {
-"description": "How many columns this cell spans.",
-"format": "int32",
-"type": "integer"
-},
-"rowSpan": {
-"description": "How many rows this cell spans.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableRow": {
-"description": "Represents a row in a table.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableRow",
-"properties": {
-"cells": {
-"description": "A table row is a list of table cells.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTableCell"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTextBlock": {
-"description": "Represents a text type block.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlockLayoutTextBlock",
-"properties": {
-"blocks": {
-"description": "A text block could further have child blocks. Repeated blocks support further hierarchies and nested blocks.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentDocumentLayoutDocumentLayoutBlock"
-},
-"type": "array"
-},
-"text": {
-"description": "Text content stored in the block.",
-"type": "string"
-},
-"type": {
-"description": "Type of the text in the block. Available options are: `paragraph`, `subtitle`, `heading-1`, `heading-2`, `heading-3`, `heading-4`, `heading-5`, `header`, `footer`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentEntity": {
-"description": "An entity that could be a phrase in the text or a property that belongs to the document. It is a known entity type, such as a person, an organization, or location.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentEntity",
-"properties": {
-"confidence": {
-"description": "Optional. Confidence of detected Schema entity. Range `[0, 1]`.",
-"format": "float",
-"type": "number"
-},
-"id": {
-"description": "Optional. Canonical id. This will be a unique value in the entity list for this document.",
-"type": "string"
-},
-"mentionId": {
-"description": "Optional. Deprecated. Use `id` field instead.",
-"type": "string"
-},
-"mentionText": {
-"description": "Optional. Text value of the entity e.g. `1600 Amphitheatre Pkwy`.",
-"type": "string"
-},
-"normalizedValue": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentEntityNormalizedValue",
-"description": "Optional. Normalized entity value. Absent if the extracted value could not be converted or the type (e.g. address) is not supported for certain parsers. This field is also only populated for certain supported document types."
-},
-"pageAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageAnchor",
-"description": "Optional. Represents the provenance of this entity wrt. the location on the page where it was found."
-},
-"properties": {
-"description": "Optional. Entities can be nested to form a hierarchical data structure representing the content in the document.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentEntity"
-},
-"type": "array"
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"description": "Optional. The history of this annotation."
-},
-"redacted": {
-"description": "Optional. Whether the entity will be redacted for de-identification purposes.",
-"type": "boolean"
-},
-"textAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentTextAnchor",
-"description": "Optional. Provenance of the entity. Text anchor indexing into the Document.text."
-},
-"type": {
-"description": "Required. Entity type from a schema e.g. `Address`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentEntityNormalizedValue": {
-"description": "Parsed and normalized entity value.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentEntityNormalizedValue",
-"properties": {
-"addressValue": {
-"$ref": "GoogleTypePostalAddress",
-"description": "Postal address. See also: https://github.com/googleapis/googleapis/blob/master/google/type/postal_address.proto"
-},
-"booleanValue": {
-"description": "Boolean value. Can be used for entities with binary values, or for checkboxes.",
-"type": "boolean"
-},
-"dateValue": {
-"$ref": "GoogleTypeDate",
-"description": "Date value. Includes year, month, day. See also: https://github.com/googleapis/googleapis/blob/master/google/type/date.proto"
-},
-"datetimeValue": {
-"$ref": "GoogleTypeDateTime",
-"description": "DateTime value. Includes date, time, and timezone. See also: https://github.com/googleapis/googleapis/blob/master/google/type/datetime.proto"
-},
-"floatValue": {
-"description": "Float value.",
-"format": "float",
-"type": "number"
-},
-"integerValue": {
-"description": "Integer value.",
-"format": "int32",
-"type": "integer"
-},
-"moneyValue": {
-"$ref": "GoogleTypeMoney",
-"description": "Money value. See also: https://github.com/googleapis/googleapis/blob/master/google/type/money.proto"
-},
-"text": {
-"description": "Optional. An optional field to store a normalized string. For some entity types, one of respective `structured_value` fields may also be populated. Also not all the types of `structured_value` will be normalized. For example, some processors may not generate `float` or `integer` normalized text by default. Below are sample formats mapped to structured values. - Money/Currency type (`money_value`) is in the ISO 4217 text format. - Date type (`date_value`) is in the ISO 8601 text format. - Datetime type (`datetime_value`) is in the ISO 8601 text format.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentEntityRelation": {
-"description": "Relationship between Entities.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentEntityRelation",
-"properties": {
-"objectId": {
-"description": "Object entity id.",
-"type": "string"
-},
-"relation": {
-"description": "Relationship description.",
-"type": "string"
-},
-"subjectId": {
-"description": "Subject entity id.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentLabel": {
-"description": "Label attaches schema information and/or other metadata to segments within a Document. Multiple Labels on a single field can denote either different labels, different instances of the same label created at different times, or some combination of both.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentLabel",
-"properties": {
-"automlModel": {
-"description": "Label is generated AutoML model. This field stores the full resource name of the AutoML model. Format: `projects/{project-id}/locations/{location-id}/models/{model-id}`",
-"type": "string"
-},
-"confidence": {
-"description": "Confidence score between 0 and 1 for label assignment.",
-"format": "float",
-"type": "number"
-},
-"name": {
-"description": "Name of the label. When the label is generated from AutoML Text Classification model, this field represents the name of the category.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPage": {
-"description": "A page in a Document.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPage",
-"properties": {
-"blocks": {
-"description": "A list of visually detected text blocks on the page. A block has a set of lines (collected into paragraphs) that have a common line-spacing and orientation.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageBlock"
-},
-"type": "array"
-},
-"detectedBarcodes": {
-"description": "A list of detected barcodes.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedBarcode"
-},
-"type": "array"
-},
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"dimension": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDimension",
-"description": "Physical dimension of the page."
-},
-"formFields": {
-"description": "A list of visually detected form fields on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageFormField"
-},
-"type": "array"
-},
-"image": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageImage",
-"description": "Rendered image for this page. This image is preprocessed to remove any skew, rotation, and distortions such that the annotation bounding boxes can be upright and axis-aligned."
-},
-"imageQualityScores": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores",
-"description": "Image quality scores."
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for the page."
-},
-"lines": {
-"description": "A list of visually detected text lines on the page. A collection of tokens that a human would perceive as a line.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLine"
-},
-"type": "array"
-},
-"pageNumber": {
-"description": "1-based index for current Page in a parent Document. Useful when a page is taken out of a Document for individual processing.",
-"format": "int32",
-"type": "integer"
-},
-"paragraphs": {
-"description": "A list of visually detected text paragraphs on the page. A collection of lines that a human would perceive as a paragraph.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageParagraph"
-},
-"type": "array"
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"deprecated": true,
-"description": "The history of this page."
-},
-"symbols": {
-"description": "A list of visually detected symbols on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageSymbol"
-},
-"type": "array"
-},
-"tables": {
-"description": "A list of visually detected tables on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageTable"
-},
-"type": "array"
-},
-"tokens": {
-"description": "A list of visually detected tokens on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageToken"
-},
-"type": "array"
-},
-"transforms": {
-"description": "Transformation matrices that were applied to the original document image to produce Page.image.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageMatrix"
-},
-"type": "array"
-},
-"visualElements": {
-"description": "A list of detected non-text visual elements e.g. checkbox, signature etc. on the page.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageVisualElement"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageAnchor": {
-"description": "Referencing the visual context of the entity in the Document.pages. Page anchors can be cross-page, consist of multiple bounding polygons and optionally reference specific layout element types.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageAnchor",
-"properties": {
-"pageRefs": {
-"description": "One or more references to visual page elements",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageAnchorPageRef"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageAnchorPageRef": {
-"description": "Represents a weak reference to a page element within a document.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageAnchorPageRef",
-"properties": {
-"boundingPoly": {
-"$ref": "GoogleCloudDocumentaiV1beta2BoundingPoly",
-"description": "Optional. Identifies the bounding polygon of a layout element on the page. If `layout_type` is set, the bounding polygon must be exactly the same to the layout element it's referring to."
-},
-"confidence": {
-"description": "Optional. Confidence of detected page element, if applicable. Range `[0, 1]`.",
-"format": "float",
-"type": "number"
-},
-"layoutId": {
-"deprecated": true,
-"description": "Optional. Deprecated. Use PageRef.bounding_poly instead.",
-"type": "string"
-},
-"layoutType": {
-"description": "Optional. The type of the layout element that is being referenced if any.",
-"enum": [
-"LAYOUT_TYPE_UNSPECIFIED",
-"BLOCK",
-"PARAGRAPH",
-"LINE",
-"TOKEN",
-"VISUAL_ELEMENT",
-"TABLE",
-"FORM_FIELD"
-],
-"enumDescriptions": [
-"Layout Unspecified.",
-"References a Page.blocks element.",
-"References a Page.paragraphs element.",
-"References a Page.lines element.",
-"References a Page.tokens element.",
-"References a Page.visual_elements element.",
-"Refrrences a Page.tables element.",
-"References a Page.form_fields element."
-],
-"type": "string"
-},
-"page": {
-"description": "Required. Index into the Document.pages element, for example using `Document.pages` to locate the related page element. This field is skipped when its value is the default `0`. See https://developers.google.com/protocol-buffers/docs/proto3#json.",
-"format": "int64",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageBlock": {
-"description": "A block has a set of lines (collected into paragraphs) that have a common line-spacing and orientation.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageBlock",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for Block."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"deprecated": true,
-"description": "The history of this annotation."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageDetectedBarcode": {
-"description": "A detected barcode.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedBarcode",
-"properties": {
-"barcode": {
-"$ref": "GoogleCloudDocumentaiV1beta2Barcode",
-"description": "Detailed barcode information of the DetectedBarcode."
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for DetectedBarcode."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage": {
-"description": "Detected language for a structural component.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage",
-"properties": {
-"confidence": {
-"description": "Confidence of detected language. Range `[0, 1]`.",
-"format": "float",
-"type": "number"
-},
-"languageCode": {
-"description": "The [BCP-47 language code](https://www.unicode.org/reports/tr35/#Unicode_locale_identifier), such as `en-US` or `sr-Latn`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageDimension": {
-"description": "Dimension for the page.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageDimension",
-"properties": {
-"height": {
-"description": "Page height.",
-"format": "float",
-"type": "number"
-},
-"unit": {
-"description": "Dimension unit.",
-"type": "string"
-},
-"width": {
-"description": "Page width.",
-"format": "float",
-"type": "number"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageFormField": {
-"description": "A form field detected on the page.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageFormField",
-"properties": {
-"correctedKeyText": {
-"description": "Created for Labeling UI to export key text. If corrections were made to the text identified by the `field_name.text_anchor`, this field will contain the correction.",
-"type": "string"
-},
-"correctedValueText": {
-"description": "Created for Labeling UI to export value text. If corrections were made to the text identified by the `field_value.text_anchor`, this field will contain the correction.",
-"type": "string"
-},
-"fieldName": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for the FormField name. e.g. `Address`, `Email`, `Grand total`, `Phone number`, etc."
-},
-"fieldValue": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for the FormField value."
-},
-"nameDetectedLanguages": {
-"description": "A list of detected languages for name together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"description": "The history of this annotation."
-},
-"valueDetectedLanguages": {
-"description": "A list of detected languages for value together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"valueType": {
-"description": "If the value is non-textual, this field represents the type. Current valid values are: - blank (this indicates the `field_value` is normal text) - `unfilled_checkbox` - `filled_checkbox`",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageImage": {
-"description": "Rendered image contents for this page.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageImage",
-"properties": {
-"content": {
-"description": "Raw byte content of the image.",
-"format": "byte",
-"type": "string"
-},
-"height": {
-"description": "Height of the image in pixels.",
-"format": "int32",
-"type": "integer"
-},
-"mimeType": {
-"description": "Encoding [media type (MIME type)](https://www.iana.org/assignments/media-types/media-types.xhtml) for the image.",
-"type": "string"
-},
-"width": {
-"description": "Width of the image in pixels.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores": {
-"description": "Image quality scores for the page image.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScores",
-"properties": {
-"detectedDefects": {
-"description": "A list of detected defects.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScoresDetectedDefect"
-},
-"type": "array"
-},
-"qualityScore": {
-"description": "The overall quality score. Range `[0, 1]` where `1` is perfect quality.",
-"format": "float",
-"type": "number"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScoresDetectedDefect": {
-"description": "Image Quality Defects",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageImageQualityScoresDetectedDefect",
-"properties": {
-"confidence": {
-"description": "Confidence of detected defect. Range `[0, 1]` where `1` indicates strong confidence that the defect exists.",
-"format": "float",
-"type": "number"
-},
-"type": {
-"description": "Name of the defect type. Supported values are: - `quality/defect_blurry` - `quality/defect_noisy` - `quality/defect_dark` - `quality/defect_faint` - `quality/defect_text_too_small` - `quality/defect_document_cutoff` - `quality/defect_text_cutoff` - `quality/defect_glare`",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageLayout": {
-"description": "Visual element describing a layout unit on a page.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"properties": {
-"boundingPoly": {
-"$ref": "GoogleCloudDocumentaiV1beta2BoundingPoly",
-"description": "The bounding polygon for the Layout."
-},
-"confidence": {
-"description": "Confidence of the current Layout within context of the object this layout is for. e.g. confidence can be for a single token, a table, a visual element, etc. depending on context. Range `[0, 1]`.",
-"format": "float",
-"type": "number"
-},
-"orientation": {
-"description": "Detected orientation for the Layout.",
-"enum": [
-"ORIENTATION_UNSPECIFIED",
-"PAGE_UP",
-"PAGE_RIGHT",
-"PAGE_DOWN",
-"PAGE_LEFT"
-],
-"enumDescriptions": [
-"Unspecified orientation.",
-"Orientation is aligned with page up.",
-"Orientation is aligned with page right. Turn the head 90 degrees clockwise from upright to read.",
-"Orientation is aligned with page down. Turn the head 180 degrees from upright to read.",
-"Orientation is aligned with page left. Turn the head 90 degrees counterclockwise from upright to read."
-],
-"type": "string"
-},
-"textAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentTextAnchor",
-"description": "Text anchor indexing into the Document.text."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageLine": {
-"description": "A collection of tokens that a human would perceive as a line. Does not cross column boundaries, can be horizontal, vertical, etc.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageLine",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for Line."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"deprecated": true,
-"description": "The history of this annotation."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageMatrix": {
-"description": "Representation for transformation matrix, intended to be compatible and used with OpenCV format for image manipulation.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageMatrix",
-"properties": {
-"cols": {
-"description": "Number of columns in the matrix.",
-"format": "int32",
-"type": "integer"
-},
-"data": {
-"description": "The matrix data.",
-"format": "byte",
-"type": "string"
-},
-"rows": {
-"description": "Number of rows in the matrix.",
-"format": "int32",
-"type": "integer"
-},
-"type": {
-"description": "This encodes information about what data type the matrix uses. For example, 0 (CV_8U) is an unsigned 8-bit image. For the full list of OpenCV primitive data types, please refer to https://docs.opencv.org/4.3.0/d1/d1b/group__core__hal__interface.html",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageParagraph": {
-"description": "A collection of lines that a human would perceive as a paragraph.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageParagraph",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for Paragraph."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"deprecated": true,
-"description": "The history of this annotation."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageSymbol": {
-"description": "A detected symbol.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageSymbol",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for Symbol."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageTable": {
-"description": "A table representation similar to HTML table structure.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageTable",
-"properties": {
-"bodyRows": {
-"description": "Body rows of the table.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageTableTableRow"
-},
-"type": "array"
-},
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"headerRows": {
-"description": "Header rows of the table.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageTableTableRow"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for Table."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"deprecated": true,
-"description": "The history of this table."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageTableTableCell": {
-"description": "A cell representation inside the table.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageTableTableCell",
-"properties": {
-"colSpan": {
-"description": "How many columns this cell spans.",
-"format": "int32",
-"type": "integer"
-},
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for TableCell."
-},
-"rowSpan": {
-"description": "How many rows this cell spans.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageTableTableRow": {
-"description": "A row of table cells.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageTableTableRow",
-"properties": {
-"cells": {
-"description": "Cells that make up this row.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageTableTableCell"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageToken": {
-"description": "A detected token.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageToken",
-"properties": {
-"detectedBreak": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageTokenDetectedBreak",
-"description": "Detected break at the end of a Token."
-},
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for Token."
-},
-"provenance": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"deprecated": true,
-"description": "The history of this annotation."
-},
-"styleInfo": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageTokenStyleInfo",
-"description": "Text style attributes."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageTokenDetectedBreak": {
-"description": "Detected break at the end of a Token.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageTokenDetectedBreak",
-"properties": {
-"type": {
-"description": "Detected break type.",
-"enum": [
-"TYPE_UNSPECIFIED",
-"SPACE",
-"WIDE_SPACE",
-"HYPHEN"
-],
-"enumDescriptions": [
-"Unspecified break type.",
-"A single whitespace.",
-"A wider whitespace.",
-"A hyphen that indicates that a token has been split across lines."
-],
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageTokenStyleInfo": {
-"description": "Font and other text style attributes.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageTokenStyleInfo",
-"properties": {
-"backgroundColor": {
-"$ref": "GoogleTypeColor",
-"description": "Color of the background."
-},
-"bold": {
-"description": "Whether the text is bold (equivalent to font_weight is at least `700`).",
-"type": "boolean"
-},
-"fontSize": {
-"description": "Font size in points (`1` point is `\u00b9\u2044\u2087\u2082` inches).",
-"format": "int32",
-"type": "integer"
-},
-"fontType": {
-"description": "Name or style of the font.",
-"type": "string"
-},
-"fontWeight": {
-"description": "TrueType weight on a scale `100` (thin) to `1000` (ultra-heavy). Normal is `400`, bold is `700`.",
-"format": "int32",
-"type": "integer"
-},
-"handwritten": {
-"description": "Whether the text is handwritten.",
-"type": "boolean"
-},
-"italic": {
-"description": "Whether the text is italic.",
-"type": "boolean"
-},
-"letterSpacing": {
-"description": "Letter spacing in points.",
-"format": "double",
-"type": "number"
-},
-"pixelFontSize": {
-"description": "Font size in pixels, equal to _unrounded font_size_ * _resolution_ \u00f7 `72.0`.",
-"format": "double",
-"type": "number"
-},
-"smallcaps": {
-"description": "Whether the text is in small caps. This feature is not supported yet.",
-"type": "boolean"
-},
-"strikeout": {
-"description": "Whether the text is strikethrough. This feature is not supported yet.",
-"type": "boolean"
-},
-"subscript": {
-"description": "Whether the text is a subscript. This feature is not supported yet.",
-"type": "boolean"
-},
-"superscript": {
-"description": "Whether the text is a superscript. This feature is not supported yet.",
-"type": "boolean"
-},
-"textColor": {
-"$ref": "GoogleTypeColor",
-"description": "Color of the text."
-},
-"underlined": {
-"description": "Whether the text is underlined.",
-"type": "boolean"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentPageVisualElement": {
-"description": "Detected non-text visual elements e.g. checkbox, signature etc. on the page.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentPageVisualElement",
-"properties": {
-"detectedLanguages": {
-"description": "A list of detected languages together with confidence.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageDetectedLanguage"
-},
-"type": "array"
-},
-"layout": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentPageLayout",
-"description": "Layout for VisualElement."
-},
-"type": {
-"description": "Type of the VisualElement.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentProvenance": {
-"description": "Structure to identify provenance relationships between annotations in different revisions.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentProvenance",
-"properties": {
-"id": {
-"deprecated": true,
-"description": "The Id of this operation. Needs to be unique within the scope of the revision.",
-"format": "int32",
-"type": "integer"
-},
-"parents": {
-"description": "References to the original elements that are replaced.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenanceParent"
-},
-"type": "array"
-},
-"revision": {
-"deprecated": true,
-"description": "The index of the revision that produced this element.",
-"format": "int32",
-"type": "integer"
-},
-"type": {
-"description": "The type of provenance operation.",
-"enum": [
-"OPERATION_TYPE_UNSPECIFIED",
-"ADD",
-"REMOVE",
-"UPDATE",
-"REPLACE",
-"EVAL_REQUESTED",
-"EVAL_APPROVED",
-"EVAL_SKIPPED"
-],
-"enumDeprecated": [
-false,
-false,
-false,
-false,
-false,
-true,
-true,
-true
-],
-"enumDescriptions": [
-"Operation type unspecified. If no operation is specified a provenance entry is simply used to match against a `parent`.",
-"Add an element.",
-"Remove an element identified by `parent`.",
-"Updates any fields within the given provenance scope of the message. It overwrites the fields rather than replacing them. Use this when you want to update a field value of an entity without also updating all the child properties.",
-"Currently unused. Replace an element identified by `parent`.",
-"Deprecated. Request human review for the element identified by `parent`.",
-"Deprecated. Element is reviewed and approved at human review, confidence will be set to 1.0.",
-"Deprecated. Element is skipped in the validation process."
-],
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentProvenanceParent": {
-"description": "The parent element the current element is based on. Used for referencing/aligning, removal and replacement operations.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentProvenanceParent",
-"properties": {
-"id": {
-"deprecated": true,
-"description": "The id of the parent provenance.",
-"format": "int32",
-"type": "integer"
-},
-"index": {
-"description": "The index of the parent item in the corresponding item list (eg. list of entities, properties within entities, etc.) in the parent revision.",
-"format": "int32",
-"type": "integer"
-},
-"revision": {
-"description": "The index of the index into current revision's parent_ids list.",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentRevision": {
-"description": "Contains past or forward revisions of this document.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentRevision",
-"properties": {
-"agent": {
-"description": "If the change was made by a person specify the name or id of that person.",
-"type": "string"
-},
-"createTime": {
-"description": "The time that the revision was created, internally generated by doc proto storage at the time of create.",
-"format": "google-datetime",
-"type": "string"
-},
-"humanReview": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentRevisionHumanReview",
-"description": "Human Review information of this revision."
-},
-"id": {
-"description": "Id of the revision, internally generated by doc proto storage. Unique within the context of the document.",
-"type": "string"
-},
-"parent": {
-"deprecated": true,
-"description": "The revisions that this revision is based on. This can include one or more parent (when documents are merged.) This field represents the index into the `revisions` field.",
-"items": {
-"format": "int32",
-"type": "integer"
-},
-"type": "array"
-},
-"parentIds": {
-"description": "The revisions that this revision is based on. Must include all the ids that have anything to do with this revision - eg. there are `provenance.parent.revision` fields that index into this field.",
-"items": {
-"type": "string"
-},
-"type": "array"
-},
-"processor": {
-"description": "If the annotation was made by processor identify the processor by its resource name.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentRevisionHumanReview": {
-"description": "Human Review information of the document.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentRevisionHumanReview",
-"properties": {
-"state": {
-"description": "Human review state. e.g. `requested`, `succeeded`, `rejected`.",
-"type": "string"
-},
-"stateMessage": {
-"description": "A message providing more details about the current state of processing. For example, the rejection reason when the state is `rejected`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentShardInfo": {
-"description": "For a large document, sharding may be performed to produce several document shards. Each document shard contains this field to detail which shard it is.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentShardInfo",
-"properties": {
-"shardCount": {
-"description": "Total number of shards.",
-"format": "int64",
-"type": "string"
-},
-"shardIndex": {
-"description": "The 0-based index of this shard.",
-"format": "int64",
-"type": "string"
-},
-"textOffset": {
-"description": "The index of the first character in Document.text in the overall document global text.",
-"format": "int64",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentStyle": {
-"description": "Annotation for common text style attributes. This adheres to CSS conventions as much as possible.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentStyle",
-"properties": {
-"backgroundColor": {
-"$ref": "GoogleTypeColor",
-"description": "Text background color."
-},
-"color": {
-"$ref": "GoogleTypeColor",
-"description": "Text color."
-},
-"fontFamily": {
-"description": "Font family such as `Arial`, `Times New Roman`. https://www.w3schools.com/cssref/pr_font_font-family.asp",
-"type": "string"
-},
-"fontSize": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentStyleFontSize",
-"description": "Font size."
-},
-"fontWeight": {
-"description": "[Font weight](https://www.w3schools.com/cssref/pr_font_weight.asp). Possible values are `normal`, `bold`, `bolder`, and `lighter`.",
-"type": "string"
-},
-"textAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentTextAnchor",
-"description": "Text anchor indexing into the Document.text."
-},
-"textDecoration": {
-"description": "[Text decoration](https://www.w3schools.com/cssref/pr_text_text-decoration.asp). Follows CSS standard. ",
-"type": "string"
-},
-"textStyle": {
-"description": "[Text style](https://www.w3schools.com/cssref/pr_font_font-style.asp). Possible values are `normal`, `italic`, and `oblique`.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentStyleFontSize": {
-"description": "Font size with unit.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentStyleFontSize",
-"properties": {
-"size": {
-"description": "Font size for the text.",
-"format": "float",
-"type": "number"
-},
-"unit": {
-"description": "Unit for the font size. Follows CSS naming (such as `in`, `px`, and `pt`).",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentTextAnchor": {
-"description": "Text reference indexing into the Document.text.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentTextAnchor",
-"properties": {
-"content": {
-"description": "Contains the content of the text span so that users do not have to look it up in the text_segments. It is always populated for formFields.",
-"type": "string"
-},
-"textSegments": {
-"description": "The text segments from the Document.text.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentTextAnchorTextSegment"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentTextAnchorTextSegment": {
-"description": "A text segment in the Document.text. The indices may be out of bounds which indicate that the text extends into another document shard for large sharded documents. See ShardInfo.text_offset",
-"id": "GoogleCloudDocumentaiV1beta2DocumentTextAnchorTextSegment",
-"properties": {
-"endIndex": {
-"description": "TextSegment half open end UTF-8 char index in the Document.text.",
-"format": "int64",
-"type": "string"
-},
-"startIndex": {
-"description": "TextSegment start UTF-8 char index in the Document.text.",
-"format": "int64",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2DocumentTextChange": {
-"description": "This message is used for text changes aka. OCR corrections.",
-"id": "GoogleCloudDocumentaiV1beta2DocumentTextChange",
-"properties": {
-"changedText": {
-"description": "The text that replaces the text identified in the `text_anchor`.",
-"type": "string"
-},
-"provenance": {
-"deprecated": true,
-"description": "The history of this annotation.",
-"items": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentProvenance"
-},
-"type": "array"
-},
-"textAnchor": {
-"$ref": "GoogleCloudDocumentaiV1beta2DocumentTextAnchor",
-"description": "Provenance of the correction. Text anchor indexing into the Document.text. There can only be a single `TextAnchor.text_segments` element. If the start and end index of the text segment are the same, the text change is inserted before that index."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2GcsDestination": {
-"description": "The Google Cloud Storage location where the output file will be written to.",
-"id": "GoogleCloudDocumentaiV1beta2GcsDestination",
-"properties": {
-"uri": {
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2GcsSource": {
-"description": "The Google Cloud Storage location where the input file will be read from.",
-"id": "GoogleCloudDocumentaiV1beta2GcsSource",
-"properties": {
-"uri": {
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2InputConfig": {
-"description": "The desired input location and metadata.",
-"id": "GoogleCloudDocumentaiV1beta2InputConfig",
-"properties": {
-"contents": {
-"description": "Content in bytes, represented as a stream of bytes. Note: As with all `bytes` fields, proto buffer messages use a pure binary representation, whereas JSON representations use base64. This field only works for synchronous ProcessDocument method.",
-"format": "byte",
-"type": "string"
-},
-"gcsSource": {
-"$ref": "GoogleCloudDocumentaiV1beta2GcsSource",
-"description": "The Google Cloud Storage location to read the input from. This must be a single file."
-},
-"mimeType": {
-"description": "Required. Mimetype of the input. Current supported mimetypes are application/pdf, image/tiff, and image/gif. In addition, application/json type is supported for requests with ProcessDocumentRequest.automl_params field set. The JSON file needs to be in Document format.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2NormalizedVertex": {
-"description": "A vertex represents a 2D point in the image. NOTE: the normalized vertex coordinates are relative to the original image and range from 0 to 1.",
-"id": "GoogleCloudDocumentaiV1beta2NormalizedVertex",
-"properties": {
-"x": {
-"description": "X coordinate.",
-"format": "float",
-"type": "number"
-},
-"y": {
-"description": "Y coordinate (starts from the top of the image).",
-"format": "float",
-"type": "number"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2OperationMetadata": {
-"description": "Contains metadata for the BatchProcessDocuments operation.",
-"id": "GoogleCloudDocumentaiV1beta2OperationMetadata",
-"properties": {
-"createTime": {
-"description": "The creation time of the operation.",
-"format": "google-datetime",
-"type": "string"
-},
-"state": {
-"description": "The state of the current batch processing.",
-"enum": [
-"STATE_UNSPECIFIED",
-"ACCEPTED",
-"WAITING",
-"RUNNING",
-"SUCCEEDED",
-"CANCELLED",
-"FAILED"
-],
-"enumDescriptions": [
-"The default value. This value is used if the state is omitted.",
-"Request is received.",
-"Request operation is waiting for scheduling.",
-"Request is being processed.",
-"The batch processing completed successfully.",
-"The batch processing was cancelled.",
-"The batch processing has failed."
-],
-"type": "string"
-},
-"stateMessage": {
-"description": "A message providing more details about the current state of processing.",
-"type": "string"
-},
-"updateTime": {
-"description": "The last update time of the operation.",
-"format": "google-datetime",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2OutputConfig": {
-"description": "The desired output location and metadata.",
-"id": "GoogleCloudDocumentaiV1beta2OutputConfig",
-"properties": {
-"gcsDestination": {
-"$ref": "GoogleCloudDocumentaiV1beta2GcsDestination",
-"description": "The Google Cloud Storage location to write the output to."
-},
-"pagesPerShard": {
-"description": "The max number of pages to include into each output Document shard JSON on Google Cloud Storage. The valid range is [1, 100]. If not specified, the default value is 20. For example, for one pdf file with 100 pages, 100 parsed pages will be produced. If `pages_per_shard` = 20, then 5 Document shard JSON files each containing 20 parsed pages will be written under the prefix OutputConfig.gcs_destination.uri and suffix pages-x-to-y.json where x and y are 1-indexed page numbers. Example GCS outputs with 157 pages and pages_per_shard = 50: pages-001-to-050.json pages-051-to-100.json pages-101-to-150.json pages-151-to-157.json",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2ProcessDocumentResponse": {
-"description": "Response to a single document processing request.",
-"id": "GoogleCloudDocumentaiV1beta2ProcessDocumentResponse",
-"properties": {
-"inputConfig": {
-"$ref": "GoogleCloudDocumentaiV1beta2InputConfig",
-"description": "Information about the input file. This is the same as the corresponding input config in the request."
-},
-"outputConfig": {
-"$ref": "GoogleCloudDocumentaiV1beta2OutputConfig",
-"description": "The output location of the parsed responses. The responses are written to this location as JSON-serialized `Document` objects."
-}
-},
-"type": "object"
-},
-"GoogleCloudDocumentaiV1beta2Vertex": {
-"description": "A vertex represents a 2D point in the image. NOTE: the vertex coordinates are in the same scale as the original image.",
-"id": "GoogleCloudDocumentaiV1beta2Vertex",
-"properties": {
-"x": {
-"description": "X coordinate.",
-"format": "int32",
-"type": "integer"
-},
-"y": {
-"description": "Y coordinate (starts from the top of the image).",
-"format": "int32",
-"type": "integer"
-}
-},
-"type": "object"
-},
 "GoogleCloudDocumentaiV1beta3Barcode": {
 "description": "Encodes the detailed information of a barcode.",
 "id": "GoogleCloudDocumentaiV1beta3Barcode",
@@ -7945,6 +4597,10 @@ true
 },
 "type": "array"
 },
+"description": {
+"description": "The description of the entity type. Could be used to provide more information about the entity type for model calls.",
+"type": "string"
+},
 "displayName": {
 "description": "User defined name for the type.",
 "type": "string"
@@ -7989,6 +4645,10 @@ true
 "description": "Defines properties that can be part of the entity type.",
 "id": "GoogleCloudDocumentaiV1beta3DocumentSchemaEntityTypeProperty",
 "properties": {
+"description": {
+"description": "The description of the property. Could be used to provide more information about the property for model calls.",
+"type": "string"
+},
 "displayName": {
 "description": "User defined name for the property.",
 "type": "string"

From 182ad1455658ff928780edfd190b9162377b0075 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:05 +0000
Subject: [PATCH 18/32] feat(firebase): update the api

#### firebase:v1beta1

The following keys were added:
- schemas.WebAppConfig.properties.projectNumber (Total Keys: 2)
- schemas.WebAppConfig.properties.version.type (Total Keys: 1)
---
 docs/dyn/firebase_v1beta1.projects.webApps.html   |  3 +++
 .../documents/firebase.v1beta1.json               | 15 ++++++++++++++-
 2 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/firebase_v1beta1.projects.webApps.html b/docs/dyn/firebase_v1beta1.projects.webApps.html
index f7b44699bf6..a4c17e070d8 100644
--- a/docs/dyn/firebase_v1beta1.projects.webApps.html
+++ b/docs/dyn/firebase_v1beta1.projects.webApps.html
@@ -213,7 +213,10 @@ Method Details
   "measurementId": "A String", # The unique Google-assigned identifier of the Google Analytics web stream associated with the `WebApp`. Firebase SDKs use this ID to interact with Google Analytics APIs. This field is only present if the `WebApp` is linked to a web stream in a Google Analytics App + Web property. Learn more about this ID and Google Analytics web streams in the [Analytics documentation](https://support.google.com/analytics/answer/9304153). To generate a `measurementId` and link the `WebApp` with a Google Analytics web stream, call [`AddGoogleAnalytics`](../../v1beta1/projects/addGoogleAnalytics). For apps using the Firebase JavaScript SDK v7.20.0 and later, Firebase dynamically fetches the `measurementId` when your app initializes Analytics. Having this ID in your config object is optional, but it does serve as a fallback in the rare case that the dynamic fetch fails.
   "messagingSenderId": "A String", # The sender ID for use with Firebase Cloud Messaging.
   "projectId": "A String", # Immutable. A user-assigned unique identifier for the `FirebaseProject`.
+  "projectNumber": "A String", # Output only. Immutable. The globally unique, Google-assigned canonical identifier for the Project. Use this identifier when configuring integrations and/or making API calls to Google Cloud or third-party services.
+  "realtimeDatabaseUrl": "A String", # Optional. Duplicate field for the URL of the default RTDB instances (if there is one) that uses the same field name as the unified V2 config file format. We wanted to make a single config file format for all the app platforms (Android, iOS and web) and we had to pick consistent names for all the fields since there was some varience between the platforms. If the request asks for the V2 format we will populate this field instead of realtime_database_instance_uri.
   "storageBucket": "A String", # **DEPRECATED.** _Instead, find the default Cloud Storage for Firebase bucket using the [list endpoint](https://firebase.google.com/docs/reference/rest/storage/rest/v1beta/projects.buckets/list) within the Cloud Storage for Firebase REST API. Note that the default bucket for the Project might not yet be provisioned, so the return might not contain a default bucket._ The default Cloud Storage for Firebase storage bucket name.
+  "version": "A String", # Version of the config specification.
 }
 
 
diff --git a/googleapiclient/discovery_cache/documents/firebase.v1beta1.json b/googleapiclient/discovery_cache/documents/firebase.v1beta1.json
index 795c9cd50b5..355eb33d503 100644
--- a/googleapiclient/discovery_cache/documents/firebase.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/firebase.v1beta1.json
@@ -1324,7 +1324,7 @@
 }
 }
 },
-"revision": "20240705",
+"revision": "20240913",
 "rootUrl": "https://firebase.googleapis.com/",
 "schemas": {
 "AddFirebaseRequest": {
@@ -2343,10 +2343,23 @@
 "description": "Immutable. A user-assigned unique identifier for the `FirebaseProject`.",
 "type": "string"
 },
+"projectNumber": {
+"description": "Output only. Immutable. The globally unique, Google-assigned canonical identifier for the Project. Use this identifier when configuring integrations and/or making API calls to Google Cloud or third-party services.",
+"readOnly": true,
+"type": "string"
+},
+"realtimeDatabaseUrl": {
+"description": "Optional. Duplicate field for the URL of the default RTDB instances (if there is one) that uses the same field name as the unified V2 config file format. We wanted to make a single config file format for all the app platforms (Android, iOS and web) and we had to pick consistent names for all the fields since there was some varience between the platforms. If the request asks for the V2 format we will populate this field instead of realtime_database_instance_uri.",
+"type": "string"
+},
 "storageBucket": {
 "deprecated": true,
 "description": "**DEPRECATED.** _Instead, find the default Cloud Storage for Firebase bucket using the [list endpoint](https://firebase.google.com/docs/reference/rest/storage/rest/v1beta/projects.buckets/list) within the Cloud Storage for Firebase REST API. Note that the default bucket for the Project might not yet be provisioned, so the return might not contain a default bucket._ The default Cloud Storage for Firebase storage bucket name.",
 "type": "string"
+},
+"version": {
+"description": "Version of the config specification.",
+"type": "string"
 }
 },
 "type": "object"

From 700ed6f54faefa91934cf66013fdbff27268b92e Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:05 +0000
Subject: [PATCH 19/32] feat(firebaseml): update the api

#### firebaseml:v2beta

The following keys were added:
- schemas.GoogleCloudAiplatformV1beta1Candidate.properties.logprobsResult (Total Keys: 2)
- schemas.GoogleCloudAiplatformV1beta1CountTokensRequest.properties.generationConfig.$ref (Total Keys: 1)
- schemas.GoogleCloudAiplatformV1beta1GenerateContentRequest.properties.labels (Total Keys: 2)
- schemas.GoogleCloudAiplatformV1beta1GenerateContentResponse.properties.modelVersion (Total Keys: 2)
- schemas.GoogleCloudAiplatformV1beta1GenerationConfig.properties.logprobs (Total Keys: 2)
- schemas.GoogleCloudAiplatformV1beta1GenerationConfig.properties.responseLogprobs.type (Total Keys: 1)
- schemas.GoogleCloudAiplatformV1beta1LogprobsResult (Total Keys: 17)
- schemas.GoogleCloudAiplatformV1beta1Schema.properties.propertyOrdering (Total Keys: 2)
---
 ....projects.locations.publishers.models.html | 137 +++++++++++++++++-
 .../documents/firebaseml.v2beta.json          | 109 +++++++++++++-
 2 files changed, 237 insertions(+), 9 deletions(-)

diff --git a/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html b/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html
index a25d9d97ade..941e7fc0b98 100644
--- a/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html
+++ b/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html
@@ -136,6 +136,61 @@ Method Details
       "role": "A String", # Optional. The producer of the content. Must be either 'user' or 'model'. Useful to set for multi-turn conversations, otherwise can be left blank or unset.
     },
   ],
+  "generationConfig": { # Generation config. # Optional. Generation config that the model will use to generate the response.
+    "candidateCount": 42, # Optional. Number of candidates to generate.
+    "frequencyPenalty": 3.14, # Optional. Frequency penalties.
+    "logprobs": 42, # Optional. Logit probabilities.
+    "maxOutputTokens": 42, # Optional. The maximum number of output tokens to generate per message.
+    "presencePenalty": 3.14, # Optional. Positive penalties.
+    "responseLogprobs": True or False, # Optional. If true, export the logprobs results in response.
+    "responseMimeType": "A String", # Optional. Output response mimetype of the generated candidate text. Supported mimetype: - `text/plain`: (default) Text output. - `application/json`: JSON response in the candidates. The model needs to be prompted to output the appropriate response type, otherwise the behavior is undefined. This is a preview feature.
+    "responseSchema": { # Schema is used to define the format of input/output data. Represents a select subset of an [OpenAPI 3.0 schema object](https://spec.openapis.org/oas/v3.0.3#schema-object). More fields may be added in the future as needed. # Optional. The `Schema` object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. Represents a select subset of an [OpenAPI 3.0 schema object](https://spec.openapis.org/oas/v3.0.3#schema). If set, a compatible response_mime_type must also be set. Compatible mimetypes: `application/json`: Schema for JSON response.
+      "default": "", # Optional. Default value of the data.
+      "description": "A String", # Optional. The description of the data.
+      "enum": [ # Optional. Possible values of the element of Type.STRING with enum format. For example we can define an Enum Direction as : {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]}
+        "A String",
+      ],
+      "example": "", # Optional. Example of the object. Will only populated when the object is the root.
+      "format": "A String", # Optional. The format of the data. Supported formats: for NUMBER type: "float", "double" for INTEGER type: "int32", "int64" for STRING type: "email", "byte", etc
+      "items": # Object with schema name: GoogleCloudAiplatformV1beta1Schema # Optional. SCHEMA FIELDS FOR TYPE ARRAY Schema of the elements of Type.ARRAY.
+      "maxItems": "A String", # Optional. Maximum number of the elements for Type.ARRAY.
+      "maxLength": "A String", # Optional. Maximum length of the Type.STRING
+      "maxProperties": "A String", # Optional. Maximum number of the properties for Type.OBJECT.
+      "maximum": 3.14, # Optional. Maximum value of the Type.INTEGER and Type.NUMBER
+      "minItems": "A String", # Optional. Minimum number of the elements for Type.ARRAY.
+      "minLength": "A String", # Optional. SCHEMA FIELDS FOR TYPE STRING Minimum length of the Type.STRING
+      "minProperties": "A String", # Optional. Minimum number of the properties for Type.OBJECT.
+      "minimum": 3.14, # Optional. SCHEMA FIELDS FOR TYPE INTEGER and NUMBER Minimum value of the Type.INTEGER and Type.NUMBER
+      "nullable": True or False, # Optional. Indicates if the value may be null.
+      "pattern": "A String", # Optional. Pattern of the Type.STRING to restrict a string to a regular expression.
+      "properties": { # Optional. SCHEMA FIELDS FOR TYPE OBJECT Properties of Type.OBJECT.
+        "a_key": # Object with schema name: GoogleCloudAiplatformV1beta1Schema
+      },
+      "propertyOrdering": [ # Optional. The order of the properties. Not a standard field in open api spec. Only used to support the order of the properties.
+        "A String",
+      ],
+      "required": [ # Optional. Required properties of Type.OBJECT.
+        "A String",
+      ],
+      "title": "A String", # Optional. The title of the Schema.
+      "type": "A String", # Optional. The type of the data.
+    },
+    "routingConfig": { # The configuration for routing the request to a specific model. # Optional. Routing configuration.
+      "autoMode": { # When automated routing is specified, the routing will be determined by the pretrained routing model and customer provided model routing preference. # Automated routing.
+        "modelRoutingPreference": "A String", # The model routing preference.
+      },
+      "manualMode": { # When manual routing is set, the specified model will be used directly. # Manual routing.
+        "modelName": "A String", # The model name to use. Only the public LLM models are accepted. e.g. 'gemini-1.5-pro-001'.
+      },
+    },
+    "seed": 42, # Optional. Seed.
+    "stopSequences": [ # Optional. Stop sequences.
+      "A String",
+    ],
+    "temperature": 3.14, # Optional. Controls the randomness of predictions.
+    "topK": 3.14, # Optional. If specified, top-k sampling will be used.
+    "topP": 3.14, # Optional. If specified, nucleus sampling will be used.
+  },
   "instances": [ # Optional. The instances that are the input to token counting call. Schema is identical to the prediction schema of the underlying model.
     "",
   ],
@@ -174,7 +229,7 @@ Method Details
   },
   "tools": [ # Optional. A list of `Tools` the model may use to generate the next response. A `Tool` is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model.
     { # Tool details that the model may use to generate response. A `Tool` is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model. A Tool object should contain exactly one type of Tool (e.g FunctionDeclaration, Retrieval or GoogleSearchRetrieval).
-      "functionDeclarations": [ # Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 64 function declarations can be provided.
+      "functionDeclarations": [ # Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 128 function declarations can be provided.
         { # Structured representation of a function declaration as defined by the [OpenAPI 3.0 specification](https://spec.openapis.org/oas/v3.0.3). Included in this declaration are the function name and parameters. This FunctionDeclaration is a representation of a block of code that can be used as a `Tool` by the model and executed by the client.
           "description": "A String", # Optional. Description and purpose of the function. Model uses it to decide how and whether to call the function.
           "name": "A String", # Required. The name of the function to call. Must start with a letter or an underscore. Must be a-z, A-Z, 0-9, or contain underscores, dots and dashes, with a maximum length of 64.
@@ -200,6 +255,9 @@ Method Details
             "properties": { # Optional. SCHEMA FIELDS FOR TYPE OBJECT Properties of Type.OBJECT.
               "a_key": # Object with schema name: GoogleCloudAiplatformV1beta1Schema
             },
+            "propertyOrdering": [ # Optional. The order of the properties. Not a standard field in open api spec. Only used to support the order of the properties.
+              "A String",
+            ],
             "required": [ # Optional. Required properties of Type.OBJECT.
               "A String",
             ],
@@ -228,6 +286,9 @@ Method Details
             "properties": { # Optional. SCHEMA FIELDS FOR TYPE OBJECT Properties of Type.OBJECT.
               "a_key": # Object with schema name: GoogleCloudAiplatformV1beta1Schema
             },
+            "propertyOrdering": [ # Optional. The order of the properties. Not a standard field in open api spec. Only used to support the order of the properties.
+              "A String",
+            ],
             "required": [ # Optional. Required properties of Type.OBJECT.
               "A String",
             ],
@@ -325,8 +386,10 @@ Method Details
   "generationConfig": { # Generation config. # Optional. Generation config.
     "candidateCount": 42, # Optional. Number of candidates to generate.
     "frequencyPenalty": 3.14, # Optional. Frequency penalties.
+    "logprobs": 42, # Optional. Logit probabilities.
     "maxOutputTokens": 42, # Optional. The maximum number of output tokens to generate per message.
     "presencePenalty": 3.14, # Optional. Positive penalties.
+    "responseLogprobs": True or False, # Optional. If true, export the logprobs results in response.
     "responseMimeType": "A String", # Optional. Output response mimetype of the generated candidate text. Supported mimetype: - `text/plain`: (default) Text output. - `application/json`: JSON response in the candidates. The model needs to be prompted to output the appropriate response type, otherwise the behavior is undefined. This is a preview feature.
     "responseSchema": { # Schema is used to define the format of input/output data. Represents a select subset of an [OpenAPI 3.0 schema object](https://spec.openapis.org/oas/v3.0.3#schema-object). More fields may be added in the future as needed. # Optional. The `Schema` object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. Represents a select subset of an [OpenAPI 3.0 schema object](https://spec.openapis.org/oas/v3.0.3#schema). If set, a compatible response_mime_type must also be set. Compatible mimetypes: `application/json`: Schema for JSON response.
       "default": "", # Optional. Default value of the data.
@@ -350,6 +413,9 @@ Method Details
       "properties": { # Optional. SCHEMA FIELDS FOR TYPE OBJECT Properties of Type.OBJECT.
         "a_key": # Object with schema name: GoogleCloudAiplatformV1beta1Schema
       },
+      "propertyOrdering": [ # Optional. The order of the properties. Not a standard field in open api spec. Only used to support the order of the properties.
+        "A String",
+      ],
       "required": [ # Optional. Required properties of Type.OBJECT.
         "A String",
       ],
@@ -372,6 +438,9 @@ Method Details
     "topK": 3.14, # Optional. If specified, top-k sampling will be used.
     "topP": 3.14, # Optional. If specified, nucleus sampling will be used.
   },
+  "labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.
+    "a_key": "A String",
+  },
   "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates.
     { # Safety settings.
       "category": "A String", # Required. Harm category.
@@ -421,7 +490,7 @@ Method Details
   },
   "tools": [ # Optional. A list of `Tools` the model may use to generate the next response. A `Tool` is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model.
     { # Tool details that the model may use to generate response. A `Tool` is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model. A Tool object should contain exactly one type of Tool (e.g FunctionDeclaration, Retrieval or GoogleSearchRetrieval).
-      "functionDeclarations": [ # Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 64 function declarations can be provided.
+      "functionDeclarations": [ # Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 128 function declarations can be provided.
         { # Structured representation of a function declaration as defined by the [OpenAPI 3.0 specification](https://spec.openapis.org/oas/v3.0.3). Included in this declaration are the function name and parameters. This FunctionDeclaration is a representation of a block of code that can be used as a `Tool` by the model and executed by the client.
           "description": "A String", # Optional. Description and purpose of the function. Model uses it to decide how and whether to call the function.
           "name": "A String", # Required. The name of the function to call. Must start with a letter or an underscore. Must be a-z, A-Z, 0-9, or contain underscores, dots and dashes, with a maximum length of 64.
@@ -447,6 +516,9 @@ Method Details
             "properties": { # Optional. SCHEMA FIELDS FOR TYPE OBJECT Properties of Type.OBJECT.
               "a_key": # Object with schema name: GoogleCloudAiplatformV1beta1Schema
             },
+            "propertyOrdering": [ # Optional. The order of the properties. Not a standard field in open api spec. Only used to support the order of the properties.
+              "A String",
+            ],
             "required": [ # Optional. Required properties of Type.OBJECT.
               "A String",
             ],
@@ -475,6 +547,9 @@ Method Details
             "properties": { # Optional. SCHEMA FIELDS FOR TYPE OBJECT Properties of Type.OBJECT.
               "a_key": # Object with schema name: GoogleCloudAiplatformV1beta1Schema
             },
+            "propertyOrdering": [ # Optional. The order of the properties. Not a standard field in open api spec. Only used to support the order of the properties.
+              "A String",
+            ],
             "required": [ # Optional. Required properties of Type.OBJECT.
               "A String",
             ],
@@ -613,6 +688,26 @@ Method Details
         ],
       },
       "index": 42, # Output only. Index of the candidate.
+      "logprobsResult": { # Logprobs Result # Output only. Log-likelihood scores for the response tokens and top tokens
+        "chosenCandidates": [ # Length = total number of decoding steps. The chosen candidates may or may not be in top_candidates.
+          { # Candidate for the logprobs token and score.
+            "logProbability": 3.14, # The candidate's log probability.
+            "token": "A String", # The candidate’s token string value.
+            "tokenId": 42, # The candidate’s token id value.
+          },
+        ],
+        "topCandidates": [ # Length = total number of decoding steps.
+          { # Candidates with top log probabilities at each decoding step.
+            "candidates": [ # Sorted by log probability in descending order.
+              { # Candidate for the logprobs token and score.
+                "logProbability": 3.14, # The candidate's log probability.
+                "token": "A String", # The candidate’s token string value.
+                "tokenId": 42, # The candidate’s token id value.
+              },
+            ],
+          },
+        ],
+      },
       "safetyRatings": [ # Output only. List of ratings for the safety of a response candidate. There is at most one rating per category.
         { # Safety rating corresponding to the generated content.
           "blocked": True or False, # Output only. Indicates whether the content was filtered out because of this rating.
@@ -625,6 +720,7 @@ Method Details
       ],
     },
   ],
+  "modelVersion": "A String", # Output only. The model version used to generate the response.
   "promptFeedback": { # Content filter results for a prompt sent in the request. # Output only. Content filter results for a prompt sent in the request. Note: Sent only in the first stream chunk. Only happens when no candidates were generated due to content violations.
     "blockReason": "A String", # Output only. Blocked reason.
     "blockReasonMessage": "A String", # Output only. A readable block reason message.
@@ -696,8 +792,10 @@ Method Details
   "generationConfig": { # Generation config. # Optional. Generation config.
     "candidateCount": 42, # Optional. Number of candidates to generate.
     "frequencyPenalty": 3.14, # Optional. Frequency penalties.
+    "logprobs": 42, # Optional. Logit probabilities.
     "maxOutputTokens": 42, # Optional. The maximum number of output tokens to generate per message.
     "presencePenalty": 3.14, # Optional. Positive penalties.
+    "responseLogprobs": True or False, # Optional. If true, export the logprobs results in response.
     "responseMimeType": "A String", # Optional. Output response mimetype of the generated candidate text. Supported mimetype: - `text/plain`: (default) Text output. - `application/json`: JSON response in the candidates. The model needs to be prompted to output the appropriate response type, otherwise the behavior is undefined. This is a preview feature.
     "responseSchema": { # Schema is used to define the format of input/output data. Represents a select subset of an [OpenAPI 3.0 schema object](https://spec.openapis.org/oas/v3.0.3#schema-object). More fields may be added in the future as needed. # Optional. The `Schema` object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. Represents a select subset of an [OpenAPI 3.0 schema object](https://spec.openapis.org/oas/v3.0.3#schema). If set, a compatible response_mime_type must also be set. Compatible mimetypes: `application/json`: Schema for JSON response.
       "default": "", # Optional. Default value of the data.
@@ -721,6 +819,9 @@ Method Details
       "properties": { # Optional. SCHEMA FIELDS FOR TYPE OBJECT Properties of Type.OBJECT.
         "a_key": # Object with schema name: GoogleCloudAiplatformV1beta1Schema
       },
+      "propertyOrdering": [ # Optional. The order of the properties. Not a standard field in open api spec. Only used to support the order of the properties.
+        "A String",
+      ],
       "required": [ # Optional. Required properties of Type.OBJECT.
         "A String",
       ],
@@ -743,6 +844,9 @@ Method Details
     "topK": 3.14, # Optional. If specified, top-k sampling will be used.
     "topP": 3.14, # Optional. If specified, nucleus sampling will be used.
   },
+  "labels": { # Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.
+    "a_key": "A String",
+  },
   "safetySettings": [ # Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates.
     { # Safety settings.
       "category": "A String", # Required. Harm category.
@@ -792,7 +896,7 @@ Method Details
   },
   "tools": [ # Optional. A list of `Tools` the model may use to generate the next response. A `Tool` is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model.
     { # Tool details that the model may use to generate response. A `Tool` is a piece of code that enables the system to interact with external systems to perform an action, or set of actions, outside of knowledge and scope of the model. A Tool object should contain exactly one type of Tool (e.g FunctionDeclaration, Retrieval or GoogleSearchRetrieval).
-      "functionDeclarations": [ # Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 64 function declarations can be provided.
+      "functionDeclarations": [ # Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 128 function declarations can be provided.
         { # Structured representation of a function declaration as defined by the [OpenAPI 3.0 specification](https://spec.openapis.org/oas/v3.0.3). Included in this declaration are the function name and parameters. This FunctionDeclaration is a representation of a block of code that can be used as a `Tool` by the model and executed by the client.
           "description": "A String", # Optional. Description and purpose of the function. Model uses it to decide how and whether to call the function.
           "name": "A String", # Required. The name of the function to call. Must start with a letter or an underscore. Must be a-z, A-Z, 0-9, or contain underscores, dots and dashes, with a maximum length of 64.
@@ -818,6 +922,9 @@ Method Details
             "properties": { # Optional. SCHEMA FIELDS FOR TYPE OBJECT Properties of Type.OBJECT.
               "a_key": # Object with schema name: GoogleCloudAiplatformV1beta1Schema
             },
+            "propertyOrdering": [ # Optional. The order of the properties. Not a standard field in open api spec. Only used to support the order of the properties.
+              "A String",
+            ],
             "required": [ # Optional. Required properties of Type.OBJECT.
               "A String",
             ],
@@ -846,6 +953,9 @@ Method Details
             "properties": { # Optional. SCHEMA FIELDS FOR TYPE OBJECT Properties of Type.OBJECT.
               "a_key": # Object with schema name: GoogleCloudAiplatformV1beta1Schema
             },
+            "propertyOrdering": [ # Optional. The order of the properties. Not a standard field in open api spec. Only used to support the order of the properties.
+              "A String",
+            ],
             "required": [ # Optional. Required properties of Type.OBJECT.
               "A String",
             ],
@@ -984,6 +1094,26 @@ Method Details
         ],
       },
       "index": 42, # Output only. Index of the candidate.
+      "logprobsResult": { # Logprobs Result # Output only. Log-likelihood scores for the response tokens and top tokens
+        "chosenCandidates": [ # Length = total number of decoding steps. The chosen candidates may or may not be in top_candidates.
+          { # Candidate for the logprobs token and score.
+            "logProbability": 3.14, # The candidate's log probability.
+            "token": "A String", # The candidate’s token string value.
+            "tokenId": 42, # The candidate’s token id value.
+          },
+        ],
+        "topCandidates": [ # Length = total number of decoding steps.
+          { # Candidates with top log probabilities at each decoding step.
+            "candidates": [ # Sorted by log probability in descending order.
+              { # Candidate for the logprobs token and score.
+                "logProbability": 3.14, # The candidate's log probability.
+                "token": "A String", # The candidate’s token string value.
+                "tokenId": 42, # The candidate’s token id value.
+              },
+            ],
+          },
+        ],
+      },
       "safetyRatings": [ # Output only. List of ratings for the safety of a response candidate. There is at most one rating per category.
         { # Safety rating corresponding to the generated content.
           "blocked": True or False, # Output only. Indicates whether the content was filtered out because of this rating.
@@ -996,6 +1126,7 @@ Method Details
       ],
     },
   ],
+  "modelVersion": "A String", # Output only. The model version used to generate the response.
   "promptFeedback": { # Content filter results for a prompt sent in the request. # Output only. Content filter results for a prompt sent in the request. Note: Sent only in the first stream chunk. Only happens when no candidates were generated due to content violations.
     "blockReason": "A String", # Output only. Blocked reason.
     "blockReasonMessage": "A String", # Output only. A readable block reason message.
diff --git a/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json b/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json
index 6418e622def..f9550115bdb 100644
--- a/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json
+++ b/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json
@@ -206,7 +206,7 @@
 }
 }
 },
-"revision": "20240902",
+"revision": "20240911",
 "rootUrl": "https://firebaseml.googleapis.com/",
 "schemas": {
 "Date": {
@@ -312,6 +312,11 @@
 "readOnly": true,
 "type": "integer"
 },
+"logprobsResult": {
+"$ref": "GoogleCloudAiplatformV1beta1LogprobsResult",
+"description": "Output only. Log-likelihood scores for the response tokens and top tokens",
+"readOnly": true
+},
 "safetyRatings": {
 "description": "Output only. List of ratings for the safety of a response candidate. There is at most one rating per category.",
 "items": {
@@ -406,6 +411,10 @@
 },
 "type": "array"
 },
+"generationConfig": {
+"$ref": "GoogleCloudAiplatformV1beta1GenerationConfig",
+"description": "Optional. Generation config that the model will use to generate the response."
+},
 "instances": {
 "description": "Optional. The instances that are the input to token counting call. Schema is identical to the prediction schema of the underlying model.",
 "items": {
@@ -573,6 +582,13 @@
 "$ref": "GoogleCloudAiplatformV1beta1GenerationConfig",
 "description": "Optional. Generation config."
 },
+"labels": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Optional. The labels with user-defined metadata for the request. It is used for billing and reporting only. Label keys and values can be no longer than 63 characters (Unicode codepoints) and can only contain lowercase letters, numeric characters, underscores, and dashes. International characters are allowed. Label values are optional. Label keys must start with a letter.",
+"type": "object"
+},
 "safetySettings": {
 "description": "Optional. Per request settings for blocking unsafe content. Enforced on GenerateContentResponse.candidates.",
 "items": {
@@ -610,6 +626,11 @@
 "readOnly": true,
 "type": "array"
 },
+"modelVersion": {
+"description": "Output only. The model version used to generate the response.",
+"readOnly": true,
+"type": "string"
+},
 "promptFeedback": {
 "$ref": "GoogleCloudAiplatformV1beta1GenerateContentResponsePromptFeedback",
 "description": "Output only. Content filter results for a prompt sent in the request. Note: Sent only in the first stream chunk. Only happens when no candidates were generated due to content violations.",
@@ -703,6 +724,11 @@
 "format": "float",
 "type": "number"
 },
+"logprobs": {
+"description": "Optional. Logit probabilities.",
+"format": "int32",
+"type": "integer"
+},
 "maxOutputTokens": {
 "description": "Optional. The maximum number of output tokens to generate per message.",
 "format": "int32",
@@ -713,6 +739,10 @@
 "format": "float",
 "type": "number"
 },
+"responseLogprobs": {
+"description": "Optional. If true, export the logprobs results in response.",
+"type": "boolean"
+},
 "responseMimeType": {
 "description": "Optional. Output response mimetype of the generated candidate text. Supported mimetype: - `text/plain`: (default) Text output. - `application/json`: JSON response in the candidates. The model needs to be prompted to output the appropriate response type, otherwise the behavior is undefined. This is a preview feature.",
 "type": "string"
@@ -921,6 +951,62 @@
 },
 "type": "object"
 },
+"GoogleCloudAiplatformV1beta1LogprobsResult": {
+"description": "Logprobs Result",
+"id": "GoogleCloudAiplatformV1beta1LogprobsResult",
+"properties": {
+"chosenCandidates": {
+"description": "Length = total number of decoding steps. The chosen candidates may or may not be in top_candidates.",
+"items": {
+"$ref": "GoogleCloudAiplatformV1beta1LogprobsResultCandidate"
+},
+"type": "array"
+},
+"topCandidates": {
+"description": "Length = total number of decoding steps.",
+"items": {
+"$ref": "GoogleCloudAiplatformV1beta1LogprobsResultTopCandidates"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudAiplatformV1beta1LogprobsResultCandidate": {
+"description": "Candidate for the logprobs token and score.",
+"id": "GoogleCloudAiplatformV1beta1LogprobsResultCandidate",
+"properties": {
+"logProbability": {
+"description": "The candidate's log probability.",
+"format": "float",
+"type": "number"
+},
+"token": {
+"description": "The candidate\u2019s token string value.",
+"type": "string"
+},
+"tokenId": {
+"description": "The candidate\u2019s token id value.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
+"GoogleCloudAiplatformV1beta1LogprobsResultTopCandidates": {
+"description": "Candidates with top log probabilities at each decoding step.",
+"id": "GoogleCloudAiplatformV1beta1LogprobsResultTopCandidates",
+"properties": {
+"candidates": {
+"description": "Sorted by log probability in descending order.",
+"items": {
+"$ref": "GoogleCloudAiplatformV1beta1LogprobsResultCandidate"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "GoogleCloudAiplatformV1beta1Part": {
 "description": "A datatype containing media that is part of a multi-part `Content` message. A `Part` consists of data which has an associated datatype. A `Part` can only contain one of the accepted types in `Part.data`. A `Part` must have a fixed IANA MIME type identifying the type and subtype of the media if `inline_data` or `file_data` field is filled with raw bytes.",
 "id": "GoogleCloudAiplatformV1beta1Part",
@@ -988,14 +1074,16 @@
 "HARM_CATEGORY_HATE_SPEECH",
 "HARM_CATEGORY_DANGEROUS_CONTENT",
 "HARM_CATEGORY_HARASSMENT",
-"HARM_CATEGORY_SEXUALLY_EXPLICIT"
+"HARM_CATEGORY_SEXUALLY_EXPLICIT",
+"HARM_CATEGORY_CIVIC_INTEGRITY"
 ],
 "enumDescriptions": [
 "The harm category is unspecified.",
 "The harm category is hate speech.",
 "The harm category is dangerous content.",
 "The harm category is harassment.",
-"The harm category is sexually explicit content."
+"The harm category is sexually explicit content.",
+"The harm category is civic integrity."
 ],
 "readOnly": true,
 "type": "string"
@@ -1064,14 +1152,16 @@
 "HARM_CATEGORY_HATE_SPEECH",
 "HARM_CATEGORY_DANGEROUS_CONTENT",
 "HARM_CATEGORY_HARASSMENT",
-"HARM_CATEGORY_SEXUALLY_EXPLICIT"
+"HARM_CATEGORY_SEXUALLY_EXPLICIT",
+"HARM_CATEGORY_CIVIC_INTEGRITY"
 ],
 "enumDescriptions": [
 "The harm category is unspecified.",
 "The harm category is hate speech.",
 "The harm category is dangerous content.",
 "The harm category is harassment.",
-"The harm category is sexually explicit content."
+"The harm category is sexually explicit content.",
+"The harm category is civic integrity."
 ],
 "type": "string"
 },
@@ -1198,6 +1288,13 @@
 "description": "Optional. SCHEMA FIELDS FOR TYPE OBJECT Properties of Type.OBJECT.",
 "type": "object"
 },
+"propertyOrdering": {
+"description": "Optional. The order of the properties. Not a standard field in open api spec. Only used to support the order of the properties.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "required": {
 "description": "Optional. Required properties of Type.OBJECT.",
 "items": {
@@ -1285,7 +1382,7 @@
 "id": "GoogleCloudAiplatformV1beta1Tool",
 "properties": {
 "functionDeclarations": {
-"description": "Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 64 function declarations can be provided.",
+"description": "Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populating FunctionCall in the response. User should provide a FunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 128 function declarations can be provided.",
 "items": {
 "$ref": "GoogleCloudAiplatformV1beta1FunctionDeclaration"
 },

From 3433f23611a333faff2001fae63d6e0bd5121e71 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:05 +0000
Subject: [PATCH 20/32] feat(firestore): update the api

#### firestore:v1

The following keys were added:
- resources.projects.resources.locations.resources.backups.methods.list.parameters.filter (Total Keys: 2)
- schemas.GoogleFirestoreAdminV1BackupSource (Total Keys: 3)
- schemas.GoogleFirestoreAdminV1Database.properties.sourceInfo (Total Keys: 2)
- schemas.GoogleFirestoreAdminV1SourceInfo (Total Keys: 4)
---
 docs/dyn/firestore_v1.projects.databases.html | 24 ++++++++++++
 ...restore_v1.projects.locations.backups.html |  5 ++-
 .../documents/firestore.v1.json               | 38 ++++++++++++++++++-
 3 files changed, 64 insertions(+), 3 deletions(-)

diff --git a/docs/dyn/firestore_v1.projects.databases.html b/docs/dyn/firestore_v1.projects.databases.html
index 162b920ead6..c442157724e 100644
--- a/docs/dyn/firestore_v1.projects.databases.html
+++ b/docs/dyn/firestore_v1.projects.databases.html
@@ -205,6 +205,12 @@ Method Details
   "name": "A String", # The resource name of the Database. Format: `projects/{project}/databases/{database}`
   "pointInTimeRecoveryEnablement": "A String", # Whether to enable the PITR feature on this database.
   "previousId": "A String", # Output only. The database resource's prior database ID. This field is only populated for deleted databases.
+  "sourceInfo": { # Information about the provenance of this database. # Output only. Information about the provenance of this database.
+    "backup": { # Information about a backup that was used to restore a database. # If set, this database was restored from the specified backup (or a snapshot thereof).
+      "backup": "A String", # The resource name of the backup that was used to restore this database. Format: `projects/{project}/locations/{location}/backups/{backup}`.
+    },
+    "operation": "A String", # The associated long-running operation. This field may not be set after the operation has completed. Format: `projects/{project}/databases/{database}/operations/{operation}`.
+  },
   "type": "A String", # The type of the database. See https://cloud.google.com/datastore/docs/firestore-or-datastore for information about how to choose.
   "uid": "A String", # Output only. The system-generated UUID4 for this Database.
   "updateTime": "A String", # Output only. The timestamp at which this database was most recently updated. Note this only includes updates to the database resource and not data contained by the database.
@@ -359,6 +365,12 @@ Method Details
   "name": "A String", # The resource name of the Database. Format: `projects/{project}/databases/{database}`
   "pointInTimeRecoveryEnablement": "A String", # Whether to enable the PITR feature on this database.
   "previousId": "A String", # Output only. The database resource's prior database ID. This field is only populated for deleted databases.
+  "sourceInfo": { # Information about the provenance of this database. # Output only. Information about the provenance of this database.
+    "backup": { # Information about a backup that was used to restore a database. # If set, this database was restored from the specified backup (or a snapshot thereof).
+      "backup": "A String", # The resource name of the backup that was used to restore this database. Format: `projects/{project}/locations/{location}/backups/{backup}`.
+    },
+    "operation": "A String", # The associated long-running operation. This field may not be set after the operation has completed. Format: `projects/{project}/databases/{database}/operations/{operation}`.
+  },
   "type": "A String", # The type of the database. See https://cloud.google.com/datastore/docs/firestore-or-datastore for information about how to choose.
   "uid": "A String", # Output only. The system-generated UUID4 for this Database.
   "updateTime": "A String", # Output only. The timestamp at which this database was most recently updated. Note this only includes updates to the database resource and not data contained by the database.
@@ -450,6 +462,12 @@ Method Details
       "name": "A String", # The resource name of the Database. Format: `projects/{project}/databases/{database}`
       "pointInTimeRecoveryEnablement": "A String", # Whether to enable the PITR feature on this database.
       "previousId": "A String", # Output only. The database resource's prior database ID. This field is only populated for deleted databases.
+      "sourceInfo": { # Information about the provenance of this database. # Output only. Information about the provenance of this database.
+        "backup": { # Information about a backup that was used to restore a database. # If set, this database was restored from the specified backup (or a snapshot thereof).
+          "backup": "A String", # The resource name of the backup that was used to restore this database. Format: `projects/{project}/locations/{location}/backups/{backup}`.
+        },
+        "operation": "A String", # The associated long-running operation. This field may not be set after the operation has completed. Format: `projects/{project}/databases/{database}/operations/{operation}`.
+      },
       "type": "A String", # The type of the database. See https://cloud.google.com/datastore/docs/firestore-or-datastore for information about how to choose.
       "uid": "A String", # Output only. The system-generated UUID4 for this Database.
       "updateTime": "A String", # Output only. The timestamp at which this database was most recently updated. Note this only includes updates to the database resource and not data contained by the database.
@@ -490,6 +508,12 @@ Method Details
   "name": "A String", # The resource name of the Database. Format: `projects/{project}/databases/{database}`
   "pointInTimeRecoveryEnablement": "A String", # Whether to enable the PITR feature on this database.
   "previousId": "A String", # Output only. The database resource's prior database ID. This field is only populated for deleted databases.
+  "sourceInfo": { # Information about the provenance of this database. # Output only. Information about the provenance of this database.
+    "backup": { # Information about a backup that was used to restore a database. # If set, this database was restored from the specified backup (or a snapshot thereof).
+      "backup": "A String", # The resource name of the backup that was used to restore this database. Format: `projects/{project}/locations/{location}/backups/{backup}`.
+    },
+    "operation": "A String", # The associated long-running operation. This field may not be set after the operation has completed. Format: `projects/{project}/databases/{database}/operations/{operation}`.
+  },
   "type": "A String", # The type of the database. See https://cloud.google.com/datastore/docs/firestore-or-datastore for information about how to choose.
   "uid": "A String", # Output only. The system-generated UUID4 for this Database.
   "updateTime": "A String", # Output only. The timestamp at which this database was most recently updated. Note this only includes updates to the database resource and not data contained by the database.
diff --git a/docs/dyn/firestore_v1.projects.locations.backups.html b/docs/dyn/firestore_v1.projects.locations.backups.html
index 6bab15f5a85..227b49a7c00 100644
--- a/docs/dyn/firestore_v1.projects.locations.backups.html
+++ b/docs/dyn/firestore_v1.projects.locations.backups.html
@@ -84,7 +84,7 @@ Instance Methods
   get(name, x__xgafv=None)
 Gets information about a backup.
 
-  list(parent, x__xgafv=None)
+  list(parent, filter=None, x__xgafv=None)
 Lists all the backups.
 Method Details
 
@@ -140,11 +140,12 @@ Method Details
 
 
 
-    list(parent, x__xgafv=None)
+    list(parent, filter=None, x__xgafv=None)
   Lists all the backups.
 
 Args:
   parent: string, Required. The location to list backups from. Format is `projects/{project}/locations/{location}`. Use `{location} = '-'` to list backups from all locations for the given project. This allows listing backups from a single location or from all locations. (required)
+  filter: string, An expression that filters the list of returned backups. A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`. Colon `:` is the contains operator. Filter rules are not case sensitive. The following fields in the Backup are eligible for filtering: * `database_uid` (supports `=` only)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
diff --git a/googleapiclient/discovery_cache/documents/firestore.v1.json b/googleapiclient/discovery_cache/documents/firestore.v1.json
index aac2e375a20..f0ff64e08c9 100644
--- a/googleapiclient/discovery_cache/documents/firestore.v1.json
+++ b/googleapiclient/discovery_cache/documents/firestore.v1.json
@@ -1682,6 +1682,11 @@
 "parent"
 ],
 "parameters": {
+"filter": {
+"description": "An expression that filters the list of returned backups. A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be one of: `<`, `>`, `<=`, `>=`, `!=`, `=`, or `:`. Colon `:` is the contains operator. Filter rules are not case sensitive. The following fields in the Backup are eligible for filtering: * `database_uid` (supports `=` only)",
+"location": "query",
+"type": "string"
+},
 "parent": {
 "description": "Required. The location to list backups from. Format is `projects/{project}/locations/{location}`. Use `{location} = '-'` to list backups from all locations for the given project. This allows listing backups from a single location or from all locations.",
 "location": "path",
@@ -1706,7 +1711,7 @@
 }
 }
 },
-"revision": "20240822",
+"revision": "20240904",
 "rootUrl": "https://firestore.googleapis.com/",
 "schemas": {
 "Aggregation": {
@@ -2525,6 +2530,17 @@
 },
 "type": "object"
 },
+"GoogleFirestoreAdminV1BackupSource": {
+"description": "Information about a backup that was used to restore a database.",
+"id": "GoogleFirestoreAdminV1BackupSource",
+"properties": {
+"backup": {
+"description": "The resource name of the backup that was used to restore this database. Format: `projects/{project}/locations/{location}/backups/{backup}`.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleFirestoreAdminV1BulkDeleteDocumentsMetadata": {
 "description": "Metadata for google.longrunning.Operation results from FirestoreAdmin.BulkDeleteDocuments.",
 "id": "GoogleFirestoreAdminV1BulkDeleteDocumentsMetadata",
@@ -2762,6 +2778,11 @@
 "readOnly": true,
 "type": "string"
 },
+"sourceInfo": {
+"$ref": "GoogleFirestoreAdminV1SourceInfo",
+"description": "Output only. Information about the provenance of this database.",
+"readOnly": true
+},
 "type": {
 "description": "The type of the database. See https://cloud.google.com/datastore/docs/firestore-or-datastore for information about how to choose.",
 "enum": [
@@ -3521,6 +3542,21 @@
 "properties": {},
 "type": "object"
 },
+"GoogleFirestoreAdminV1SourceInfo": {
+"description": "Information about the provenance of this database.",
+"id": "GoogleFirestoreAdminV1SourceInfo",
+"properties": {
+"backup": {
+"$ref": "GoogleFirestoreAdminV1BackupSource",
+"description": "If set, this database was restored from the specified backup (or a snapshot thereof)."
+},
+"operation": {
+"description": "The associated long-running operation. This field may not be set after the operation has completed. Format: `projects/{project}/databases/{database}/operations/{operation}`.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleFirestoreAdminV1Stats": {
 "description": "Backup specific statistics.",
 "id": "GoogleFirestoreAdminV1Stats",

From 8ffba99c4f6094dcf42fa8a85acfadf275700240 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:05 +0000
Subject: [PATCH 21/32] feat(gkehub): update the api

#### gkehub:v1alpha

The following keys were added:
- resources.projects.resources.locations.resources.memberships.methods.generateExclusivityManifest (Total Keys: 15)
- resources.projects.resources.locations.resources.memberships.methods.validateExclusivity (Total Keys: 15)
- schemas.GenerateExclusivityManifestResponse (Total Keys: 4)
- schemas.ValidateExclusivityResponse (Total Keys: 3)
---
 ...1alpha.projects.locations.memberships.html | 57 +++++++++++
 .../documents/gkehub.v1alpha.json             | 98 ++++++++++++++++++-
 2 files changed, 154 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/gkehub_v1alpha.projects.locations.memberships.html b/docs/dyn/gkehub_v1alpha.projects.locations.memberships.html
index d3e56bfa517..b9869d95211 100644
--- a/docs/dyn/gkehub_v1alpha.projects.locations.memberships.html
+++ b/docs/dyn/gkehub_v1alpha.projects.locations.memberships.html
@@ -96,6 +96,9 @@ Instance Methods
 
   generateConnectManifest(name, imagePullSecretContent=None, isUpgrade=None, namespace=None, proxy=None, registry=None, version=None, x__xgafv=None)
 Generates the manifest for deployment of the GKE connect agent. **This method is used internally by Google-provided libraries.** Most clients should not need to call this method directly.
+
+  generateExclusivityManifest(name, crManifest=None, crdManifest=None, x__xgafv=None)
+GenerateExclusivityManifest generates the manifests to update the exclusivity artifacts in the cluster if needed. Exclusivity artifacts include the Membership custom resource definition (CRD) and the singleton Membership custom resource (CR). Combined with ValidateExclusivity, exclusivity artifacts guarantee that a Kubernetes cluster is only registered to a single GKE Hub. The Membership CRD is versioned, and may require conversion when the GKE Hub API server begins serving a newer version of the CRD and corresponding CR. The response will be the converted CRD and CR if there are any differences between the versions.
 
   get(name, x__xgafv=None)
 Gets the details of a Membership.
@@ -126,6 +129,9 @@ Instance Methods
 
   validateCreate(parent, body=None, x__xgafv=None)
 ValidateCreateMembership is a preflight check for CreateMembership. It checks the following: 1. Caller has the required `gkehub.memberships.create` permission. 2. The membership_id is still available.
+
+  validateExclusivity(parent, crManifest=None, intendedMembership=None, x__xgafv=None)
+ValidateExclusivity validates the state of exclusivity in the cluster. The validation does not depend on an existing Hub membership resource.
 Method Details
 
     close()
@@ -323,6 +329,28 @@ Method Details
 }
 
 
+
+    generateExclusivityManifest(name, crManifest=None, crdManifest=None, x__xgafv=None)
+  GenerateExclusivityManifest generates the manifests to update the exclusivity artifacts in the cluster if needed. Exclusivity artifacts include the Membership custom resource definition (CRD) and the singleton Membership custom resource (CR). Combined with ValidateExclusivity, exclusivity artifacts guarantee that a Kubernetes cluster is only registered to a single GKE Hub. The Membership CRD is versioned, and may require conversion when the GKE Hub API server begins serving a newer version of the CRD and corresponding CR. The response will be the converted CRD and CR if there are any differences between the versions.
+
+Args:
+  name: string, Required. The Membership resource name in the format `projects/*/locations/*/memberships/*`. (required)
+  crManifest: string, Optional. The YAML manifest of the membership CR retrieved by `kubectl get memberships membership`. Leave empty if the resource does not exist.
+  crdManifest: string, Optional. The YAML manifest of the membership CRD retrieved by `kubectl get customresourcedefinitions membership`. Leave empty if the resource does not exist.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The response of the exclusivity artifacts manifests for the client to apply.
+  "crManifest": "A String", # The YAML manifest of the membership CR to apply if a new version of the CR is available. Empty if no update needs to be applied.
+  "crdManifest": "A String", # The YAML manifest of the membership CRD to apply if a newer version of the CRD is available. Empty if no update needs to be applied.
+}
+
+
 
     get(name, x__xgafv=None)
   Gets the details of a Membership.
@@ -1059,4 +1087,33 @@ Method Details
 }
 
 
+
+    validateExclusivity(parent, crManifest=None, intendedMembership=None, x__xgafv=None)
+  ValidateExclusivity validates the state of exclusivity in the cluster. The validation does not depend on an existing Hub membership resource.
+
+Args:
+  parent: string, Required. The parent (project and location) where the Memberships will be created. Specified in the format `projects/*/locations/*`. (required)
+  crManifest: string, Optional. The YAML of the membership CR in the cluster. Empty if the membership CR does not exist.
+  intendedMembership: string, Required. The intended membership name under the `parent`. This method only does validation in anticipation of a CreateMembership call with the same name.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The response of exclusivity artifacts validation result status.
+  "status": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The validation result. * `OK` means that exclusivity is validated, assuming the manifest produced by GenerateExclusivityManifest is successfully applied. * `ALREADY_EXISTS` means that the Membership CRD is already owned by another Hub. See `status.message` for more information.
+    "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+    "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+      {
+        "a_key": "", # Properties of the object. Contains field @type with type URL.
+      },
+    ],
+    "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+  },
+}
+
+
 
\ No newline at end of file
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json b/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json
index d549054490d..447f6b97d8d 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json
@@ -793,6 +793,41 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"generateExclusivityManifest": {
+"description": "GenerateExclusivityManifest generates the manifests to update the exclusivity artifacts in the cluster if needed. Exclusivity artifacts include the Membership custom resource definition (CRD) and the singleton Membership custom resource (CR). Combined with ValidateExclusivity, exclusivity artifacts guarantee that a Kubernetes cluster is only registered to a single GKE Hub. The Membership CRD is versioned, and may require conversion when the GKE Hub API server begins serving a newer version of the CRD and corresponding CR. The response will be the converted CRD and CR if there are any differences between the versions.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/memberships/{membershipsId}:generateExclusivityManifest",
+"httpMethod": "GET",
+"id": "gkehub.projects.locations.memberships.generateExclusivityManifest",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"crManifest": {
+"description": "Optional. The YAML manifest of the membership CR retrieved by `kubectl get memberships membership`. Leave empty if the resource does not exist.",
+"location": "query",
+"type": "string"
+},
+"crdManifest": {
+"description": "Optional. The YAML manifest of the membership CRD retrieved by `kubectl get customresourcedefinitions membership`. Leave empty if the resource does not exist.",
+"location": "query",
+"type": "string"
+},
+"name": {
+"description": "Required. The Membership resource name in the format `projects/*/locations/*/memberships/*`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/memberships/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+name}:generateExclusivityManifest",
+"response": {
+"$ref": "GenerateExclusivityManifestResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "get": {
 "description": "Gets the details of a Membership.",
 "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/memberships/{membershipsId}",
@@ -1063,6 +1098,41 @@
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
 ]
+},
+"validateExclusivity": {
+"description": "ValidateExclusivity validates the state of exclusivity in the cluster. The validation does not depend on an existing Hub membership resource.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/memberships:validateExclusivity",
+"httpMethod": "GET",
+"id": "gkehub.projects.locations.memberships.validateExclusivity",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"crManifest": {
+"description": "Optional. The YAML of the membership CR in the cluster. Empty if the membership CR does not exist.",
+"location": "query",
+"type": "string"
+},
+"intendedMembership": {
+"description": "Required. The intended membership name under the `parent`. This method only does validation in anticipation of a CreateMembership call with the same name.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent (project and location) where the Memberships will be created. Specified in the format `projects/*/locations/*`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+parent}/memberships:validateExclusivity",
+"response": {
+"$ref": "ValidateExclusivityResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
 }
 },
 "resources": {
@@ -2185,7 +2255,7 @@
 }
 }
 },
-"revision": "20240902",
+"revision": "20240909",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AnthosObservabilityFeatureSpec": {
@@ -4351,6 +4421,21 @@
 },
 "type": "object"
 },
+"GenerateExclusivityManifestResponse": {
+"description": "The response of the exclusivity artifacts manifests for the client to apply.",
+"id": "GenerateExclusivityManifestResponse",
+"properties": {
+"crManifest": {
+"description": "The YAML manifest of the membership CR to apply if a new version of the CR is available. Empty if no update needs to be applied.",
+"type": "string"
+},
+"crdManifest": {
+"description": "The YAML manifest of the membership CRD to apply if a newer version of the CRD is available. Empty if no update needs to be applied.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GenerateMembershipRBACRoleBindingYAMLResponse": {
 "description": "Response for GenerateRBACRoleBindingYAML.",
 "id": "GenerateMembershipRBACRoleBindingYAMLResponse",
@@ -7065,6 +7150,17 @@
 },
 "type": "object"
 },
+"ValidateExclusivityResponse": {
+"description": "The response of exclusivity artifacts validation result status.",
+"id": "ValidateExclusivityResponse",
+"properties": {
+"status": {
+"$ref": "GoogleRpcStatus",
+"description": "The validation result. * `OK` means that exclusivity is validated, assuming the manifest produced by GenerateExclusivityManifest is successfully applied. * `ALREADY_EXISTS` means that the Membership CRD is already owned by another Hub. See `status.message` for more information."
+}
+},
+"type": "object"
+},
 "ValidationResult": {
 "description": "ValidationResults are results set by each validator running during ValidateCreateMembership.",
 "id": "ValidationResult",

From dba4e69f45204f62a8f2b2d2719bc3d0c5aac79e Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:05 +0000
Subject: [PATCH 22/32] feat(logging): update the api

#### logging:v2

The following keys were added:
- resources.folders.resources.locations.resources.logScopes.methods.create (Total Keys: 14)
- resources.folders.resources.locations.resources.logScopes.methods.delete (Total Keys: 11)
- resources.folders.resources.locations.resources.logScopes.methods.get (Total Keys: 11)
- resources.folders.resources.locations.resources.logScopes.methods.list (Total Keys: 16)
- resources.folders.resources.locations.resources.logScopes.methods.patch (Total Keys: 15)
- resources.organizations.resources.locations.resources.logScopes.methods.create (Total Keys: 14)
- resources.organizations.resources.locations.resources.logScopes.methods.delete (Total Keys: 11)
- resources.organizations.resources.locations.resources.logScopes.methods.get (Total Keys: 11)
- resources.organizations.resources.locations.resources.logScopes.methods.list (Total Keys: 16)
- resources.organizations.resources.locations.resources.logScopes.methods.patch (Total Keys: 15)
- resources.projects.resources.locations.resources.logScopes.methods.create (Total Keys: 14)
- resources.projects.resources.locations.resources.logScopes.methods.delete (Total Keys: 11)
- resources.projects.resources.locations.resources.logScopes.methods.get (Total Keys: 11)
- resources.projects.resources.locations.resources.logScopes.methods.list (Total Keys: 16)
- resources.projects.resources.locations.resources.logScopes.methods.patch (Total Keys: 15)
- schemas.ListLogScopesResponse (Total Keys: 5)
- schemas.LogScope (Total Keys: 12)
---
 docs/dyn/logging_v2.folders.locations.html    |   5 +
 ...ogging_v2.folders.locations.logScopes.html | 271 +++++++++
 .../logging_v2.organizations.locations.html   |   5 +
 ..._v2.organizations.locations.logScopes.html | 271 +++++++++
 docs/dyn/logging_v2.projects.locations.html   |   5 +
 ...gging_v2.projects.locations.logScopes.html | 271 +++++++++
 .../discovery_cache/documents/logging.v2.json | 553 +++++++++++++++++-
 7 files changed, 1380 insertions(+), 1 deletion(-)
 create mode 100644 docs/dyn/logging_v2.folders.locations.logScopes.html
 create mode 100644 docs/dyn/logging_v2.organizations.locations.logScopes.html
 create mode 100644 docs/dyn/logging_v2.projects.locations.logScopes.html

diff --git a/docs/dyn/logging_v2.folders.locations.html b/docs/dyn/logging_v2.folders.locations.html
index 9e48ab3476a..b19f0d0cdce 100644
--- a/docs/dyn/logging_v2.folders.locations.html
+++ b/docs/dyn/logging_v2.folders.locations.html
@@ -79,6 +79,11 @@ Instance Methods
 
 Returns the buckets Resource.
 
+
+  logScopes()
+
+Returns the logScopes Resource.
+
 
   operations()
 
diff --git a/docs/dyn/logging_v2.folders.locations.logScopes.html b/docs/dyn/logging_v2.folders.locations.logScopes.html
new file mode 100644
index 00000000000..d85d6659ef6
--- /dev/null
+++ b/docs/dyn/logging_v2.folders.locations.logScopes.html
@@ -0,0 +1,271 @@
+
+
+
+Cloud Logging API . folders . locations . logScopes
+Instance Methods
+
+  close()
+Close httplib2 connections.
+
+  create(parent, body=None, logScopeId=None, x__xgafv=None)
+Creates a log scope.
+
+  delete(name, x__xgafv=None)
+Deletes a log scope.
+
+  get(name, x__xgafv=None)
+Gets a log scope.
+
+  list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+Lists log scopes.
+
+  list_next()
+Retrieves the next page of results.
+
+  patch(name, body=None, updateMask=None, x__xgafv=None)
+Updates a log scope.
+Method Details
+
+    close()
+  Close httplib2 connections.
+
+
+
+    create(parent, body=None, logScopeId=None, x__xgafv=None)
+  Creates a log scope.
+
+Args:
+  parent: string, Required. The parent project in which to create the log scope "projects/[PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/locations/global" (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Describes a group of resources to read log entries from.
+  "createTime": "A String", # Output only. The creation timestamp of the log scope.
+  "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+  "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+  "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+}
+
+  logScopeId: string, Required. A client-assigned identifier such as "log-scope". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Describes a group of resources to read log entries from.
+  "createTime": "A String", # Output only. The creation timestamp of the log scope.
+  "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+  "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+  "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+}
+
+
+
+    delete(name, x__xgafv=None)
+  Deletes a log scope.
+
+Args:
+  name: string, Required. The resource name of the log scope to delete: "projects/[PROJECT_ID]/locations/[LOCATION_ID]/logScopes/[LOG_SCOPE_ID]" For example:"projects/my-project/locations/global/logScopes/my-log-scope" (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
+}
+
+
+
+    get(name, x__xgafv=None)
+  Gets a log scope.
+
+Args:
+  name: string, Required. The resource name of the log scope: "projects/[PROJECT_ID]/locations/[LOCATION_ID]/logScopes/[LOG_SCOPE_ID]" For example:"projects/my-project/locations/global/logScopes/my-log-scope" (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Describes a group of resources to read log entries from.
+  "createTime": "A String", # Output only. The creation timestamp of the log scope.
+  "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+  "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+  "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+}
+
+
+
+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  Lists log scopes.
+
+Args:
+  parent: string, Required. The parent resource whose log scopes are to be listed: "projects/[PROJECT_ID]/locations/[LOCATION_ID]"  (required)
+  pageSize: integer, Optional. The maximum number of results to return from this request.Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The response from ListLogScopes. Every project has a _Default log scope that cannot be modified or deleted.
+  "logScopes": [ # A list of log scopes.
+    { # Describes a group of resources to read log entries from.
+      "createTime": "A String", # Output only. The creation timestamp of the log scope.
+      "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+      "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+      "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+        "A String",
+      ],
+      "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+    },
+  ],
+  "nextPageToken": "A String", # If there might be more results than appear in this response, then nextPageToken is included. To get the next set of results, call the same method again using the value of nextPageToken as pageToken.
+}
+
+
+
+    list_next()
+  Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+
+
+    patch(name, body=None, updateMask=None, x__xgafv=None)
+  Updates a log scope.
+
+Args:
+  name: string, Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Describes a group of resources to read log entries from.
+  "createTime": "A String", # Output only. The creation timestamp of the log scope.
+  "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+  "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+  "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+}
+
+  updateMask: string, Optional. Field mask that specifies the fields in log_scope that need an update. A field will be overwritten if, and only if, it is in the update mask. name and output only fields cannot be updated.For a detailed FieldMask definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=description
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Describes a group of resources to read log entries from.
+  "createTime": "A String", # Output only. The creation timestamp of the log scope.
+  "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+  "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+  "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+}
+
+
+
\ No newline at end of file
diff --git a/docs/dyn/logging_v2.organizations.locations.html b/docs/dyn/logging_v2.organizations.locations.html
index 581bbe10587..82ad6a5f74e 100644
--- a/docs/dyn/logging_v2.organizations.locations.html
+++ b/docs/dyn/logging_v2.organizations.locations.html
@@ -79,6 +79,11 @@ Instance Methods
 
 Returns the buckets Resource.
 
+
+  logScopes()
+
+Returns the logScopes Resource.
+
 
   operations()
 
diff --git a/docs/dyn/logging_v2.organizations.locations.logScopes.html b/docs/dyn/logging_v2.organizations.locations.logScopes.html
new file mode 100644
index 00000000000..220bf9cd450
--- /dev/null
+++ b/docs/dyn/logging_v2.organizations.locations.logScopes.html
@@ -0,0 +1,271 @@
+
+
+
+Cloud Logging API . organizations . locations . logScopes
+Instance Methods
+
+  close()
+Close httplib2 connections.
+
+  create(parent, body=None, logScopeId=None, x__xgafv=None)
+Creates a log scope.
+
+  delete(name, x__xgafv=None)
+Deletes a log scope.
+
+  get(name, x__xgafv=None)
+Gets a log scope.
+
+  list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+Lists log scopes.
+
+  list_next()
+Retrieves the next page of results.
+
+  patch(name, body=None, updateMask=None, x__xgafv=None)
+Updates a log scope.
+Method Details
+
+    close()
+  Close httplib2 connections.
+
+
+
+    create(parent, body=None, logScopeId=None, x__xgafv=None)
+  Creates a log scope.
+
+Args:
+  parent: string, Required. The parent project in which to create the log scope "projects/[PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/locations/global" (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Describes a group of resources to read log entries from.
+  "createTime": "A String", # Output only. The creation timestamp of the log scope.
+  "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+  "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+  "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+}
+
+  logScopeId: string, Required. A client-assigned identifier such as "log-scope". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Describes a group of resources to read log entries from.
+  "createTime": "A String", # Output only. The creation timestamp of the log scope.
+  "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+  "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+  "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+}
+
+
+
+    delete(name, x__xgafv=None)
+  Deletes a log scope.
+
+Args:
+  name: string, Required. The resource name of the log scope to delete: "projects/[PROJECT_ID]/locations/[LOCATION_ID]/logScopes/[LOG_SCOPE_ID]" For example:"projects/my-project/locations/global/logScopes/my-log-scope" (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
+}
+
+
+
+    get(name, x__xgafv=None)
+  Gets a log scope.
+
+Args:
+  name: string, Required. The resource name of the log scope: "projects/[PROJECT_ID]/locations/[LOCATION_ID]/logScopes/[LOG_SCOPE_ID]" For example:"projects/my-project/locations/global/logScopes/my-log-scope" (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Describes a group of resources to read log entries from.
+  "createTime": "A String", # Output only. The creation timestamp of the log scope.
+  "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+  "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+  "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+}
+
+
+
+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  Lists log scopes.
+
+Args:
+  parent: string, Required. The parent resource whose log scopes are to be listed: "projects/[PROJECT_ID]/locations/[LOCATION_ID]"  (required)
+  pageSize: integer, Optional. The maximum number of results to return from this request.Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The response from ListLogScopes. Every project has a _Default log scope that cannot be modified or deleted.
+  "logScopes": [ # A list of log scopes.
+    { # Describes a group of resources to read log entries from.
+      "createTime": "A String", # Output only. The creation timestamp of the log scope.
+      "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+      "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+      "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+        "A String",
+      ],
+      "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+    },
+  ],
+  "nextPageToken": "A String", # If there might be more results than appear in this response, then nextPageToken is included. To get the next set of results, call the same method again using the value of nextPageToken as pageToken.
+}
+
+
+
+    list_next()
+  Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+
+
+    patch(name, body=None, updateMask=None, x__xgafv=None)
+  Updates a log scope.
+
+Args:
+  name: string, Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Describes a group of resources to read log entries from.
+  "createTime": "A String", # Output only. The creation timestamp of the log scope.
+  "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+  "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+  "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+}
+
+  updateMask: string, Optional. Field mask that specifies the fields in log_scope that need an update. A field will be overwritten if, and only if, it is in the update mask. name and output only fields cannot be updated.For a detailed FieldMask definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=description
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Describes a group of resources to read log entries from.
+  "createTime": "A String", # Output only. The creation timestamp of the log scope.
+  "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+  "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+  "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+}
+
+
+
\ No newline at end of file
diff --git a/docs/dyn/logging_v2.projects.locations.html b/docs/dyn/logging_v2.projects.locations.html
index e45f54e06e6..09e9c0a0e65 100644
--- a/docs/dyn/logging_v2.projects.locations.html
+++ b/docs/dyn/logging_v2.projects.locations.html
@@ -79,6 +79,11 @@ Instance Methods
 
 Returns the buckets Resource.
 
+
+  logScopes()
+
+Returns the logScopes Resource.
+
 
   operations()
 
diff --git a/docs/dyn/logging_v2.projects.locations.logScopes.html b/docs/dyn/logging_v2.projects.locations.logScopes.html
new file mode 100644
index 00000000000..d6e2da10a2a
--- /dev/null
+++ b/docs/dyn/logging_v2.projects.locations.logScopes.html
@@ -0,0 +1,271 @@
+
+
+
+Cloud Logging API . projects . locations . logScopes
+Instance Methods
+
+  close()
+Close httplib2 connections.
+
+  create(parent, body=None, logScopeId=None, x__xgafv=None)
+Creates a log scope.
+
+  delete(name, x__xgafv=None)
+Deletes a log scope.
+
+  get(name, x__xgafv=None)
+Gets a log scope.
+
+  list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+Lists log scopes.
+
+  list_next()
+Retrieves the next page of results.
+
+  patch(name, body=None, updateMask=None, x__xgafv=None)
+Updates a log scope.
+Method Details
+
+    close()
+  Close httplib2 connections.
+
+
+
+    create(parent, body=None, logScopeId=None, x__xgafv=None)
+  Creates a log scope.
+
+Args:
+  parent: string, Required. The parent project in which to create the log scope "projects/[PROJECT_ID]/locations/[LOCATION_ID]" For example:"projects/my-project/locations/global" (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Describes a group of resources to read log entries from.
+  "createTime": "A String", # Output only. The creation timestamp of the log scope.
+  "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+  "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+  "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+}
+
+  logScopeId: string, Required. A client-assigned identifier such as "log-scope". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Describes a group of resources to read log entries from.
+  "createTime": "A String", # Output only. The creation timestamp of the log scope.
+  "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+  "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+  "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+}
+
+
+
+    delete(name, x__xgafv=None)
+  Deletes a log scope.
+
+Args:
+  name: string, Required. The resource name of the log scope to delete: "projects/[PROJECT_ID]/locations/[LOCATION_ID]/logScopes/[LOG_SCOPE_ID]" For example:"projects/my-project/locations/global/logScopes/my-log-scope" (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
+}
+
+
+
+    get(name, x__xgafv=None)
+  Gets a log scope.
+
+Args:
+  name: string, Required. The resource name of the log scope: "projects/[PROJECT_ID]/locations/[LOCATION_ID]/logScopes/[LOG_SCOPE_ID]" For example:"projects/my-project/locations/global/logScopes/my-log-scope" (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Describes a group of resources to read log entries from.
+  "createTime": "A String", # Output only. The creation timestamp of the log scope.
+  "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+  "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+  "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+}
+
+
+
+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  Lists log scopes.
+
+Args:
+  parent: string, Required. The parent resource whose log scopes are to be listed: "projects/[PROJECT_ID]/locations/[LOCATION_ID]"  (required)
+  pageSize: integer, Optional. The maximum number of results to return from this request.Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.
+  pageToken: string, Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The response from ListLogScopes. Every project has a _Default log scope that cannot be modified or deleted.
+  "logScopes": [ # A list of log scopes.
+    { # Describes a group of resources to read log entries from.
+      "createTime": "A String", # Output only. The creation timestamp of the log scope.
+      "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+      "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+      "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+        "A String",
+      ],
+      "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+    },
+  ],
+  "nextPageToken": "A String", # If there might be more results than appear in this response, then nextPageToken is included. To get the next set of results, call the same method again using the value of nextPageToken as pageToken.
+}
+
+
+
+    list_next()
+  Retrieves the next page of results.
+
+        Args:
+          previous_request: The request for the previous page. (required)
+          previous_response: The response from the request for the previous page. (required)
+
+        Returns:
+          A request object that you can call 'execute()' on to request the next
+          page. Returns None if there are no more items in the collection.
+        
+
+
+
+    patch(name, body=None, updateMask=None, x__xgafv=None)
+  Updates a log scope.
+
+Args:
+  name: string, Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Describes a group of resources to read log entries from.
+  "createTime": "A String", # Output only. The creation timestamp of the log scope.
+  "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+  "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+  "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+}
+
+  updateMask: string, Optional. Field mask that specifies the fields in log_scope that need an update. A field will be overwritten if, and only if, it is in the update mask. name and output only fields cannot be updated.For a detailed FieldMask definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=description
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Describes a group of resources to read log entries from.
+  "createTime": "A String", # Output only. The creation timestamp of the log scope.
+  "description": "A String", # Optional. Describes this log scope.The maximum length of the description is 8000 characters.
+  "name": "A String", # Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope
+  "resourceNames": [ # Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.
+    "A String",
+  ],
+  "updateTime": "A String", # Output only. The last update timestamp of the log scope.
+}
+
+
+
\ No newline at end of file
diff --git a/googleapiclient/discovery_cache/documents/logging.v2.json b/googleapiclient/discovery_cache/documents/logging.v2.json
index 8c521570c30..375cf72ccf9 100644
--- a/googleapiclient/discovery_cache/documents/logging.v2.json
+++ b/googleapiclient/discovery_cache/documents/logging.v2.json
@@ -3027,6 +3027,172 @@
 }
 }
 },
+"logScopes": {
+"methods": {
+"create": {
+"description": "Creates a log scope.",
+"flatPath": "v2/folders/{foldersId}/locations/{locationsId}/logScopes",
+"httpMethod": "POST",
+"id": "logging.folders.locations.logScopes.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"logScopeId": {
+"description": "Required. A client-assigned identifier such as \"log-scope\". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent project in which to create the log scope \"projects/[PROJECT_ID]/locations/[LOCATION_ID]\" For example:\"projects/my-project/locations/global\"",
+"location": "path",
+"pattern": "^folders/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v2/{+parent}/logScopes",
+"request": {
+"$ref": "LogScope"
+},
+"response": {
+"$ref": "LogScope"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/logging.admin"
+]
+},
+"delete": {
+"description": "Deletes a log scope.",
+"flatPath": "v2/folders/{foldersId}/locations/{locationsId}/logScopes/{logScopesId}",
+"httpMethod": "DELETE",
+"id": "logging.folders.locations.logScopes.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the log scope to delete: \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/logScopes/[LOG_SCOPE_ID]\" For example:\"projects/my-project/locations/global/logScopes/my-log-scope\"",
+"location": "path",
+"pattern": "^folders/[^/]+/locations/[^/]+/logScopes/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v2/{+name}",
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/logging.admin"
+]
+},
+"get": {
+"description": "Gets a log scope.",
+"flatPath": "v2/folders/{foldersId}/locations/{locationsId}/logScopes/{logScopesId}",
+"httpMethod": "GET",
+"id": "logging.folders.locations.logScopes.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the log scope: \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/logScopes/[LOG_SCOPE_ID]\" For example:\"projects/my-project/locations/global/logScopes/my-log-scope\"",
+"location": "path",
+"pattern": "^folders/[^/]+/locations/[^/]+/logScopes/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v2/{+name}",
+"response": {
+"$ref": "LogScope"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/cloud-platform.read-only",
+"https://www.googleapis.com/auth/logging.admin",
+"https://www.googleapis.com/auth/logging.read"
+]
+},
+"list": {
+"description": "Lists log scopes.",
+"flatPath": "v2/folders/{foldersId}/locations/{locationsId}/logScopes",
+"httpMethod": "GET",
+"id": "logging.folders.locations.logScopes.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of results to return from this request.Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent resource whose log scopes are to be listed: \"projects/[PROJECT_ID]/locations/[LOCATION_ID]\" ",
+"location": "path",
+"pattern": "^folders/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v2/{+parent}/logScopes",
+"response": {
+"$ref": "ListLogScopesResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/cloud-platform.read-only",
+"https://www.googleapis.com/auth/logging.admin",
+"https://www.googleapis.com/auth/logging.read"
+]
+},
+"patch": {
+"description": "Updates a log scope.",
+"flatPath": "v2/folders/{foldersId}/locations/{locationsId}/logScopes/{logScopesId}",
+"httpMethod": "PATCH",
+"id": "logging.folders.locations.logScopes.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope",
+"location": "path",
+"pattern": "^folders/[^/]+/locations/[^/]+/logScopes/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. Field mask that specifies the fields in log_scope that need an update. A field will be overwritten if, and only if, it is in the update mask. name and output only fields cannot be updated.For a detailed FieldMask definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=description",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v2/{+name}",
+"request": {
+"$ref": "LogScope"
+},
+"response": {
+"$ref": "LogScope"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/logging.admin"
+]
+}
+}
+},
 "operations": {
 "methods": {
 "cancel": {
@@ -5679,6 +5845,172 @@
 }
 }
 },
+"logScopes": {
+"methods": {
+"create": {
+"description": "Creates a log scope.",
+"flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/logScopes",
+"httpMethod": "POST",
+"id": "logging.organizations.locations.logScopes.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"logScopeId": {
+"description": "Required. A client-assigned identifier such as \"log-scope\". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent project in which to create the log scope \"projects/[PROJECT_ID]/locations/[LOCATION_ID]\" For example:\"projects/my-project/locations/global\"",
+"location": "path",
+"pattern": "^organizations/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v2/{+parent}/logScopes",
+"request": {
+"$ref": "LogScope"
+},
+"response": {
+"$ref": "LogScope"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/logging.admin"
+]
+},
+"delete": {
+"description": "Deletes a log scope.",
+"flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/logScopes/{logScopesId}",
+"httpMethod": "DELETE",
+"id": "logging.organizations.locations.logScopes.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the log scope to delete: \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/logScopes/[LOG_SCOPE_ID]\" For example:\"projects/my-project/locations/global/logScopes/my-log-scope\"",
+"location": "path",
+"pattern": "^organizations/[^/]+/locations/[^/]+/logScopes/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v2/{+name}",
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/logging.admin"
+]
+},
+"get": {
+"description": "Gets a log scope.",
+"flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/logScopes/{logScopesId}",
+"httpMethod": "GET",
+"id": "logging.organizations.locations.logScopes.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the log scope: \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/logScopes/[LOG_SCOPE_ID]\" For example:\"projects/my-project/locations/global/logScopes/my-log-scope\"",
+"location": "path",
+"pattern": "^organizations/[^/]+/locations/[^/]+/logScopes/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v2/{+name}",
+"response": {
+"$ref": "LogScope"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/cloud-platform.read-only",
+"https://www.googleapis.com/auth/logging.admin",
+"https://www.googleapis.com/auth/logging.read"
+]
+},
+"list": {
+"description": "Lists log scopes.",
+"flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/logScopes",
+"httpMethod": "GET",
+"id": "logging.organizations.locations.logScopes.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of results to return from this request.Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent resource whose log scopes are to be listed: \"projects/[PROJECT_ID]/locations/[LOCATION_ID]\" ",
+"location": "path",
+"pattern": "^organizations/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v2/{+parent}/logScopes",
+"response": {
+"$ref": "ListLogScopesResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/cloud-platform.read-only",
+"https://www.googleapis.com/auth/logging.admin",
+"https://www.googleapis.com/auth/logging.read"
+]
+},
+"patch": {
+"description": "Updates a log scope.",
+"flatPath": "v2/organizations/{organizationsId}/locations/{locationsId}/logScopes/{logScopesId}",
+"httpMethod": "PATCH",
+"id": "logging.organizations.locations.logScopes.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope",
+"location": "path",
+"pattern": "^organizations/[^/]+/locations/[^/]+/logScopes/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. Field mask that specifies the fields in log_scope that need an update. A field will be overwritten if, and only if, it is in the update mask. name and output only fields cannot be updated.For a detailed FieldMask definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=description",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v2/{+name}",
+"request": {
+"$ref": "LogScope"
+},
+"response": {
+"$ref": "LogScope"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/logging.admin"
+]
+}
+}
+},
 "operations": {
 "methods": {
 "cancel": {
@@ -7315,6 +7647,172 @@
 }
 }
 },
+"logScopes": {
+"methods": {
+"create": {
+"description": "Creates a log scope.",
+"flatPath": "v2/projects/{projectsId}/locations/{locationsId}/logScopes",
+"httpMethod": "POST",
+"id": "logging.projects.locations.logScopes.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"logScopeId": {
+"description": "Required. A client-assigned identifier such as \"log-scope\". Identifiers are limited to 100 characters and can include only letters, digits, underscores, hyphens, and periods. First character has to be alphanumeric.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent project in which to create the log scope \"projects/[PROJECT_ID]/locations/[LOCATION_ID]\" For example:\"projects/my-project/locations/global\"",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v2/{+parent}/logScopes",
+"request": {
+"$ref": "LogScope"
+},
+"response": {
+"$ref": "LogScope"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/logging.admin"
+]
+},
+"delete": {
+"description": "Deletes a log scope.",
+"flatPath": "v2/projects/{projectsId}/locations/{locationsId}/logScopes/{logScopesId}",
+"httpMethod": "DELETE",
+"id": "logging.projects.locations.logScopes.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the log scope to delete: \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/logScopes/[LOG_SCOPE_ID]\" For example:\"projects/my-project/locations/global/logScopes/my-log-scope\"",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/logScopes/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v2/{+name}",
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/logging.admin"
+]
+},
+"get": {
+"description": "Gets a log scope.",
+"flatPath": "v2/projects/{projectsId}/locations/{locationsId}/logScopes/{logScopesId}",
+"httpMethod": "GET",
+"id": "logging.projects.locations.logScopes.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The resource name of the log scope: \"projects/[PROJECT_ID]/locations/[LOCATION_ID]/logScopes/[LOG_SCOPE_ID]\" For example:\"projects/my-project/locations/global/logScopes/my-log-scope\"",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/logScopes/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v2/{+name}",
+"response": {
+"$ref": "LogScope"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/cloud-platform.read-only",
+"https://www.googleapis.com/auth/logging.admin",
+"https://www.googleapis.com/auth/logging.read"
+]
+},
+"list": {
+"description": "Lists log scopes.",
+"flatPath": "v2/projects/{projectsId}/locations/{locationsId}/logScopes",
+"httpMethod": "GET",
+"id": "logging.projects.locations.logScopes.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of results to return from this request.Non-positive values are ignored. The presence of nextPageToken in the response indicates that more results might be available.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. If present, then retrieve the next batch of results from the preceding call to this method. pageToken must be the value of nextPageToken from the previous response. The values of other method parameters should be identical to those in the previous call.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent resource whose log scopes are to be listed: \"projects/[PROJECT_ID]/locations/[LOCATION_ID]\" ",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v2/{+parent}/logScopes",
+"response": {
+"$ref": "ListLogScopesResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/cloud-platform.read-only",
+"https://www.googleapis.com/auth/logging.admin",
+"https://www.googleapis.com/auth/logging.read"
+]
+},
+"patch": {
+"description": "Updates a log scope.",
+"flatPath": "v2/projects/{projectsId}/locations/{locationsId}/logScopes/{logScopesId}",
+"httpMethod": "PATCH",
+"id": "logging.projects.locations.logScopes.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/logScopes/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. Field mask that specifies the fields in log_scope that need an update. A field will be overwritten if, and only if, it is in the update mask. name and output only fields cannot be updated.For a detailed FieldMask definition, see https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMaskFor example: updateMask=description",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v2/{+name}",
+"request": {
+"$ref": "LogScope"
+},
+"response": {
+"$ref": "LogScope"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform",
+"https://www.googleapis.com/auth/logging.admin"
+]
+}
+}
+},
 "operations": {
 "methods": {
 "cancel": {
@@ -8424,7 +8922,7 @@
 }
 }
 },
-"revision": "20240830",
+"revision": "20240908",
 "rootUrl": "https://logging.googleapis.com/",
 "schemas": {
 "AuditConfig": {
@@ -9297,6 +9795,24 @@
 },
 "type": "object"
 },
+"ListLogScopesResponse": {
+"description": "The response from ListLogScopes. Every project has a _Default log scope that cannot be modified or deleted.",
+"id": "ListLogScopesResponse",
+"properties": {
+"logScopes": {
+"description": "A list of log scopes.",
+"items": {
+"$ref": "LogScope"
+},
+"type": "array"
+},
+"nextPageToken": {
+"description": "If there might be more results than appear in this response, then nextPageToken is included. To get the next set of results, call the same method again using the value of nextPageToken as pageToken.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "ListLogsResponse": {
 "description": "Result returned from ListLogs.",
 "id": "ListLogsResponse",
@@ -9899,6 +10415,41 @@
 },
 "type": "object"
 },
+"LogScope": {
+"description": "Describes a group of resources to read log entries from.",
+"id": "LogScope",
+"properties": {
+"createTime": {
+"description": "Output only. The creation timestamp of the log scope.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"description": {
+"description": "Optional. Describes this log scope.The maximum length of the description is 8000 characters.",
+"type": "string"
+},
+"name": {
+"description": "Output only. The resource name of the log scope.For example:projects/my-project/locations/global/logScopes/my-log-scope",
+"readOnly": true,
+"type": "string"
+},
+"resourceNames": {
+"description": "Required. Names of one or more parent resources: projects/[PROJECT_ID]May alternatively be one or more views: projects/[PROJECT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]A log scope can include a maximum of 50 projects and a maximum of 100 resources in total.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"updateTime": {
+"description": "Output only. The last update timestamp of the log scope.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
 "LogSink": {
 "description": "Describes a sink used to export log entries to one of the following destinations: a Cloud Logging log bucket, a Cloud Storage bucket, a BigQuery dataset, a Pub/Sub topic, a Cloud project.A logs filter controls which log entries are exported. The sink must be created within a project, organization, billing account, or folder.",
 "id": "LogSink",

From 7539ba56e043ba4169d1e845c89e323716796e95 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:05 +0000
Subject: [PATCH 23/32] feat(looker): update the api

#### looker:v1

The following keys were added:
- schemas.Instance.properties.fipsEnabled.type (Total Keys: 1)
- schemas.Instance.properties.geminiEnabled.type (Total Keys: 1)
---
 docs/dyn/looker_v1.projects.locations.instances.html   |  8 ++++++++
 .../discovery_cache/documents/looker.v1.json           | 10 +++++++++-
 2 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/looker_v1.projects.locations.instances.html b/docs/dyn/looker_v1.projects.locations.instances.html
index b98eea85ad7..c26a4dcee79 100644
--- a/docs/dyn/looker_v1.projects.locations.instances.html
+++ b/docs/dyn/looker_v1.projects.locations.instances.html
@@ -169,6 +169,8 @@ Method Details
     "kmsKeyNameVersion": "A String", # Output only. Full name and version of the CMEK key currently in use to encrypt Looker data. Format: `projects/{project}/locations/{location}/keyRings/{ring}/cryptoKeys/{key}/cryptoKeyVersions/{version}`. Empty if CMEK is not configured in this instance.
     "kmsKeyState": "A String", # Output only. Status of the CMEK key.
   },
+  "fipsEnabled": True or False, # Optional. Whether FIPS is enabled on the Looker instance.
+  "geminiEnabled": True or False, # Optional. Whether Gemini feature is enabled on the Looker instance or not.
   "ingressPrivateIp": "A String", # Output only. Private Ingress IP (IPv4).
   "ingressPublicIp": "A String", # Output only. Public Ingress IP (IPv4).
   "lastDenyMaintenancePeriod": { # Specifies the maintenance denial period. # Output only. Last computed maintenance denial period for this instance.
@@ -398,6 +400,8 @@ Method Details
     "kmsKeyNameVersion": "A String", # Output only. Full name and version of the CMEK key currently in use to encrypt Looker data. Format: `projects/{project}/locations/{location}/keyRings/{ring}/cryptoKeys/{key}/cryptoKeyVersions/{version}`. Empty if CMEK is not configured in this instance.
     "kmsKeyState": "A String", # Output only. Status of the CMEK key.
   },
+  "fipsEnabled": True or False, # Optional. Whether FIPS is enabled on the Looker instance.
+  "geminiEnabled": True or False, # Optional. Whether Gemini feature is enabled on the Looker instance or not.
   "ingressPrivateIp": "A String", # Output only. Private Ingress IP (IPv4).
   "ingressPublicIp": "A String", # Output only. Public Ingress IP (IPv4).
   "lastDenyMaintenancePeriod": { # Specifies the maintenance denial period. # Output only. Last computed maintenance denial period for this instance.
@@ -611,6 +615,8 @@ Method Details
         "kmsKeyNameVersion": "A String", # Output only. Full name and version of the CMEK key currently in use to encrypt Looker data. Format: `projects/{project}/locations/{location}/keyRings/{ring}/cryptoKeys/{key}/cryptoKeyVersions/{version}`. Empty if CMEK is not configured in this instance.
         "kmsKeyState": "A String", # Output only. Status of the CMEK key.
       },
+      "fipsEnabled": True or False, # Optional. Whether FIPS is enabled on the Looker instance.
+      "geminiEnabled": True or False, # Optional. Whether Gemini feature is enabled on the Looker instance or not.
       "ingressPrivateIp": "A String", # Output only. Private Ingress IP (IPv4).
       "ingressPublicIp": "A String", # Output only. Public Ingress IP (IPv4).
       "lastDenyMaintenancePeriod": { # Specifies the maintenance denial period. # Output only. Last computed maintenance denial period for this instance.
@@ -745,6 +751,8 @@ Method Details
     "kmsKeyNameVersion": "A String", # Output only. Full name and version of the CMEK key currently in use to encrypt Looker data. Format: `projects/{project}/locations/{location}/keyRings/{ring}/cryptoKeys/{key}/cryptoKeyVersions/{version}`. Empty if CMEK is not configured in this instance.
     "kmsKeyState": "A String", # Output only. Status of the CMEK key.
   },
+  "fipsEnabled": True or False, # Optional. Whether FIPS is enabled on the Looker instance.
+  "geminiEnabled": True or False, # Optional. Whether Gemini feature is enabled on the Looker instance or not.
   "ingressPrivateIp": "A String", # Output only. Private Ingress IP (IPv4).
   "ingressPublicIp": "A String", # Output only. Public Ingress IP (IPv4).
   "lastDenyMaintenancePeriod": { # Specifies the maintenance denial period. # Output only. Last computed maintenance denial period for this instance.
diff --git a/googleapiclient/discovery_cache/documents/looker.v1.json b/googleapiclient/discovery_cache/documents/looker.v1.json
index b6b5eb27275..8face58ee07 100644
--- a/googleapiclient/discovery_cache/documents/looker.v1.json
+++ b/googleapiclient/discovery_cache/documents/looker.v1.json
@@ -731,7 +731,7 @@
 }
 }
 },
-"revision": "20240814",
+"revision": "20240910",
 "rootUrl": "https://looker.googleapis.com/",
 "schemas": {
 "AdminSettings": {
@@ -1092,6 +1092,14 @@
 "$ref": "EncryptionConfig",
 "description": "Encryption configuration (CMEK). Only set if CMEK has been enabled on the instance."
 },
+"fipsEnabled": {
+"description": "Optional. Whether FIPS is enabled on the Looker instance.",
+"type": "boolean"
+},
+"geminiEnabled": {
+"description": "Optional. Whether Gemini feature is enabled on the Looker instance or not.",
+"type": "boolean"
+},
 "ingressPrivateIp": {
 "description": "Output only. Private Ingress IP (IPv4).",
 "readOnly": true,

From 0c46c848015c9a9092347224488e9740cc9bbab3 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 17 Sep 2024 07:08:05 +0000
Subject: [PATCH 24/32] feat(merchantapi): update the api

#### merchantapi:accounts_v1beta

The following keys were deleted:
- resources.accounts.resources.emailpreferences.methods.getEmailPreferences (Total Keys: 11)
- resources.accounts.resources.emailpreferences.methods.updateEmailPreferences (Total Keys: 15)

The following keys were added:
- resources.accounts.resources.autofeedSettings.methods.getAutofeedSettings (Total Keys: 11)
- resources.accounts.resources.autofeedSettings.methods.updateAutofeedSettings (Total Keys: 15)
- resources.accounts.resources.emailPreferences.methods.getEmailPreferences (Total Keys: 11)
- resources.accounts.resources.emailPreferences.methods.updateEmailPreferences (Total Keys: 15)
- schemas.AutofeedSettings (Total Keys: 6)

#### merchantapi:datasources_v1beta

The following keys were added:
- resources.accounts.resources.dataSources.resources.fileUploads.methods.get (Total Keys: 11)
- schemas.DataSourceReference (Total Keys: 5)
- schemas.DefaultRule (Total Keys: 4)
- schemas.FileUpload (Total Keys: 23)
- schemas.Issue (Total Keys: 9)
- schemas.PrimaryProductDataSource.properties.defaultRule.$ref (Total Keys: 1)
- schemas.SupplementalProductDataSource.properties.referencingPrimaryDataSources (Total Keys: 3)
---
 ...unts_v1beta.accounts.autofeedSettings.html | 144 +++++++++++++
 ...unts_v1beta.accounts.emailPreferences.html | 141 +++++++++++++
 .../merchantapi_accounts_v1beta.accounts.html |   9 +-
 ...beta.accounts.dataSources.fileUploads.html | 124 +++++++++++
 ...tasources_v1beta.accounts.dataSources.html | 101 +++++++++
 .../merchantapi.accounts_v1beta.json          |  91 ++++++++-
 .../merchantapi.datasources_v1beta.json       | 192 +++++++++++++++++-
 7 files changed, 795 insertions(+), 7 deletions(-)
 create mode 100644 docs/dyn/merchantapi_accounts_v1beta.accounts.autofeedSettings.html
 create mode 100644 docs/dyn/merchantapi_accounts_v1beta.accounts.emailPreferences.html
 create mode 100644 docs/dyn/merchantapi_datasources_v1beta.accounts.dataSources.fileUploads.html

diff --git a/docs/dyn/merchantapi_accounts_v1beta.accounts.autofeedSettings.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.autofeedSettings.html
new file mode 100644
index 00000000000..37b8884acc5
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.autofeedSettings.html
@@ -0,0 +1,144 @@
+
+
+
+Merchant API . accounts . autofeedSettings
+Instance Methods
+
+  close()
+Close httplib2 connections.
+
+  getAutofeedSettings(name, x__xgafv=None)
+Retrieves the autofeed settings of an account.
+
+  updateAutofeedSettings(name, body=None, updateMask=None, x__xgafv=None)
+Updates the autofeed settings of an account.
+Method Details
+
+    close()
+  Close httplib2 connections.
+
+
+
+    getAutofeedSettings(name, x__xgafv=None)
+  Retrieves the autofeed settings of an account.
+
+Args:
+  name: string, Required. The resource name of the autofeed settings. Format: `accounts/{account}/autofeedSettings` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Collection of information related to the [autofeed](https://support.google.com/merchants/answer/7538732) settings.
+  "eligible": True or False, # Output only. Determines whether merchant is eligible for being enrolled into an autofeed.
+  "enableProducts": True or False, # Required. Enables or disables product crawling through the autofeed for the given account. Autofeed accounts must meet [certain conditions](https://support.google.com/merchants/answer/7538732#Configure_automated_feeds_Standard_Experience), which can be checked through the `eligible` field. The account must **not** be a marketplace. When the autofeed is enabled for the first time, the products usually appear instantly. When re-enabling, it might take up to 24 hours for products to appear.
+  "name": "A String", # Identifier. The resource name of the autofeed settings. Format: `accounts/{account}/autofeedSettings`.
+}
+
+
+
+    updateAutofeedSettings(name, body=None, updateMask=None, x__xgafv=None)
+  Updates the autofeed settings of an account.
+
+Args:
+  name: string, Identifier. The resource name of the autofeed settings. Format: `accounts/{account}/autofeedSettings`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Collection of information related to the [autofeed](https://support.google.com/merchants/answer/7538732) settings.
+  "eligible": True or False, # Output only. Determines whether merchant is eligible for being enrolled into an autofeed.
+  "enableProducts": True or False, # Required. Enables or disables product crawling through the autofeed for the given account. Autofeed accounts must meet [certain conditions](https://support.google.com/merchants/answer/7538732#Configure_automated_feeds_Standard_Experience), which can be checked through the `eligible` field. The account must **not** be a marketplace. When the autofeed is enabled for the first time, the products usually appear instantly. When re-enabling, it might take up to 24 hours for products to appear.
+  "name": "A String", # Identifier. The resource name of the autofeed settings. Format: `accounts/{account}/autofeedSettings`.
+}
+
+  updateMask: string, Required. List of fields being updated.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Collection of information related to the [autofeed](https://support.google.com/merchants/answer/7538732) settings.
+  "eligible": True or False, # Output only. Determines whether merchant is eligible for being enrolled into an autofeed.
+  "enableProducts": True or False, # Required. Enables or disables product crawling through the autofeed for the given account. Autofeed accounts must meet [certain conditions](https://support.google.com/merchants/answer/7538732#Configure_automated_feeds_Standard_Experience), which can be checked through the `eligible` field. The account must **not** be a marketplace. When the autofeed is enabled for the first time, the products usually appear instantly. When re-enabling, it might take up to 24 hours for products to appear.
+  "name": "A String", # Identifier. The resource name of the autofeed settings. Format: `accounts/{account}/autofeedSettings`.
+}
+
+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1beta.accounts.emailPreferences.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.emailPreferences.html
new file mode 100644
index 00000000000..952a7532ca4
--- /dev/null
+++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.emailPreferences.html
@@ -0,0 +1,141 @@
+
+
+
+Merchant API . accounts . emailPreferences
+Instance Methods
+
+  close()
+Close httplib2 connections.
+
+  getEmailPreferences(name, x__xgafv=None)
+Returns the email preferences for a Merchant Center account user. Use the name=accounts/*/users/me/emailPreferences alias to get preferences for the authenticated user.
+
+  updateEmailPreferences(name, body=None, updateMask=None, x__xgafv=None)
+Updates the email preferences for a Merchant Center account user. MCA users should specify the MCA account rather than a sub-account of the MCA. Preferences which are not explicitly selected in the update mask will not be updated. It is invalid for updates to specify an UNCONFIRMED opt-in status value. Use the name=accounts/*/users/me/emailPreferences alias to update preferences for the authenticated user.
+Method Details
+
+    close()
+  Close httplib2 connections.
+
+
+
+    getEmailPreferences(name, x__xgafv=None)
+  Returns the email preferences for a Merchant Center account user. Use the name=accounts/*/users/me/emailPreferences alias to get preferences for the authenticated user.
+
+Args:
+  name: string, Required. The name of the `EmailPreferences` resource. Format: `accounts/{account}/users/{email}/emailPreferences` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The categories of notifications the user opted into / opted out of. The email preferences do not include mandatory announcements as users can't opt out of them.
+  "name": "A String", # Identifier. The name of the EmailPreferences. The endpoint is only supported for the authenticated user.
+  "newsAndTips": "A String", # Optional. Updates on new features, tips and best practices.
+}
+
+
+
+    updateEmailPreferences(name, body=None, updateMask=None, x__xgafv=None)
+  Updates the email preferences for a Merchant Center account user. MCA users should specify the MCA account rather than a sub-account of the MCA. Preferences which are not explicitly selected in the update mask will not be updated. It is invalid for updates to specify an UNCONFIRMED opt-in status value. Use the name=accounts/*/users/me/emailPreferences alias to update preferences for the authenticated user.
+
+Args:
+  name: string, Identifier. The name of the EmailPreferences. The endpoint is only supported for the authenticated user. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # The categories of notifications the user opted into / opted out of. The email preferences do not include mandatory announcements as users can't opt out of them.
+  "name": "A String", # Identifier. The name of the EmailPreferences. The endpoint is only supported for the authenticated user.
+  "newsAndTips": "A String", # Optional. Updates on new features, tips and best practices.
+}
+
+  updateMask: string, Required. List of fields being updated.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The categories of notifications the user opted into / opted out of. The email preferences do not include mandatory announcements as users can't opt out of them.
+  "name": "A String", # Identifier. The name of the EmailPreferences. The endpoint is only supported for the authenticated user.
+  "newsAndTips": "A String", # Optional. Updates on new features, tips and best practices.
+}
+
+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_accounts_v1beta.accounts.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.html
index 9a6d9c02d9d..1f638d73146 100644
--- a/docs/dyn/merchantapi_accounts_v1beta.accounts.html
+++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.html
@@ -74,6 +74,11 @@
 
 Merchant API . accounts
 Instance Methods
+
+  autofeedSettings()
+
+Returns the autofeedSettings Resource.
+
 
   businessIdentity()
 
@@ -85,9 +90,9 @@ Instance Methods
 Returns the businessInfo Resource.
 
 
-  emailpreferences()
+  emailPreferences()
 
-Returns the emailpreferences Resource.
+Returns the emailPreferences Resource.
 
 
   homepage()
diff --git a/docs/dyn/merchantapi_datasources_v1beta.accounts.dataSources.fileUploads.html b/docs/dyn/merchantapi_datasources_v1beta.accounts.dataSources.fileUploads.html
new file mode 100644
index 00000000000..ffcd76fe9ae
--- /dev/null
+++ b/docs/dyn/merchantapi_datasources_v1beta.accounts.dataSources.fileUploads.html
@@ -0,0 +1,124 @@
+
+
+
+
Merchant API . accounts . dataSources . fileUploads
+Instance Methods
+
+  close()
+Close httplib2 connections.
+
+  get(name, x__xgafv=None)
+Gets the latest data source file upload. Only the `latest` alias is accepted for a file upload.
+Method Details
+
+    close()
+  Close httplib2 connections.
+
+
+
+    get(name, x__xgafv=None)
+  Gets the latest data source file upload. Only the `latest` alias is accepted for a file upload.
+
+Args:
+  name: string, Required. The name of the data source file upload to retrieve. Format: `accounts/{account}/dataSources/{datasource}/fileUploads/latest` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # The file upload of a specific data source, that is, the result of the retrieval of the data source at a certain timestamp computed asynchronously when the data source processing is finished. Only applicable to file data sources.
+  "dataSourceId": "A String", # Output only. The data source id.
+  "issues": [ # Output only. The list of issues occurring in the data source.
+    { # An error occurring in the data source, like "invalid price".
+      "code": "A String", # Output only. The code of the error, for example, "validation/invalid_value". Returns "?" if the code is unknown.
+      "count": "A String", # Output only. The number of occurrences of the error in the file upload.
+      "description": "A String", # Output only. The error description, for example, "Your data source contains items which have too many attributes, or are too big. These items will be dropped".
+      "documentationUri": "A String", # Output only. Link to the documentation explaining the issue in more details, if available.
+      "severity": "A String", # Output only. The severity of the issue.
+      "title": "A String", # Output only. The title of the issue, for example, "Item too big".
+    },
+  ],
+  "itemsCreated": "A String", # Output only. The number of items in the data source that were created.
+  "itemsTotal": "A String", # Output only. The number of items in the data source that were processed.
+  "itemsUpdated": "A String", # Output only. The number of items in the data source that were updated.
+  "name": "A String", # Identifier. The name of the data source file upload. Format: `{datasource.name=accounts/{account}/dataSources/{datasource}/fileUploads/{fileupload}}`
+  "processingState": "A String", # Output only. The processing state of the data source.
+  "uploadTime": "A String", # Output only. The date at which the file of the data source was uploaded.
+}
+
+
+
\ No newline at end of file
diff --git a/docs/dyn/merchantapi_datasources_v1beta.accounts.dataSources.html b/docs/dyn/merchantapi_datasources_v1beta.accounts.dataSources.html
index 6153bf58bcb..9b673e28037 100644
--- a/docs/dyn/merchantapi_datasources_v1beta.accounts.dataSources.html
+++ b/docs/dyn/merchantapi_datasources_v1beta.accounts.dataSources.html
@@ -74,6 +74,11 @@
 
 Merchant API . accounts . dataSources
 Instance Methods
+
+  fileUploads()
+
+Returns the fileUploads Resource.
+
 
   close()
 Close httplib2 connections.
@@ -148,6 +153,15 @@ Method Details
     "countries": [ # Optional. The countries where the items may be displayed. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml).
       "A String",
     ],
+    "defaultRule": { # Default rule management of the data source. # Optional. Default rule management of the data source. If set, the linked data sources will be replaced.
+      "takeFromDataSources": [ # Required. The list of data sources linked in the [default rule](https://support.google.com/merchants/answer/7450276). This list is ordered by the default rule priority of joining the data. It might include none or multiple references to `self` and supplemental data sources. The list must not be empty. To link the data source to the default rule, you need to add a new reference to this list (in sequential order). To unlink the data source from the default rule, you need to remove the given reference from this list. Changing the order of this list will result in changing the priority of data sources in the default rule. For example, providing the following list: [`1001`, `self`] will take attribute values from supplemental data source `1001`, and fallback to `self` if the attribute is not set in `1001`.
+        { # Data source reference can be used to manage related data sources within the data source service.
+          "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+          "self": True or False, # Self should be used to reference the primary data source itself.
+          "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+        },
+      ],
+    },
     "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.
   },
   "promotionDataSource": { # The promotion data source. # Required. The [promotion](https://support.google.com/merchants/answer/2906014) data source.
@@ -161,6 +175,13 @@ Method Details
   "supplementalProductDataSource": { # The supplemental data source for local and online products. # Required. The [supplemental data source](https://support.google.com/merchants/answer/7439058) for local and online products.
     "contentLanguage": "A String", # Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
     "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
+    "referencingPrimaryDataSources": [ # Output only. The (unordered and deduplicated) list of all primary data sources linked to this data source in either default or custom rules. Supplemental data source cannot be deleted before all links are removed.
+      { # Data source reference can be used to manage related data sources within the data source service.
+        "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+        "self": True or False, # Self should be used to reference the primary data source itself.
+        "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+      },
+    ],
   },
 }
 
@@ -207,6 +228,15 @@ Method Details
     "countries": [ # Optional. The countries where the items may be displayed. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml).
       "A String",
     ],
+    "defaultRule": { # Default rule management of the data source. # Optional. Default rule management of the data source. If set, the linked data sources will be replaced.
+      "takeFromDataSources": [ # Required. The list of data sources linked in the [default rule](https://support.google.com/merchants/answer/7450276). This list is ordered by the default rule priority of joining the data. It might include none or multiple references to `self` and supplemental data sources. The list must not be empty. To link the data source to the default rule, you need to add a new reference to this list (in sequential order). To unlink the data source from the default rule, you need to remove the given reference from this list. Changing the order of this list will result in changing the priority of data sources in the default rule. For example, providing the following list: [`1001`, `self`] will take attribute values from supplemental data source `1001`, and fallback to `self` if the attribute is not set in `1001`.
+        { # Data source reference can be used to manage related data sources within the data source service.
+          "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+          "self": True or False, # Self should be used to reference the primary data source itself.
+          "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+        },
+      ],
+    },
     "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.
   },
   "promotionDataSource": { # The promotion data source. # Required. The [promotion](https://support.google.com/merchants/answer/2906014) data source.
@@ -220,6 +250,13 @@ Method Details
   "supplementalProductDataSource": { # The supplemental data source for local and online products. # Required. The [supplemental data source](https://support.google.com/merchants/answer/7439058) for local and online products.
     "contentLanguage": "A String", # Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
     "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
+    "referencingPrimaryDataSources": [ # Output only. The (unordered and deduplicated) list of all primary data sources linked to this data source in either default or custom rules. Supplemental data source cannot be deleted before all links are removed.
+      { # Data source reference can be used to manage related data sources within the data source service.
+        "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+        "self": True or False, # Self should be used to reference the primary data source itself.
+        "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+      },
+    ],
   },
 }
 
@@ -315,6 +352,15 @@ Method Details
     "countries": [ # Optional. The countries where the items may be displayed. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml).
       "A String",
     ],
+    "defaultRule": { # Default rule management of the data source. # Optional. Default rule management of the data source. If set, the linked data sources will be replaced.
+      "takeFromDataSources": [ # Required. The list of data sources linked in the [default rule](https://support.google.com/merchants/answer/7450276). This list is ordered by the default rule priority of joining the data. It might include none or multiple references to `self` and supplemental data sources. The list must not be empty. To link the data source to the default rule, you need to add a new reference to this list (in sequential order). To unlink the data source from the default rule, you need to remove the given reference from this list. Changing the order of this list will result in changing the priority of data sources in the default rule. For example, providing the following list: [`1001`, `self`] will take attribute values from supplemental data source `1001`, and fallback to `self` if the attribute is not set in `1001`.
+        { # Data source reference can be used to manage related data sources within the data source service.
+          "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+          "self": True or False, # Self should be used to reference the primary data source itself.
+          "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+        },
+      ],
+    },
     "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.
   },
   "promotionDataSource": { # The promotion data source. # Required. The [promotion](https://support.google.com/merchants/answer/2906014) data source.
@@ -328,6 +374,13 @@ Method Details
   "supplementalProductDataSource": { # The supplemental data source for local and online products. # Required. The [supplemental data source](https://support.google.com/merchants/answer/7439058) for local and online products.
     "contentLanguage": "A String", # Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
     "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.
+    "referencingPrimaryDataSources": [ # Output only. The (unordered and deduplicated) list of all primary data sources linked to this data source in either default or custom rules. Supplemental data source cannot be deleted before all links are removed.
+      { # Data source reference can be used to manage related data sources within the data source service.
+        "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`
+        "self": True or False, # Self should be used to reference the primary data source itself.
+        "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`
+      },
+    ],
   },
 }

@@ -385,6 +438,15 @@

Method Details

"countries": [ # Optional. The countries where the items may be displayed. Represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml). "A String", ], + "defaultRule": { # Default rule management of the data source. # Optional. Default rule management of the data source. If set, the linked data sources will be replaced. + "takeFromDataSources": [ # Required. The list of data sources linked in the [default rule](https://support.google.com/merchants/answer/7450276). This list is ordered by the default rule priority of joining the data. It might include none or multiple references to `self` and supplemental data sources. The list must not be empty. To link the data source to the default rule, you need to add a new reference to this list (in sequential order). To unlink the data source from the default rule, you need to remove the given reference from this list. Changing the order of this list will result in changing the priority of data sources in the default rule. For example, providing the following list: [`1001`, `self`] will take attribute values from supplemental data source `1001`, and fallback to `self` if the attribute is not set in `1001`. + { # Data source reference can be used to manage related data sources within the data source service. + "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}` + "self": True or False, # Self should be used to reference the primary data source itself. + "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}` + }, + ], + }, "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction. }, "promotionDataSource": { # The promotion data source. # Required. The [promotion](https://support.google.com/merchants/answer/2906014) data source. @@ -398,6 +460,13 @@

Method Details

"supplementalProductDataSource": { # The supplemental data source for local and online products. # Required. The [supplemental data source](https://support.google.com/merchants/answer/7439058) for local and online products. "contentLanguage": "A String", # Optional. Immutable. The two-letter ISO 639-1 language of the items in the data source. `feedLabel` and `contentLanguage` must be either both set or unset. The fields can only be unset for data sources without file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction. "feedLabel": "A String", # Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction. + "referencingPrimaryDataSources": [ # Output only. The (unordered and deduplicated) list of all primary data sources linked to this data source in either default or custom rules. Supplemental data source cannot be deleted before all links are removed. + { # Data source reference can be used to manage related data sources within the data source service. + "primaryDataSourceName": "A String", # Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}` + "self": True or False, # Self should be used to reference the primary data source itself. + "supplementalDataSourceName": "A String", # Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}` + }, + ], }, } diff --git a/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json b/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json index 5f2edc185c2..2e7f7b5fa66 100644 --- a/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json +++ b/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json @@ -279,6 +279,69 @@ } }, "resources": { +"autofeedSettings": { +"methods": { +"getAutofeedSettings": { +"description": "Retrieves the autofeed settings of an account.", +"flatPath": "accounts/v1beta/accounts/{accountsId}/autofeedSettings", +"httpMethod": "GET", +"id": "merchantapi.accounts.autofeedSettings.getAutofeedSettings", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The resource name of the autofeed settings. Format: `accounts/{account}/autofeedSettings`", +"location": "path", +"pattern": "^accounts/[^/]+/autofeedSettings$", +"required": true, +"type": "string" +} +}, +"path": "accounts/v1beta/{+name}", +"response": { +"$ref": "AutofeedSettings" +}, +"scopes": [ +"https://www.googleapis.com/auth/content" +] +}, +"updateAutofeedSettings": { +"description": "Updates the autofeed settings of an account.", +"flatPath": "accounts/v1beta/accounts/{accountsId}/autofeedSettings", +"httpMethod": "PATCH", +"id": "merchantapi.accounts.autofeedSettings.updateAutofeedSettings", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Identifier. The resource name of the autofeed settings. Format: `accounts/{account}/autofeedSettings`.", +"location": "path", +"pattern": "^accounts/[^/]+/autofeedSettings$", +"required": true, +"type": "string" +}, +"updateMask": { +"description": "Required. List of fields being updated.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "accounts/v1beta/{+name}", +"request": { +"$ref": "AutofeedSettings" +}, +"response": { +"$ref": "AutofeedSettings" +}, +"scopes": [ +"https://www.googleapis.com/auth/content" +] +} +} +}, "businessIdentity": { "methods": { "getBusinessIdentity": { @@ -405,13 +468,13 @@ } } }, -"emailpreferences": { +"emailPreferences": { "methods": { "getEmailPreferences": { "description": "Returns the email preferences for a Merchant Center account user. Use the name=accounts/*/users/me/emailPreferences alias to get preferences for the authenticated user.", "flatPath": "accounts/v1beta/accounts/{accountsId}/users/{usersId}/emailPreferences", "httpMethod": "GET", -"id": "merchantapi.accounts.emailpreferences.getEmailPreferences", +"id": "merchantapi.accounts.emailPreferences.getEmailPreferences", "parameterOrder": [ "name" ], @@ -436,7 +499,7 @@ "description": "Updates the email preferences for a Merchant Center account user. MCA users should specify the MCA account rather than a sub-account of the MCA. Preferences which are not explicitly selected in the update mask will not be updated. It is invalid for updates to specify an UNCONFIRMED opt-in status value. Use the name=accounts/*/users/me/emailPreferences alias to update preferences for the authenticated user.", "flatPath": "accounts/v1beta/accounts/{accountsId}/users/{usersId}/emailPreferences", "httpMethod": "PATCH", -"id": "merchantapi.accounts.emailpreferences.updateEmailPreferences", +"id": "merchantapi.accounts.emailPreferences.updateEmailPreferences", "parameterOrder": [ "name" ], @@ -1354,7 +1417,7 @@ } } }, -"revision": "20240830", +"revision": "20240909", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "AcceptTermsOfService": { @@ -1517,6 +1580,26 @@ }, "type": "object" }, +"AutofeedSettings": { +"description": "Collection of information related to the [autofeed](https://support.google.com/merchants/answer/7538732) settings.", +"id": "AutofeedSettings", +"properties": { +"eligible": { +"description": "Output only. Determines whether merchant is eligible for being enrolled into an autofeed.", +"readOnly": true, +"type": "boolean" +}, +"enableProducts": { +"description": "Required. Enables or disables product crawling through the autofeed for the given account. Autofeed accounts must meet [certain conditions](https://support.google.com/merchants/answer/7538732#Configure_automated_feeds_Standard_Experience), which can be checked through the `eligible` field. The account must **not** be a marketplace. When the autofeed is enabled for the first time, the products usually appear instantly. When re-enabling, it might take up to 24 hours for products to appear.", +"type": "boolean" +}, +"name": { +"description": "Identifier. The resource name of the autofeed settings. Format: `accounts/{account}/autofeedSettings`.", +"type": "string" +} +}, +"type": "object" +}, "BusinessDayConfig": { "description": "Business days of the warehouse.", "id": "BusinessDayConfig", diff --git a/googleapiclient/discovery_cache/documents/merchantapi.datasources_v1beta.json b/googleapiclient/discovery_cache/documents/merchantapi.datasources_v1beta.json index 33175bc13cd..1fd96b160a5 100644 --- a/googleapiclient/discovery_cache/documents/merchantapi.datasources_v1beta.json +++ b/googleapiclient/discovery_cache/documents/merchantapi.datasources_v1beta.json @@ -285,12 +285,43 @@ "https://www.googleapis.com/auth/content" ] } +}, +"resources": { +"fileUploads": { +"methods": { +"get": { +"description": "Gets the latest data source file upload. Only the `latest` alias is accepted for a file upload.", +"flatPath": "datasources/v1beta/accounts/{accountsId}/dataSources/{dataSourcesId}/fileUploads/{fileUploadsId}", +"httpMethod": "GET", +"id": "merchantapi.accounts.dataSources.fileUploads.get", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The name of the data source file upload to retrieve. Format: `accounts/{account}/dataSources/{datasource}/fileUploads/latest`", +"location": "path", +"pattern": "^accounts/[^/]+/dataSources/[^/]+/fileUploads/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "datasources/v1beta/{+name}", +"response": { +"$ref": "FileUpload" +}, +"scopes": [ +"https://www.googleapis.com/auth/content" +] +} +} +} } } } } }, -"revision": "20240827", +"revision": "20240909", "rootUrl": "https://merchantapi.googleapis.com/", "schemas": { "DataSource": { @@ -357,6 +388,39 @@ }, "type": "object" }, +"DataSourceReference": { +"description": "Data source reference can be used to manage related data sources within the data source service.", +"id": "DataSourceReference", +"properties": { +"primaryDataSourceName": { +"description": "Optional. The name of the primary data source. Format: `accounts/{account}/dataSources/{datasource}`", +"type": "string" +}, +"self": { +"description": "Self should be used to reference the primary data source itself.", +"type": "boolean" +}, +"supplementalDataSourceName": { +"description": "Optional. The name of the supplemental data source. Format: `accounts/{account}/dataSources/{datasource}`", +"type": "string" +} +}, +"type": "object" +}, +"DefaultRule": { +"description": "Default rule management of the data source.", +"id": "DefaultRule", +"properties": { +"takeFromDataSources": { +"description": "Required. The list of data sources linked in the [default rule](https://support.google.com/merchants/answer/7450276). This list is ordered by the default rule priority of joining the data. It might include none or multiple references to `self` and supplemental data sources. The list must not be empty. To link the data source to the default rule, you need to add a new reference to this list (in sequential order). To unlink the data source from the default rule, you need to remove the given reference from this list. Changing the order of this list will result in changing the priority of data sources in the default rule. For example, providing the following list: [`1001`, `self`] will take attribute values from supplemental data source `1001`, and fallback to `self` if the attribute is not set in `1001`.", +"items": { +"$ref": "DataSourceReference" +}, +"type": "array" +} +}, +"type": "object" +}, "Empty": { "description": "A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }", "id": "Empty", @@ -477,6 +541,120 @@ }, "type": "object" }, +"FileUpload": { +"description": "The file upload of a specific data source, that is, the result of the retrieval of the data source at a certain timestamp computed asynchronously when the data source processing is finished. Only applicable to file data sources.", +"id": "FileUpload", +"properties": { +"dataSourceId": { +"description": "Output only. The data source id.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"issues": { +"description": "Output only. The list of issues occurring in the data source.", +"items": { +"$ref": "Issue" +}, +"readOnly": true, +"type": "array" +}, +"itemsCreated": { +"description": "Output only. The number of items in the data source that were created.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"itemsTotal": { +"description": "Output only. The number of items in the data source that were processed.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"itemsUpdated": { +"description": "Output only. The number of items in the data source that were updated.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"name": { +"description": "Identifier. The name of the data source file upload. Format: `{datasource.name=accounts/{account}/dataSources/{datasource}/fileUploads/{fileupload}}`", +"type": "string" +}, +"processingState": { +"description": "Output only. The processing state of the data source.", +"enum": [ +"PROCESSING_STATE_UNSPECIFIED", +"FAILED", +"IN_PROGRESS", +"SUCCEEDED" +], +"enumDescriptions": [ +"Processing state unspecified.", +"The data source could not be processed or all the items had errors.", +"The data source is being processed.", +"The data source was processed successfully, though some items might have had errors." +], +"readOnly": true, +"type": "string" +}, +"uploadTime": { +"description": "Output only. The date at which the file of the data source was uploaded.", +"format": "google-datetime", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"Issue": { +"description": "An error occurring in the data source, like \"invalid price\".", +"id": "Issue", +"properties": { +"code": { +"description": "Output only. The code of the error, for example, \"validation/invalid_value\". Returns \"?\" if the code is unknown.", +"readOnly": true, +"type": "string" +}, +"count": { +"description": "Output only. The number of occurrences of the error in the file upload.", +"format": "int64", +"readOnly": true, +"type": "string" +}, +"description": { +"description": "Output only. The error description, for example, \"Your data source contains items which have too many attributes, or are too big. These items will be dropped\".", +"readOnly": true, +"type": "string" +}, +"documentationUri": { +"description": "Output only. Link to the documentation explaining the issue in more details, if available.", +"readOnly": true, +"type": "string" +}, +"severity": { +"description": "Output only. The severity of the issue.", +"enum": [ +"SEVERITY_UNSPECIFIED", +"WARNING", +"ERROR" +], +"enumDescriptions": [ +"Severity unspecified.", +"The issue is the warning.", +"The issue is an error." +], +"readOnly": true, +"type": "string" +}, +"title": { +"description": "Output only. The title of the issue, for example, \"Item too big\".", +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, "ListDataSourcesResponse": { "description": "Response message for the ListDataSources method.", "id": "ListDataSourcesResponse", @@ -541,6 +719,10 @@ }, "type": "array" }, +"defaultRule": { +"$ref": "DefaultRule", +"description": "Optional. Default rule management of the data source. If set, the linked data sources will be replaced." +}, "feedLabel": { "description": "Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept products without that restriction.", "type": "string" @@ -723,6 +905,14 @@ false "feedLabel": { "description": "Optional. Immutable. The feed label that is specified on the data source level. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-). See also [migration to feed labels](https://developers.google.com/shopping-content/guides/products/feed-labels). `feedLabel` and `contentLanguage` must be either both set or unset for data sources with product content type. They must be set for data sources with a file input. If set, the data source will only accept products matching this combination. If unset, the data source will accept produts without that restriction.", "type": "string" +}, +"referencingPrimaryDataSources": { +"description": "Output only. The (unordered and deduplicated) list of all primary data sources linked to this data source in either default or custom rules. Supplemental data source cannot be deleted before all links are removed.", +"items": { +"$ref": "DataSourceReference" +}, +"readOnly": true, +"type": "array" } }, "type": "object" From 51c5920e4fdddf8bb18c5bc6f93d479ca32ed9f2 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 17 Sep 2024 07:08:05 +0000 Subject: [PATCH 25/32] feat(networkconnectivity): update the api #### networkconnectivity:v1 The following keys were added: - schemas.ConsumerPscConfig.properties.producerInstanceId.deprecated (Total Keys: 1) - schemas.ConsumerPscConfig.properties.producerInstanceMetadata (Total Keys: 2) - schemas.ConsumerPscConnection.properties.errorType.deprecated (Total Keys: 1) - schemas.ConsumerPscConnection.properties.producerInstanceId.deprecated (Total Keys: 1) - schemas.ConsumerPscConnection.properties.producerInstanceMetadata (Total Keys: 2) - schemas.InternalRange.properties.migration.$ref (Total Keys: 1) - schemas.Migration (Total Keys: 4) - schemas.PscConnection.properties.errorType.deprecated (Total Keys: 1) - schemas.PscConnection.properties.producerInstanceId.deprecated (Total Keys: 1) - schemas.PscConnection.properties.producerInstanceMetadata (Total Keys: 2) - schemas.PscConnection.properties.serviceClass (Total Keys: 2) --- ..._v1.projects.locations.internalRanges.html | 32 ++++++-- ...jects.locations.serviceConnectionMaps.html | 40 ++++++++-- ...s.locations.serviceConnectionPolicies.html | 48 ++++++++---- .../documents/networkconnectivity.v1.json | 78 +++++++++++++++---- 4 files changed, 153 insertions(+), 45 deletions(-) diff --git a/docs/dyn/networkconnectivity_v1.projects.locations.internalRanges.html b/docs/dyn/networkconnectivity_v1.projects.locations.internalRanges.html index 3d3a215d820..9fbed308322 100644 --- a/docs/dyn/networkconnectivity_v1.projects.locations.internalRanges.html +++ b/docs/dyn/networkconnectivity_v1.projects.locations.internalRanges.html @@ -113,17 +113,21 @@

Method Details

{ # The internal range resource for IPAM operations within a VPC network. Used to represent a private address range along with behavioral characterstics of that range (its usage and peering behavior). Networking resources can link to this range if they are created as belonging to it. "createTime": "A String", # Time when the internal range was created. "description": "A String", # A description of this resource. - "ipCidrRange": "A String", # The IP range that this internal range defines. + "ipCidrRange": "A String", # The IP range that this internal range defines. NOTE: IPv6 ranges are limited to usage=EXTERNAL_TO_VPC and peering=FOR_SELF. NOTE: For IPv6 Ranges this field is compulsory, i.e. the address range must be specified explicitly. "labels": { # User-defined labels. "a_key": "A String", }, + "migration": { # Specification for migration with source and target resource names. # Optional. Should be present if usage is set to FOR_MIGRATION. + "source": "A String", # Immutable. Resource path as an URI of the source resource, for example a subnet. The project for the source resource should match the project for the InternalRange. An example: /projects/{project}/regions/{region}/subnetworks/{subnet} + "target": "A String", # Immutable. Resource path of the target resource. The target project can be different, as in the cases when migrating to peer networks. The resource For example: /projects/{project}/regions/{region}/subnetworks/{subnet} + }, "name": "A String", # Immutable. The name of an internal range. Format: projects/{project}/locations/{location}/internalRanges/{internal_range} See: https://google.aip.dev/122#fields-representing-resource-names "network": "A String", # The URL or resource ID of the network in which to reserve the internal range. The network cannot be deleted if there are any reserved internal ranges referring to it. Legacy networks are not supported. For example: https://www.googleapis.com/compute/v1/projects/{project}/locations/global/networks/{network} projects/{project}/locations/global/networks/{network} {network} "overlaps": [ # Optional. Types of resources that are allowed to overlap with the current internal range. "A String", ], "peering": "A String", # The type of peering set for this internal range. - "prefixLength": 42, # An alternate to ip_cidr_range. Can be set when trying to create a reservation that automatically finds a free range of the given size. If both ip_cidr_range and prefix_length are set, there is an error if the range sizes do not match. Can also be used during updates to change the range size. + "prefixLength": 42, # An alternate to ip_cidr_range. Can be set when trying to create an IPv4 reservation that automatically finds a free range of the given size. If both ip_cidr_range and prefix_length are set, there is an error if the range sizes do not match. Can also be used during updates to change the range size. NOTE: For IPv6 this field only works if ip_cidr_range is set as well, and both fields must match. In other words, with IPv6 this field only works as a redundant parameter. "targetCidrRange": [ # Optional. Can be set to narrow down or pick a different address space while searching for a free range. If not set, defaults to the "10.0.0.0/8" address space. This can be used to search in other rfc-1918 address spaces like "172.16.0.0/12" and "192.168.0.0/16" or non-rfc-1918 address spaces used in the VPC. "A String", ], @@ -218,17 +222,21 @@

Method Details

"consumerInstanceProject": "A String", # Required. The project ID or project number of the consumer project. This project is the one that the consumer uses to interact with the producer instance. From the perspective of a consumer who's created a producer instance, this is the project of the producer instance. Format: 'projects/' Eg. 'projects/consumer-project' or 'projects/1234' "disableGlobalAccess": True or False, # This is used in PSC consumer ForwardingRule to control whether the PSC endpoint can be accessed from another region. "network": "A String", # The resource path of the consumer network where PSC connections are allowed to be created in. Note, this network does not need be in the ConsumerPscConfig.project in the case of SharedVPC. Example: projects/{projectNumOrId}/global/networks/{networkId}. - "producerInstanceId": "A String", # Immutable. An immutable identifier for the producer instance. + "producerInstanceId": "A String", # Immutable. Deprecated. Use producer_instance_metadata instead. An immutable identifier for the producer instance. + "producerInstanceMetadata": { # Immutable. An immutable map for the producer instance metadata. + "a_key": "A String", + }, "project": "A String", # The consumer project where PSC connections are allowed to be created in. "serviceAttachmentIpAddressMap": { # Output only. A map to store mapping between customer vip and target service attachment. Only service attachment with producer specified ip addresses are stored here. "a_key": "A String", @@ -156,7 +159,10 @@

Method Details

"gceOperation": "A String", # The last Compute Engine operation to setup PSC connection. "ip": "A String", # The IP literal allocated on the consumer network for the PSC forwarding rule that is created to connect to the producer service attachment in this service connection map. "network": "A String", # The consumer network whose PSC forwarding rule is connected to the service attachments in this service connection map. Note that the network could be on a different project (shared VPC). - "producerInstanceId": "A String", # Immutable. An immutable identifier for the producer instance. + "producerInstanceId": "A String", # Immutable. Deprecated. Use producer_instance_metadata instead. An immutable identifier for the producer instance. + "producerInstanceMetadata": { # Immutable. An immutable map for the producer instance metadata. + "a_key": "A String", + }, "project": "A String", # The consumer project whose PSC forwarding rule is connected to the service attachments in this service connection map. "pscConnectionId": "A String", # The PSC connection id of the PSC forwarding rule connected to the service attachments in this service connection map. "selectedSubnetwork": "A String", # Output only. The URI of the selected subnetwork selected to allocate IP address for this connection. @@ -271,7 +277,10 @@

Method Details

The object takes the form of: { # The ServiceConnectionPolicy resource. Next id: 12 - "createTime": "A String", # Output only. Time when the ServiceConnectionMap was created. + "createTime": "A String", # Output only. Time when the ServiceConnectionPolicy was created. "description": "A String", # A description of this resource. "etag": "A String", # Optional. The etag is computed by the server, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. "infrastructure": "A String", # Output only. The type of underlying resources used to create the connection. @@ -144,7 +144,7 @@

Method Details

"consumerAddress": "A String", # The resource reference of the consumer address. "consumerForwardingRule": "A String", # The resource reference of the PSC Forwarding Rule within the consumer VPC. "consumerTargetProject": "A String", # The project where the PSC connection is created. - "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The most recent error during operating this connection. + "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The most recent error during operating this connection. Deprecated, please use error_info instead. "code": 42, # The status code, which should be an enum value of google.rpc.Code. "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use. { @@ -162,14 +162,18 @@

Method Details

An object of the form: { # The ServiceConnectionPolicy resource. Next id: 12 - "createTime": "A String", # Output only. Time when the ServiceConnectionMap was created. + "createTime": "A String", # Output only. Time when the ServiceConnectionPolicy was created. "description": "A String", # A description of this resource. "etag": "A String", # Optional. The etag is computed by the server, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. "infrastructure": "A String", # Output only. The type of underlying resources used to create the connection. @@ -279,7 +283,7 @@

Method Details

"nextPageToken": "A String", # The next pagination token in the List response. It should be used as page_token for the following request. An empty value means no more result. "serviceConnectionPolicies": [ # ServiceConnectionPolicies to be returned. { # The ServiceConnectionPolicy resource. Next id: 12 - "createTime": "A String", # Output only. Time when the ServiceConnectionMap was created. + "createTime": "A String", # Output only. Time when the ServiceConnectionPolicy was created. "description": "A String", # A description of this resource. "etag": "A String", # Optional. The etag is computed by the server, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. "infrastructure": "A String", # Output only. The type of underlying resources used to create the connection. @@ -402,7 +410,7 @@

Method Details

}, "errorType": "A String", # The error type indicates whether the error is consumer facing, producer facing or system internal. "gceOperation": "A String", # The last Compute Engine operation to setup PSC connection. - "producerInstanceId": "A String", # Immutable. An immutable identifier for the producer instance. + "producerInstanceId": "A String", # Immutable. Deprecated. Use producer_instance_metadata instead. An immutable identifier for the producer instance. + "producerInstanceMetadata": { # Immutable. An immutable map for the producer instance metadata. + "a_key": "A String", + }, "pscConnectionId": "A String", # The PSC connection id of the PSC forwarding rule. "selectedSubnetwork": "A String", # Output only. The URI of the subnetwork selected to allocate IP address for this connection. + "serviceClass": "A String", # Output only. [Output only] The service class associated with this PSC Connection. The value is derived from the SCPolicy and matches the service class name provided by the customer. "state": "A String", # State of the PSC Connection }, ], "serviceClass": "A String", # The service class identifier for which this ServiceConnectionPolicy is for. The service class identifier is a unique, symbolic representation of a ServiceClass. It is provided by the Service Producer. Google services have a prefix of gcp or google-cloud. For example, gcp-memorystore-redis or google-cloud-sql. 3rd party services do not. For example, test-service-a3dfcx. - "updateTime": "A String", # Output only. Time when the ServiceConnectionMap was updated. + "updateTime": "A String", # Output only. Time when the ServiceConnectionPolicy was updated. } requestId: string, Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000). diff --git a/googleapiclient/discovery_cache/documents/networkconnectivity.v1.json b/googleapiclient/discovery_cache/documents/networkconnectivity.v1.json index 6a7302f6d9d..ec90a4592ad 100644 --- a/googleapiclient/discovery_cache/documents/networkconnectivity.v1.json +++ b/googleapiclient/discovery_cache/documents/networkconnectivity.v1.json @@ -2812,7 +2812,7 @@ } } }, -"revision": "20240807", +"revision": "20240911", "rootUrl": "https://networkconnectivity.googleapis.com/", "schemas": { "AcceptHubSpokeRequest": { @@ -2942,9 +2942,17 @@ "type": "string" }, "producerInstanceId": { -"description": "Immutable. An immutable identifier for the producer instance.", +"deprecated": true, +"description": "Immutable. Deprecated. Use producer_instance_metadata instead. An immutable identifier for the producer instance.", "type": "string" }, +"producerInstanceMetadata": { +"additionalProperties": { +"type": "string" +}, +"description": "Immutable. An immutable map for the producer instance metadata.", +"type": "object" +}, "project": { "description": "The consumer project where PSC connections are allowed to be created in.", "type": "string" @@ -2994,6 +3002,7 @@ "readOnly": true }, "errorType": { +"deprecated": true, "description": "The error type indicates whether the error is consumer facing, producer facing or system internal.", "enum": [ "CONNECTION_ERROR_TYPE_UNSPECIFIED", @@ -3026,9 +3035,17 @@ "type": "string" }, "producerInstanceId": { -"description": "Immutable. An immutable identifier for the producer instance.", +"deprecated": true, +"description": "Immutable. Deprecated. Use producer_instance_metadata instead. An immutable identifier for the producer instance.", "type": "string" }, +"producerInstanceMetadata": { +"additionalProperties": { +"type": "string" +}, +"description": "Immutable. An immutable map for the producer instance metadata.", +"type": "object" +}, "project": { "description": "The consumer project whose PSC forwarding rule is connected to the service attachments in this service connection map.", "type": "string" @@ -3057,7 +3074,7 @@ ], "enumDescriptions": [ "An invalid state as the default case.", -"The connection is fully established and ready to use.", +"The connection has been created successfully. However, for the up-to-date connection status, please use the service attachment's \"ConnectedEndpoint.status\" as the source of truth.", "The connection is not functional since some resources on the connection fail to be created.", "The connection is being created.", "The connection is being deleted." @@ -3451,7 +3468,7 @@ "type": "string" }, "ipCidrRange": { -"description": "The IP range that this internal range defines.", +"description": "The IP range that this internal range defines. NOTE: IPv6 ranges are limited to usage=EXTERNAL_TO_VPC and peering=FOR_SELF. NOTE: For IPv6 Ranges this field is compulsory, i.e. the address range must be specified explicitly.", "type": "string" }, "labels": { @@ -3461,6 +3478,10 @@ "description": "User-defined labels.", "type": "object" }, +"migration": { +"$ref": "Migration", +"description": "Optional. Should be present if usage is set to FOR_MIGRATION." +}, "name": { "description": "Immutable. The name of an internal range. Format: projects/{project}/locations/{location}/internalRanges/{internal_range} See: https://google.aip.dev/122#fields-representing-resource-names", "type": "string" @@ -3503,7 +3524,7 @@ "type": "string" }, "prefixLength": { -"description": "An alternate to ip_cidr_range. Can be set when trying to create a reservation that automatically finds a free range of the given size. If both ip_cidr_range and prefix_length are set, there is an error if the range sizes do not match. Can also be used during updates to change the range size.", +"description": "An alternate to ip_cidr_range. Can be set when trying to create an IPv4 reservation that automatically finds a free range of the given size. If both ip_cidr_range and prefix_length are set, there is an error if the range sizes do not match. Can also be used during updates to change the range size. NOTE: For IPv6 this field only works if ip_cidr_range is set as well, and both fields must match. In other words, with IPv6 this field only works as a redundant parameter.", "format": "int32", "type": "integer" }, @@ -3524,12 +3545,14 @@ "enum": [ "USAGE_UNSPECIFIED", "FOR_VPC", -"EXTERNAL_TO_VPC" +"EXTERNAL_TO_VPC", +"FOR_MIGRATION" ], "enumDescriptions": [ "Unspecified usage is allowed in calls which identify the resource by other fields and do not need Usage set to complete. These are, i.e.: GetInternalRange and DeleteInternalRange. Usage needs to be specified explicitly in CreateInternalRange or UpdateInternalRange calls.", "A VPC resource can use the reserved CIDR block by associating it with the internal range resource if usage is set to FOR_VPC.", -"Ranges created with EXTERNAL_TO_VPC cannot be associated with VPC resources and are meant to block out address ranges for various use cases, like for example, usage on-prem, with dynamic route announcements via interconnect." +"Ranges created with EXTERNAL_TO_VPC cannot be associated with VPC resources and are meant to block out address ranges for various use cases, like for example, usage on-prem, with dynamic route announcements via interconnect.", +"Ranges created FOR_MIGRATION can be used to lock a CIDR range between a source and target subnet. If usage is set to FOR_MIGRATION the peering value has to be set to FOR_SELF or default to FOR_SELF when unset." ], "type": "string" }, @@ -4068,6 +4091,21 @@ }, "type": "object" }, +"Migration": { +"description": "Specification for migration with source and target resource names.", +"id": "Migration", +"properties": { +"source": { +"description": "Immutable. Resource path as an URI of the source resource, for example a subnet. The project for the source resource should match the project for the InternalRange. An example: /projects/{project}/regions/{region}/subnetworks/{subnet}", +"type": "string" +}, +"target": { +"description": "Immutable. Resource path of the target resource. The target project can be different, as in the cases when migrating to peer networks. The resource For example: /projects/{project}/regions/{region}/subnetworks/{subnet}", +"type": "string" +} +}, +"type": "object" +}, "NextHopInterconnectAttachment": { "description": "A route next hop that leads to an interconnect attachment resource.", "id": "NextHopInterconnectAttachment", @@ -4367,7 +4405,7 @@ "error": { "$ref": "GoogleRpcStatus", "deprecated": true, -"description": "The most recent error during operating this connection." +"description": "The most recent error during operating this connection. Deprecated, please use error_info instead." }, "errorInfo": { "$ref": "GoogleRpcErrorInfo", @@ -4375,6 +4413,7 @@ "readOnly": true }, "errorType": { +"deprecated": true, "description": "The error type indicates whether the error is consumer facing, producer facing or system internal.", "enum": [ "CONNECTION_ERROR_TYPE_UNSPECIFIED", @@ -4395,9 +4434,17 @@ "type": "string" }, "producerInstanceId": { -"description": "Immutable. An immutable identifier for the producer instance.", +"deprecated": true, +"description": "Immutable. Deprecated. Use producer_instance_metadata instead. An immutable identifier for the producer instance.", +"type": "string" +}, +"producerInstanceMetadata": { +"additionalProperties": { "type": "string" }, +"description": "Immutable. An immutable map for the producer instance metadata.", +"type": "object" +}, "pscConnectionId": { "description": "The PSC connection id of the PSC forwarding rule.", "type": "string" @@ -4407,6 +4454,11 @@ "readOnly": true, "type": "string" }, +"serviceClass": { +"description": "Output only. [Output only] The service class associated with this PSC Connection. The value is derived from the SCPolicy and matches the service class name provided by the customer.", +"readOnly": true, +"type": "string" +}, "state": { "description": "State of the PSC Connection", "enum": [ @@ -4418,7 +4470,7 @@ ], "enumDescriptions": [ "An invalid state as the default case.", -"The connection is fully established and ready to use.", +"The connection has been created successfully. However, for the up-to-date connection status, please use the created forwarding rule's \"PscConnectionStatus\" as the source of truth.", "The connection is not functional since some resources on the connection fail to be created.", "The connection is being created.", "The connection is being deleted." @@ -4882,7 +4934,7 @@ "id": "ServiceConnectionPolicy", "properties": { "createTime": { -"description": "Output only. Time when the ServiceConnectionMap was created.", +"description": "Output only. Time when the ServiceConnectionPolicy was created.", "format": "google-datetime", "readOnly": true, "type": "string" @@ -4940,7 +4992,7 @@ "type": "string" }, "updateTime": { -"description": "Output only. Time when the ServiceConnectionMap was updated.", +"description": "Output only. Time when the ServiceConnectionPolicy was updated.", "format": "google-datetime", "readOnly": true, "type": "string" From f6e10fbde271b8fb2361209e15919603098edfbe Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 17 Sep 2024 07:08:05 +0000 Subject: [PATCH 26/32] feat(networkmanagement): update the api #### networkmanagement:v1 The following keys were added: - schemas.RedisClusterInfo (Total Keys: 8) - schemas.Step.properties.redisCluster.$ref (Total Keys: 1) #### networkmanagement:v1beta1 The following keys were added: - schemas.RedisClusterInfo (Total Keys: 8) - schemas.Step.properties.redisCluster.$ref (Total Keys: 1) --- ...s.locations.global_.connectivityTests.html | 32 ++++++++ ...s.locations.global_.connectivityTests.html | 32 ++++++++ .../documents/networkmanagement.v1.json | 76 +++++++++++++++++-- .../documents/networkmanagement.v1beta1.json | 76 +++++++++++++++++-- 4 files changed, 206 insertions(+), 10 deletions(-) diff --git a/docs/dyn/networkmanagement_v1.projects.locations.global_.connectivityTests.html b/docs/dyn/networkmanagement_v1.projects.locations.global_.connectivityTests.html index e01f08c576b..24e4967ef36 100644 --- a/docs/dyn/networkmanagement_v1.projects.locations.global_.connectivityTests.html +++ b/docs/dyn/networkmanagement_v1.projects.locations.global_.connectivityTests.html @@ -401,6 +401,14 @@

Method Details

"protocol": "A String", # IP protocol in string format, for example: "TCP", "UDP", "ICMP". "subnetUri": "A String", # Uri of proxy subnet. }, + "redisCluster": { # For display only. Metadata associated with a Redis Cluster. # Display information of a Redis Cluster. + "discoveryEndpointIpAddress": "A String", # Discovery endpoint IP address of a Redis Cluster. + "displayName": "A String", # Name of a Redis Cluster. + "location": "A String", # Name of the region in which the Redis Cluster is defined. For example, "us-central1". + "networkUri": "A String", # URI of a Redis Cluster network in format "projects/{project_id}/global/networks/{network_id}". + "secondaryEndpointIpAddress": "A String", # Secondary endpoint IP address of a Redis Cluster. + "uri": "A String", # URI of a Redis Cluster in format "projects/{project_id}/locations/{location}/clusters/{cluster_id}" + }, "redisInstance": { # For display only. Metadata associated with a Cloud Redis Instance. # Display information of a Redis Instance. "displayName": "A String", # Name of a Cloud Redis Instance. "networkUri": "A String", # URI of a Cloud Redis Instance network. diff --git a/googleapiclient/discovery_cache/documents/networkmanagement.v1.json b/googleapiclient/discovery_cache/documents/networkmanagement.v1.json index f3f07394739..3c4357ad606 100644 --- a/googleapiclient/discovery_cache/documents/networkmanagement.v1.json +++ b/googleapiclient/discovery_cache/documents/networkmanagement.v1.json @@ -591,7 +591,7 @@ } } }, -"revision": "20240821", +"revision": "20240905", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -630,6 +630,8 @@ "ROUTE_CONFIG_NOT_FOUND", "GOOGLE_MANAGED_SERVICE_AMBIGUOUS_PSC_ENDPOINT", "SOURCE_PSC_CLOUD_SQL_UNSUPPORTED", +"SOURCE_REDIS_CLUSTER_UNSUPPORTED", +"SOURCE_REDIS_INSTANCE_UNSUPPORTED", "SOURCE_FORWARDING_RULE_UNSUPPORTED", "NON_ROUTABLE_IP_ADDRESS", "UNKNOWN_ISSUE_IN_GOOGLE_MANAGED_PROJECT", @@ -668,6 +670,8 @@ false, false, false, false, +false, +false, false ], "enumDescriptions": [ @@ -700,6 +704,8 @@ false "Aborted because expected route configuration was missing.", "Aborted because a PSC endpoint selection for the Google-managed service is ambiguous (several PSC endpoints satisfy test input).", "Aborted because tests with a PSC-based Cloud SQL instance as a source are not supported.", +"Aborted because tests with a Redis Cluster as a source are not supported.", +"Aborted because tests with a Redis Instance as a source are not supported.", "Aborted because tests with a forwarding rule as a source are not supported.", "Aborted because one of the endpoints is a non-routable IP address (loopback, link-local, etc).", "Aborted due to an unknown issue in the Google-managed project.", @@ -1045,7 +1051,9 @@ false "CLOUD_FUNCTION", "APP_ENGINE_VERSION", "CLOUD_RUN_REVISION", -"GOOGLE_MANAGED_SERVICE" +"GOOGLE_MANAGED_SERVICE", +"REDIS_INSTANCE", +"REDIS_CLUSTER" ], "enumDescriptions": [ "Target not specified.", @@ -1063,7 +1071,9 @@ false "Target is a Cloud Function. Used only for return traces.", "Target is a App Engine service version. Used only for return traces.", "Target is a Cloud Run revision. Used only for return traces.", -"Target is a Google-managed service. Used only for return traces." +"Target is a Google-managed service. Used only for return traces.", +"Target is a Redis Instance.", +"Target is a Redis Cluster." ], "type": "string" } @@ -1106,6 +1116,7 @@ false "GKE_CLUSTER_NOT_RUNNING", "CLOUD_SQL_INSTANCE_NOT_RUNNING", "REDIS_INSTANCE_NOT_RUNNING", +"REDIS_CLUSTER_NOT_RUNNING", "TRAFFIC_TYPE_BLOCKED", "GKE_MASTER_UNAUTHORIZED_ACCESS", "CLOUD_SQL_INSTANCE_UNAUTHORIZED_ACCESS", @@ -1145,7 +1156,15 @@ false "DROPPED_INSIDE_GOOGLE_MANAGED_SERVICE", "LOAD_BALANCER_BACKEND_INVALID_NETWORK", "BACKEND_SERVICE_NAMED_PORT_NOT_DEFINED", -"DESTINATION_IS_PRIVATE_NAT_IP_RANGE" +"DESTINATION_IS_PRIVATE_NAT_IP_RANGE", +"DROPPED_INSIDE_REDIS_INSTANCE_SERVICE", +"REDIS_INSTANCE_UNSUPPORTED_PORT", +"REDIS_INSTANCE_CONNECTING_FROM_PUPI_ADDRESS", +"REDIS_INSTANCE_NO_ROUTE_TO_DESTINATION_NETWORK", +"REDIS_INSTANCE_NO_EXTERNAL_IP", +"DROPPED_INSIDE_REDIS_CLUSTER_SERVICE", +"REDIS_CLUSTER_UNSUPPORTED_PORT", +"REDIS_CLUSTER_NO_EXTERNAL_IP" ], "enumDescriptions": [ "Cause is unspecified.", @@ -1177,6 +1196,7 @@ false "Packet sent from or to a GKE cluster that is not in running state.", "Packet sent from or to a Cloud SQL instance that is not in running state.", "Packet sent from or to a Redis Instance that is not in running state.", +"Packet sent from or to a Redis Cluster that is not in running state.", "The type of traffic is blocked and the user cannot configure a firewall rule to enable it. See [Always blocked traffic](https://cloud.google.com/vpc/docs/firewalls#blockedtraffic) for more details.", "Access to Google Kubernetes Engine cluster master's endpoint is not authorized. See [Access to the cluster endpoints](https://cloud.google.com/kubernetes-engine/docs/how-to/private-clusters#access_to_the_cluster_endpoints) for more details.", "Access to the Cloud SQL instance endpoint is not authorized. See [Authorizing with authorized networks](https://cloud.google.com/sql/docs/mysql/authorize-networks) for more details.", @@ -1216,7 +1236,15 @@ false "Packet is dropped due to an unspecified reason inside a Google-managed service. Used only for return traces.", "Packet is dropped due to a load balancer backend instance not having a network interface in the network expected by the load balancer.", "Packet is dropped due to a backend service named port not being defined on the instance group level.", -"Packet is dropped due to a destination IP range being part of a Private NAT IP range." +"Packet is dropped due to a destination IP range being part of a Private NAT IP range.", +"Generic drop cause for a packet being dropped inside a Redis Instance service project.", +"Packet is dropped due to an unsupported port being used to connect to a Redis Instance. Port 6379 should be used to connect to a Redis Instance.", +"Packet is dropped due to connecting from PUPI address to a PSA based Redis Instance.", +"Packet is dropped due to no route to the destination network.", +"Redis Instance does not have an external IP address.", +"Generic drop cause for a packet being dropped inside a Redis Cluster service project.", +"Packet is dropped due to an unsupported port being used to connect to a Redis Cluster. Ports 6379 and 11000 to 13047 should be used to connect to a Redis Cluster.", +"Redis Cluster does not have an external IP address." ], "type": "string" }, @@ -2385,6 +2413,37 @@ false }, "type": "object" }, +"RedisClusterInfo": { +"description": "For display only. Metadata associated with a Redis Cluster.", +"id": "RedisClusterInfo", +"properties": { +"discoveryEndpointIpAddress": { +"description": "Discovery endpoint IP address of a Redis Cluster.", +"type": "string" +}, +"displayName": { +"description": "Name of a Redis Cluster.", +"type": "string" +}, +"location": { +"description": "Name of the region in which the Redis Cluster is defined. For example, \"us-central1\".", +"type": "string" +}, +"networkUri": { +"description": "URI of a Redis Cluster network in format \"projects/{project_id}/global/networks/{network_id}\".", +"type": "string" +}, +"secondaryEndpointIpAddress": { +"description": "Secondary endpoint IP address of a Redis Cluster.", +"type": "string" +}, +"uri": { +"description": "URI of a Redis Cluster in format \"projects/{project_id}/locations/{location}/clusters/{cluster_id}\"", +"type": "string" +} +}, +"type": "object" +}, "RedisInstanceInfo": { "description": "For display only. Metadata associated with a Cloud Redis Instance.", "id": "RedisInstanceInfo", @@ -2713,6 +2772,10 @@ false "$ref": "ProxyConnectionInfo", "description": "Display information of a ProxyConnection." }, +"redisCluster": { +"$ref": "RedisClusterInfo", +"description": "Display information of a Redis Cluster." +}, "redisInstance": { "$ref": "RedisInstanceInfo", "description": "Display information of a Redis Instance." @@ -2736,6 +2799,7 @@ false "START_FROM_GKE_MASTER", "START_FROM_CLOUD_SQL_INSTANCE", "START_FROM_REDIS_INSTANCE", +"START_FROM_REDIS_CLUSTER", "START_FROM_CLOUD_FUNCTION", "START_FROM_APP_ENGINE_VERSION", "START_FROM_CLOUD_RUN_REVISION", @@ -2784,6 +2848,7 @@ false, false, false, false, +false, true, true, false, @@ -2806,6 +2871,7 @@ false "Initial state: packet originating from a Google Kubernetes Engine cluster master. A GKEMasterInfo is populated with starting instance information.", "Initial state: packet originating from a Cloud SQL instance. A CloudSQLInstanceInfo is populated with starting instance information.", "Initial state: packet originating from a Redis instance. A RedisInstanceInfo is populated with starting instance information.", +"Initial state: packet originating from a Redis Cluster. A RedisClusterInfo is populated with starting Cluster information.", "Initial state: packet originating from a Cloud Function. A CloudFunctionInfo is populated with starting function information.", "Initial state: packet originating from an App Engine service version. An AppEngineVersionInfo is populated with starting version information.", "Initial state: packet originating from a Cloud Run revision. A CloudRunRevisionInfo is populated with starting revision information.", diff --git a/googleapiclient/discovery_cache/documents/networkmanagement.v1beta1.json b/googleapiclient/discovery_cache/documents/networkmanagement.v1beta1.json index 93bd2595608..bb10fd1358e 100644 --- a/googleapiclient/discovery_cache/documents/networkmanagement.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/networkmanagement.v1beta1.json @@ -758,7 +758,7 @@ } } }, -"revision": "20240821", +"revision": "20240905", "rootUrl": "https://networkmanagement.googleapis.com/", "schemas": { "AbortInfo": { @@ -797,6 +797,8 @@ "ROUTE_CONFIG_NOT_FOUND", "GOOGLE_MANAGED_SERVICE_AMBIGUOUS_PSC_ENDPOINT", "SOURCE_PSC_CLOUD_SQL_UNSUPPORTED", +"SOURCE_REDIS_CLUSTER_UNSUPPORTED", +"SOURCE_REDIS_INSTANCE_UNSUPPORTED", "SOURCE_FORWARDING_RULE_UNSUPPORTED", "NON_ROUTABLE_IP_ADDRESS", "UNKNOWN_ISSUE_IN_GOOGLE_MANAGED_PROJECT", @@ -835,6 +837,8 @@ false, false, false, false, +false, +false, false ], "enumDescriptions": [ @@ -867,6 +871,8 @@ false "Aborted because expected route configuration was missing.", "Aborted because a PSC endpoint selection for the Google-managed service is ambiguous (several PSC endpoints satisfy test input).", "Aborted because tests with a PSC-based Cloud SQL instance as a source are not supported.", +"Aborted because tests with a Redis Cluster as a source are not supported.", +"Aborted because tests with a Redis Instance as a source are not supported.", "Aborted because tests with a forwarding rule as a source are not supported.", "Aborted because one of the endpoints is a non-routable IP address (loopback, link-local, etc).", "Aborted due to an unknown issue in the Google-managed project.", @@ -1217,7 +1223,9 @@ false "CLOUD_FUNCTION", "APP_ENGINE_VERSION", "CLOUD_RUN_REVISION", -"GOOGLE_MANAGED_SERVICE" +"GOOGLE_MANAGED_SERVICE", +"REDIS_INSTANCE", +"REDIS_CLUSTER" ], "enumDescriptions": [ "Target not specified.", @@ -1235,7 +1243,9 @@ false "Target is a Cloud Function. Used only for return traces.", "Target is a App Engine service version. Used only for return traces.", "Target is a Cloud Run revision. Used only for return traces.", -"Target is a Google-managed service. Used only for return traces." +"Target is a Google-managed service. Used only for return traces.", +"Target is a Redis Instance.", +"Target is a Redis Cluster." ], "type": "string" } @@ -1278,6 +1288,7 @@ false "GKE_CLUSTER_NOT_RUNNING", "CLOUD_SQL_INSTANCE_NOT_RUNNING", "REDIS_INSTANCE_NOT_RUNNING", +"REDIS_CLUSTER_NOT_RUNNING", "TRAFFIC_TYPE_BLOCKED", "GKE_MASTER_UNAUTHORIZED_ACCESS", "CLOUD_SQL_INSTANCE_UNAUTHORIZED_ACCESS", @@ -1317,7 +1328,15 @@ false "DROPPED_INSIDE_GOOGLE_MANAGED_SERVICE", "LOAD_BALANCER_BACKEND_INVALID_NETWORK", "BACKEND_SERVICE_NAMED_PORT_NOT_DEFINED", -"DESTINATION_IS_PRIVATE_NAT_IP_RANGE" +"DESTINATION_IS_PRIVATE_NAT_IP_RANGE", +"DROPPED_INSIDE_REDIS_INSTANCE_SERVICE", +"REDIS_INSTANCE_UNSUPPORTED_PORT", +"REDIS_INSTANCE_CONNECTING_FROM_PUPI_ADDRESS", +"REDIS_INSTANCE_NO_ROUTE_TO_DESTINATION_NETWORK", +"REDIS_INSTANCE_NO_EXTERNAL_IP", +"DROPPED_INSIDE_REDIS_CLUSTER_SERVICE", +"REDIS_CLUSTER_UNSUPPORTED_PORT", +"REDIS_CLUSTER_NO_EXTERNAL_IP" ], "enumDescriptions": [ "Cause is unspecified.", @@ -1349,6 +1368,7 @@ false "Packet sent from or to a GKE cluster that is not in running state.", "Packet sent from or to a Cloud SQL instance that is not in running state.", "Packet sent from or to a Redis Instance that is not in running state.", +"Packet sent from or to a Redis Cluster that is not in running state.", "The type of traffic is blocked and the user cannot configure a firewall rule to enable it. See [Always blocked traffic](https://cloud.google.com/vpc/docs/firewalls#blockedtraffic) for more details.", "Access to Google Kubernetes Engine cluster master's endpoint is not authorized. See [Access to the cluster endpoints](https://cloud.google.com/kubernetes-engine/docs/how-to/private-clusters#access_to_the_cluster_endpoints) for more details.", "Access to the Cloud SQL instance endpoint is not authorized. See [Authorizing with authorized networks](https://cloud.google.com/sql/docs/mysql/authorize-networks) for more details.", @@ -1388,7 +1408,15 @@ false "Packet is dropped due to an unspecified reason inside a Google-managed service. Used only for return traces.", "Packet is dropped due to a load balancer backend instance not having a network interface in the network expected by the load balancer.", "Packet is dropped due to a backend service named port not being defined on the instance group level.", -"Packet is dropped due to a destination IP range being part of a Private NAT IP range." +"Packet is dropped due to a destination IP range being part of a Private NAT IP range.", +"Generic drop cause for a packet being dropped inside a Redis Instance service project.", +"Packet is dropped due to an unsupported port being used to connect to a Redis Instance. Port 6379 should be used to connect to a Redis Instance.", +"Packet is dropped due to connecting from PUPI address to a PSA based Redis Instance.", +"Packet is dropped due to no route to the destination network.", +"Redis Instance does not have an external IP address.", +"Generic drop cause for a packet being dropped inside a Redis Cluster service project.", +"Packet is dropped due to an unsupported port being used to connect to a Redis Cluster. Ports 6379 and 11000 to 13047 should be used to connect to a Redis Cluster.", +"Redis Cluster does not have an external IP address." ], "type": "string" }, @@ -2590,6 +2618,37 @@ false }, "type": "object" }, +"RedisClusterInfo": { +"description": "For display only. Metadata associated with a Redis Cluster.", +"id": "RedisClusterInfo", +"properties": { +"discoveryEndpointIpAddress": { +"description": "Discovery endpoint IP address of a Redis Cluster.", +"type": "string" +}, +"displayName": { +"description": "Name of a Redis Cluster.", +"type": "string" +}, +"location": { +"description": "Name of the region in which the Redis Cluster is defined. For example, \"us-central1\".", +"type": "string" +}, +"networkUri": { +"description": "URI of a Redis Cluster network in format \"projects/{project_id}/global/networks/{network_id}\".", +"type": "string" +}, +"secondaryEndpointIpAddress": { +"description": "Secondary endpoint IP address of a Redis Cluster.", +"type": "string" +}, +"uri": { +"description": "URI of a Redis Cluster in format \"projects/{project_id}/locations/{location}/clusters/{cluster_id}\"", +"type": "string" +} +}, +"type": "object" +}, "RedisInstanceInfo": { "description": "For display only. Metadata associated with a Cloud Redis Instance.", "id": "RedisInstanceInfo", @@ -2918,6 +2977,10 @@ false "$ref": "ProxyConnectionInfo", "description": "Display information of a ProxyConnection." }, +"redisCluster": { +"$ref": "RedisClusterInfo", +"description": "Display information of a Redis Cluster." +}, "redisInstance": { "$ref": "RedisInstanceInfo", "description": "Display information of a Redis Instance." @@ -2941,6 +3004,7 @@ false "START_FROM_GKE_MASTER", "START_FROM_CLOUD_SQL_INSTANCE", "START_FROM_REDIS_INSTANCE", +"START_FROM_REDIS_CLUSTER", "START_FROM_CLOUD_FUNCTION", "START_FROM_APP_ENGINE_VERSION", "START_FROM_CLOUD_RUN_REVISION", @@ -2989,6 +3053,7 @@ false, false, false, false, +false, true, true, false, @@ -3011,6 +3076,7 @@ false "Initial state: packet originating from a Google Kubernetes Engine cluster master. A GKEMasterInfo is populated with starting instance information.", "Initial state: packet originating from a Cloud SQL instance. A CloudSQLInstanceInfo is populated with starting instance information.", "Initial state: packet originating from a Redis instance. A RedisInstanceInfo is populated with starting instance information.", +"Initial state: packet originating from a Redis Cluster. A RedisClusterInfo is populated with starting Cluster information.", "Initial state: packet originating from a Cloud Function. A CloudFunctionInfo is populated with starting function information.", "Initial state: packet originating from an App Engine service version. An AppEngineVersionInfo is populated with starting version information.", "Initial state: packet originating from a Cloud Run revision. A CloudRunRevisionInfo is populated with starting revision information.", From 168199f5e694a6da0ffa24377288fe28752dd080 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 17 Sep 2024 07:08:06 +0000 Subject: [PATCH 27/32] feat(serviceconsumermanagement): update the api #### serviceconsumermanagement:v1 The following keys were added: - schemas.ExperimentalFeatures (Total Keys: 3) - schemas.MetricDescriptorMetadata.properties.timeSeriesResourceHierarchyLevel (Total Keys: 2) - schemas.PythonSettings.properties.experimentalFeatures.$ref (Total Keys: 1) #### serviceconsumermanagement:v1beta1 The following keys were added: - schemas.ExperimentalFeatures (Total Keys: 3) - schemas.MetricDescriptorMetadata.properties.timeSeriesResourceHierarchyLevel (Total Keys: 2) - schemas.PythonSettings.properties.experimentalFeatures.$ref (Total Keys: 1) --- .../serviceconsumermanagement.v1.json | 36 ++++++++++++++++++- .../serviceconsumermanagement.v1beta1.json | 36 ++++++++++++++++++- 2 files changed, 70 insertions(+), 2 deletions(-) diff --git a/googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1.json b/googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1.json index f12d5a48a5f..43473314b8d 100644 --- a/googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1.json +++ b/googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1.json @@ -542,7 +542,7 @@ } } }, -"revision": "20240712", +"revision": "20240905", "rootUrl": "https://serviceconsumermanagement.googleapis.com/", "schemas": { "AddTenantProjectRequest": { @@ -1340,6 +1340,17 @@ }, "type": "object" }, +"ExperimentalFeatures": { +"description": "Experimental features to be included during client library generation. These fields will be deprecated once the feature graduates and is enabled by default.", +"id": "ExperimentalFeatures", +"properties": { +"restAsyncIoEnabled": { +"description": "Enables generation of asynchronous REST clients if `rest` transport is enabled. By default, asynchronous REST clients will not be generated. This feature will be enabled by default 1 month after launching the feature in preview packages.", +"type": "boolean" +} +}, +"type": "object" +}, "Field": { "description": "A single field of a message type.", "id": "Field", @@ -1979,6 +1990,25 @@ "description": "The sampling period of metric data points. For metrics which are written periodically, consecutive data points are stored at this time interval, excluding data loss due to errors. Metrics with a higher granularity have a smaller sampling period.", "format": "google-duration", "type": "string" +}, +"timeSeriesResourceHierarchyLevel": { +"description": "The scope of the timeseries data of the metric.", +"items": { +"enum": [ +"TIME_SERIES_RESOURCE_HIERARCHY_LEVEL_UNSPECIFIED", +"PROJECT", +"ORGANIZATION", +"FOLDER" +], +"enumDescriptions": [ +"Do not use this default value.", +"Scopes a metric to a project.", +"Scopes a metric to an organization.", +"Scopes a metric to a folder." +], +"type": "string" +}, +"type": "array" } }, "type": "object" @@ -2324,6 +2354,10 @@ "common": { "$ref": "CommonLanguageSettings", "description": "Some settings." +}, +"experimentalFeatures": { +"$ref": "ExperimentalFeatures", +"description": "Experimental features to be included during client library generation." } }, "type": "object" diff --git a/googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1beta1.json b/googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1beta1.json index f3d9e84a518..da44b08edc3 100644 --- a/googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1beta1.json @@ -715,7 +715,7 @@ } } }, -"revision": "20240712", +"revision": "20240905", "rootUrl": "https://serviceconsumermanagement.googleapis.com/", "schemas": { "Api": { @@ -1425,6 +1425,17 @@ }, "type": "object" }, +"ExperimentalFeatures": { +"description": "Experimental features to be included during client library generation. These fields will be deprecated once the feature graduates and is enabled by default.", +"id": "ExperimentalFeatures", +"properties": { +"restAsyncIoEnabled": { +"description": "Enables generation of asynchronous REST clients if `rest` transport is enabled. By default, asynchronous REST clients will not be generated. This feature will be enabled by default 1 month after launching the feature in preview packages.", +"type": "boolean" +} +}, +"type": "object" +}, "Field": { "description": "A single field of a message type.", "id": "Field", @@ -2028,6 +2039,25 @@ "description": "The sampling period of metric data points. For metrics which are written periodically, consecutive data points are stored at this time interval, excluding data loss due to errors. Metrics with a higher granularity have a smaller sampling period.", "format": "google-duration", "type": "string" +}, +"timeSeriesResourceHierarchyLevel": { +"description": "The scope of the timeseries data of the metric.", +"items": { +"enum": [ +"TIME_SERIES_RESOURCE_HIERARCHY_LEVEL_UNSPECIFIED", +"PROJECT", +"ORGANIZATION", +"FOLDER" +], +"enumDescriptions": [ +"Do not use this default value.", +"Scopes a metric to a project.", +"Scopes a metric to an organization.", +"Scopes a metric to a folder." +], +"type": "string" +}, +"type": "array" } }, "type": "object" @@ -2355,6 +2385,10 @@ "common": { "$ref": "CommonLanguageSettings", "description": "Some settings." +}, +"experimentalFeatures": { +"$ref": "ExperimentalFeatures", +"description": "Experimental features to be included during client library generation." } }, "type": "object" From 5542477f5c1c3f767c3d9f236c0d862447efe72a Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 17 Sep 2024 07:08:06 +0000 Subject: [PATCH 28/32] feat(serviceusage): update the api #### serviceusage:v1 The following keys were added: - schemas.ExperimentalFeatures (Total Keys: 3) - schemas.MetricDescriptorMetadata.properties.timeSeriesResourceHierarchyLevel (Total Keys: 2) - schemas.PythonSettings.properties.experimentalFeatures.$ref (Total Keys: 1) #### serviceusage:v1beta1 The following keys were added: - schemas.ExperimentalFeatures (Total Keys: 3) - schemas.MetricDescriptorMetadata.properties.timeSeriesResourceHierarchyLevel (Total Keys: 2) - schemas.PythonSettings.properties.experimentalFeatures.$ref (Total Keys: 1) --- .../documents/serviceusage.v1.json | 36 ++++++++++++++++++- .../documents/serviceusage.v1beta1.json | 36 ++++++++++++++++++- 2 files changed, 70 insertions(+), 2 deletions(-) diff --git a/googleapiclient/discovery_cache/documents/serviceusage.v1.json b/googleapiclient/discovery_cache/documents/serviceusage.v1.json index 8c6df13589a..211240a8ee4 100644 --- a/googleapiclient/discovery_cache/documents/serviceusage.v1.json +++ b/googleapiclient/discovery_cache/documents/serviceusage.v1.json @@ -426,7 +426,7 @@ } } }, -"revision": "20240811", +"revision": "20240905", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -1516,6 +1516,17 @@ }, "type": "object" }, +"ExperimentalFeatures": { +"description": "Experimental features to be included during client library generation. These fields will be deprecated once the feature graduates and is enabled by default.", +"id": "ExperimentalFeatures", +"properties": { +"restAsyncIoEnabled": { +"description": "Enables generation of asynchronous REST clients if `rest` transport is enabled. By default, asynchronous REST clients will not be generated. This feature will be enabled by default 1 month after launching the feature in preview packages.", +"type": "boolean" +} +}, +"type": "object" +}, "Field": { "description": "A single field of a message type.", "id": "Field", @@ -2617,6 +2628,25 @@ "description": "The sampling period of metric data points. For metrics which are written periodically, consecutive data points are stored at this time interval, excluding data loss due to errors. Metrics with a higher granularity have a smaller sampling period.", "format": "google-duration", "type": "string" +}, +"timeSeriesResourceHierarchyLevel": { +"description": "The scope of the timeseries data of the metric.", +"items": { +"enum": [ +"TIME_SERIES_RESOURCE_HIERARCHY_LEVEL_UNSPECIFIED", +"PROJECT", +"ORGANIZATION", +"FOLDER" +], +"enumDescriptions": [ +"Do not use this default value.", +"Scopes a metric to a project.", +"Scopes a metric to an organization.", +"Scopes a metric to a folder." +], +"type": "string" +}, +"type": "array" } }, "type": "object" @@ -2958,6 +2988,10 @@ "common": { "$ref": "CommonLanguageSettings", "description": "Some settings." +}, +"experimentalFeatures": { +"$ref": "ExperimentalFeatures", +"description": "Experimental features to be included during client library generation." } }, "type": "object" diff --git a/googleapiclient/discovery_cache/documents/serviceusage.v1beta1.json b/googleapiclient/discovery_cache/documents/serviceusage.v1beta1.json index c2dd4e54bc7..6627cf058b6 100644 --- a/googleapiclient/discovery_cache/documents/serviceusage.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/serviceusage.v1beta1.json @@ -964,7 +964,7 @@ } } }, -"revision": "20240811", +"revision": "20240905", "rootUrl": "https://serviceusage.googleapis.com/", "schemas": { "AddEnableRulesMetadata": { @@ -2093,6 +2093,17 @@ }, "type": "object" }, +"ExperimentalFeatures": { +"description": "Experimental features to be included during client library generation. These fields will be deprecated once the feature graduates and is enabled by default.", +"id": "ExperimentalFeatures", +"properties": { +"restAsyncIoEnabled": { +"description": "Enables generation of asynchronous REST clients if `rest` transport is enabled. By default, asynchronous REST clients will not be generated. This feature will be enabled by default 1 month after launching the feature in preview packages.", +"type": "boolean" +} +}, +"type": "object" +}, "Field": { "description": "A single field of a message type.", "id": "Field", @@ -3312,6 +3323,25 @@ "description": "The sampling period of metric data points. For metrics which are written periodically, consecutive data points are stored at this time interval, excluding data loss due to errors. Metrics with a higher granularity have a smaller sampling period.", "format": "google-duration", "type": "string" +}, +"timeSeriesResourceHierarchyLevel": { +"description": "The scope of the timeseries data of the metric.", +"items": { +"enum": [ +"TIME_SERIES_RESOURCE_HIERARCHY_LEVEL_UNSPECIFIED", +"PROJECT", +"ORGANIZATION", +"FOLDER" +], +"enumDescriptions": [ +"Do not use this default value.", +"Scopes a metric to a project.", +"Scopes a metric to an organization.", +"Scopes a metric to a folder." +], +"type": "string" +}, +"type": "array" } }, "type": "object" @@ -3702,6 +3732,10 @@ "common": { "$ref": "CommonLanguageSettings", "description": "Some settings." +}, +"experimentalFeatures": { +"$ref": "ExperimentalFeatures", +"description": "Experimental features to be included during client library generation." } }, "type": "object" From 921d89c42e23f4f46bde9c0fe873eb3e32011411 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 17 Sep 2024 07:08:06 +0000 Subject: [PATCH 29/32] fix(translate): update the api #### translate:v3 The following keys were changed: - resources.projects.resources.locations.resources.glossaries.methods.create.scopes (Total Keys: 1) --- googleapiclient/discovery_cache/documents/translate.v3.json | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/googleapiclient/discovery_cache/documents/translate.v3.json b/googleapiclient/discovery_cache/documents/translate.v3.json index efcb0402581..13eb0b1eca9 100644 --- a/googleapiclient/discovery_cache/documents/translate.v3.json +++ b/googleapiclient/discovery_cache/documents/translate.v3.json @@ -1132,7 +1132,8 @@ "$ref": "Operation" }, "scopes": [ -"https://www.googleapis.com/auth/cloud-platform" +"https://www.googleapis.com/auth/cloud-platform", +"https://www.googleapis.com/auth/cloud-translation" ] }, "delete": { @@ -1707,7 +1708,7 @@ } } }, -"revision": "20240821", +"revision": "20240912", "rootUrl": "https://translation.googleapis.com/", "schemas": { "AdaptiveMtDataset": { From dc538293d084640b60c07b5d8265596b903cb2cf Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 17 Sep 2024 07:08:06 +0000 Subject: [PATCH 30/32] feat(vpcaccess): update the api #### vpcaccess:v1 The following keys were added: - schemas.Connector.properties.maxThroughput.deprecated (Total Keys: 1) - schemas.Connector.properties.minThroughput.deprecated (Total Keys: 1) #### vpcaccess:v1beta1 The following keys were added: - schemas.Connector.properties.maxThroughput.deprecated (Total Keys: 1) - schemas.Connector.properties.minThroughput.deprecated (Total Keys: 1) --- ...cess_v1.projects.locations.connectors.html | 40 +++++++++---------- ...v1beta1.projects.locations.connectors.html | 40 +++++++++---------- .../documents/vpcaccess.v1.json | 14 ++++--- .../documents/vpcaccess.v1beta1.json | 14 ++++--- 4 files changed, 56 insertions(+), 52 deletions(-) diff --git a/docs/dyn/vpcaccess_v1.projects.locations.connectors.html b/docs/dyn/vpcaccess_v1.projects.locations.connectors.html index cb0b737de4f..108af6632ef 100644 --- a/docs/dyn/vpcaccess_v1.projects.locations.connectors.html +++ b/docs/dyn/vpcaccess_v1.projects.locations.connectors.html @@ -114,18 +114,18 @@

Method Details

"connectedProjects": [ # Output only. List of projects using the connector. "A String", ], - "ipCidrRange": "A String", # The range of internal addresses that follows RFC 4632 notation. Example: `10.132.0.0/28`. + "ipCidrRange": "A String", # Optional. The range of internal addresses that follows RFC 4632 notation. Example: `10.132.0.0/28`. "machineType": "A String", # Machine type of VM Instance underlying connector. Default is e2-micro "maxInstances": 42, # Maximum value of instances in autoscaling group underlying the connector. "maxThroughput": 42, # Maximum throughput of the connector in Mbps. Refers to the expected throughput when using an `e2-micro` machine type. Value must be a multiple of 100 from 300 through 1000. Must be higher than the value specified by --min-throughput. If both max-throughput and max-instances are provided, max-instances takes precedence over max-throughput. The use of `max-throughput` is discouraged in favor of `max-instances`. "minInstances": 42, # Minimum value of instances in autoscaling group underlying the connector. "minThroughput": 42, # Minimum throughput of the connector in Mbps. Refers to the expected throughput when using an `e2-micro` machine type. Value must be a multiple of 100 from 200 through 900. Must be lower than the value specified by --max-throughput. If both min-throughput and min-instances are provided, min-instances takes precedence over min-throughput. The use of `min-throughput` is discouraged in favor of `min-instances`. "name": "A String", # The resource name in the format `projects/*/locations/*/connectors/*`. - "network": "A String", # Name of a VPC network. + "network": "A String", # Optional. Name of a VPC network. "state": "A String", # Output only. State of the VPC access connector. - "subnet": { # The subnet in which to house the connector # The subnet in which to house the VPC Access Connector. - "name": "A String", # Subnet name (relative, not fully qualified). E.g. if the full subnet selfLink is https://compute.googleapis.com/compute/v1/projects/{project}/regions/{region}/subnetworks/{subnetName} the correct input for this field would be {subnetName} - "projectId": "A String", # Project in which the subnet exists. If not set, this project is assumed to be the project for which the connector create request was issued. + "subnet": { # The subnet in which to house the connector # Optional. The subnet in which to house the VPC Access Connector. + "name": "A String", # Optional. Subnet name (relative, not fully qualified). E.g. if the full subnet selfLink is https://compute.googleapis.com/compute/v1/projects/{project}/regions/{region}/subnetworks/{subnetName} the correct input for this field would be {subnetName} + "projectId": "A String", # Optional. Project in which the subnet exists. If not set, this project is assumed to be the project for which the connector create request was issued. }, } @@ -212,18 +212,18 @@

Method Details

"A String", ], "createTime": "A String", # Output only. The creation time of the connector. - "ipCidrRange": "A String", # The range of internal addresses that follows RFC 4632 notation. Example: `10.132.0.0/28`. + "ipCidrRange": "A String", # Optional. The range of internal addresses that follows RFC 4632 notation. Example: `10.132.0.0/28`. "lastRestartTime": "A String", # Output only. The last restart time of the connector. "machineType": "A String", # Machine type of VM Instance underlying connector. Default is e2-micro "maxInstances": 42, # Maximum value of instances in autoscaling group underlying the connector. @@ -123,11 +123,11 @@

Method Details

"minInstances": 42, # Minimum value of instances in autoscaling group underlying the connector. "minThroughput": 42, # Minimum throughput of the connector in Mbps. Refers to the expected throughput when using an `e2-micro` machine type. Value must be a multiple of 100 from 200 through 900. Must be lower than the value specified by --max-throughput. If both min-throughput and min-instances are provided, min-instances takes precedence over min-throughput. The use of `min-throughput` is discouraged in favor of `min-instances`. "name": "A String", # The resource name in the format `projects/*/locations/*/connectors/*`. - "network": "A String", # Name of a VPC network. + "network": "A String", # Optional. Name of a VPC network. "state": "A String", # Output only. State of the VPC access connector. - "subnet": { # The subnet in which to house the connector # The subnet in which to house the VPC Access Connector. - "name": "A String", # Subnet name (relative, not fully qualified). E.g. if the full subnet selfLink is https://compute.googleapis.com/compute/v1/projects/{project}/regions/{region}/subnetworks/{subnetName} the correct input for this field would be {subnetName} - "projectId": "A String", # Project in which the subnet exists. If not set, this project is assumed to be the project for which the connector create request was issued. + "subnet": { # The subnet in which to house the connector # Optional. The subnet in which to house the VPC Access Connector. + "name": "A String", # Optional. Subnet name (relative, not fully qualified). E.g. if the full subnet selfLink is https://compute.googleapis.com/compute/v1/projects/{project}/regions/{region}/subnetworks/{subnetName} the correct input for this field would be {subnetName} + "projectId": "A String", # Optional. Project in which the subnet exists. If not set, this project is assumed to be the project for which the connector create request was issued. }, } diff --git a/googleapiclient/discovery_cache/documents/vpcaccess.v1.json b/googleapiclient/discovery_cache/documents/vpcaccess.v1.json index eae622d98f5..70b0fd6d014 100644 --- a/googleapiclient/discovery_cache/documents/vpcaccess.v1.json +++ b/googleapiclient/discovery_cache/documents/vpcaccess.v1.json @@ -384,7 +384,7 @@ } } }, -"revision": "20240618", +"revision": "20240905", "rootUrl": "https://vpcaccess.googleapis.com/", "schemas": { "Connector": { @@ -400,7 +400,7 @@ "type": "array" }, "ipCidrRange": { -"description": "The range of internal addresses that follows RFC 4632 notation. Example: `10.132.0.0/28`.", +"description": "Optional. The range of internal addresses that follows RFC 4632 notation. Example: `10.132.0.0/28`.", "type": "string" }, "machineType": { @@ -413,6 +413,7 @@ "type": "integer" }, "maxThroughput": { +"deprecated": true, "description": "Maximum throughput of the connector in Mbps. Refers to the expected throughput when using an `e2-micro` machine type. Value must be a multiple of 100 from 300 through 1000. Must be higher than the value specified by --min-throughput. If both max-throughput and max-instances are provided, max-instances takes precedence over max-throughput. The use of `max-throughput` is discouraged in favor of `max-instances`.", "format": "int32", "type": "integer" @@ -423,6 +424,7 @@ "type": "integer" }, "minThroughput": { +"deprecated": true, "description": "Minimum throughput of the connector in Mbps. Refers to the expected throughput when using an `e2-micro` machine type. Value must be a multiple of 100 from 200 through 900. Must be lower than the value specified by --max-throughput. If both min-throughput and min-instances are provided, min-instances takes precedence over min-throughput. The use of `min-throughput` is discouraged in favor of `min-instances`.", "format": "int32", "type": "integer" @@ -432,7 +434,7 @@ "type": "string" }, "network": { -"description": "Name of a VPC network.", +"description": "Optional. Name of a VPC network.", "type": "string" }, "state": { @@ -458,7 +460,7 @@ }, "subnet": { "$ref": "Subnet", -"description": "The subnet in which to house the VPC Access Connector." +"description": "Optional. The subnet in which to house the VPC Access Connector." } }, "type": "object" @@ -705,11 +707,11 @@ "id": "Subnet", "properties": { "name": { -"description": "Subnet name (relative, not fully qualified). E.g. if the full subnet selfLink is https://compute.googleapis.com/compute/v1/projects/{project}/regions/{region}/subnetworks/{subnetName} the correct input for this field would be {subnetName}", +"description": "Optional. Subnet name (relative, not fully qualified). E.g. if the full subnet selfLink is https://compute.googleapis.com/compute/v1/projects/{project}/regions/{region}/subnetworks/{subnetName} the correct input for this field would be {subnetName}", "type": "string" }, "projectId": { -"description": "Project in which the subnet exists. If not set, this project is assumed to be the project for which the connector create request was issued.", +"description": "Optional. Project in which the subnet exists. If not set, this project is assumed to be the project for which the connector create request was issued.", "type": "string" } }, diff --git a/googleapiclient/discovery_cache/documents/vpcaccess.v1beta1.json b/googleapiclient/discovery_cache/documents/vpcaccess.v1beta1.json index baa39aa77f8..47e72cf6f4d 100644 --- a/googleapiclient/discovery_cache/documents/vpcaccess.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/vpcaccess.v1beta1.json @@ -384,7 +384,7 @@ } } }, -"revision": "20240618", +"revision": "20240905", "rootUrl": "https://vpcaccess.googleapis.com/", "schemas": { "Connector": { @@ -406,7 +406,7 @@ "type": "string" }, "ipCidrRange": { -"description": "The range of internal addresses that follows RFC 4632 notation. Example: `10.132.0.0/28`.", +"description": "Optional. The range of internal addresses that follows RFC 4632 notation. Example: `10.132.0.0/28`.", "type": "string" }, "lastRestartTime": { @@ -425,6 +425,7 @@ "type": "integer" }, "maxThroughput": { +"deprecated": true, "description": "Maximum throughput of the connector in Mbps. Refers to the expected throughput when using an `e2-micro` machine type. Value must be a multiple of 100 from 300 through 1000. Must be higher than the value specified by --min-throughput. If both max-throughput and max-instances are provided, max-instances takes precedence over max-throughput. The use of `max-throughput` is discouraged in favor of `max-instances`.", "format": "int32", "type": "integer" @@ -435,6 +436,7 @@ "type": "integer" }, "minThroughput": { +"deprecated": true, "description": "Minimum throughput of the connector in Mbps. Refers to the expected throughput when using an `e2-micro` machine type. Value must be a multiple of 100 from 200 through 900. Must be lower than the value specified by --max-throughput. If both min-throughput and min-instances are provided, min-instances takes precedence over min-throughput. The use of `min-throughput` is discouraged in favor of `min-instances`.", "format": "int32", "type": "integer" @@ -444,7 +446,7 @@ "type": "string" }, "network": { -"description": "Name of a VPC network.", +"description": "Optional. Name of a VPC network.", "type": "string" }, "state": { @@ -470,7 +472,7 @@ }, "subnet": { "$ref": "Subnet", -"description": "The subnet in which to house the VPC Access Connector." +"description": "Optional. The subnet in which to house the VPC Access Connector." } }, "type": "object" @@ -717,11 +719,11 @@ "id": "Subnet", "properties": { "name": { -"description": "Subnet name (relative, not fully qualified). E.g. if the full subnet selfLink is https://compute.googleapis.com/compute/v1/projects/{project}/regions/{region}/subnetworks/{subnetName} the correct input for this field would be {subnetName}", +"description": "Optional. Subnet name (relative, not fully qualified). E.g. if the full subnet selfLink is https://compute.googleapis.com/compute/v1/projects/{project}/regions/{region}/subnetworks/{subnetName} the correct input for this field would be {subnetName}", "type": "string" }, "projectId": { -"description": "Project in which the subnet exists. If not set, this project is assumed to be the project for which the connector create request was issued.", +"description": "Optional. Project in which the subnet exists. If not set, this project is assumed to be the project for which the connector create request was issued.", "type": "string" } }, From 3a7e931b6a167b9247b8385ef9b5c2023ff5ee0c Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 17 Sep 2024 07:08:06 +0000 Subject: [PATCH 31/32] feat(walletobjects): update the api #### walletobjects:v1 The following keys were added: - schemas.FlightClass.properties.locations.deprecated (Total Keys: 1) - schemas.GiftCardClass.properties.locations.deprecated (Total Keys: 1) - schemas.LoyaltyClass.properties.locations.deprecated (Total Keys: 1) - schemas.OfferClass.properties.locations.deprecated (Total Keys: 1) - schemas.TransitClass.properties.locations.deprecated (Total Keys: 1) --- .../discovery_cache/documents/walletobjects.v1.json | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/googleapiclient/discovery_cache/documents/walletobjects.v1.json b/googleapiclient/discovery_cache/documents/walletobjects.v1.json index f6ae183c6c7..c3e499ad086 100644 --- a/googleapiclient/discovery_cache/documents/walletobjects.v1.json +++ b/googleapiclient/discovery_cache/documents/walletobjects.v1.json @@ -2681,7 +2681,7 @@ } } }, -"revision": "20240809", +"revision": "20240913", "rootUrl": "https://walletobjects.googleapis.com/", "schemas": { "ActivationOptions": { @@ -4701,6 +4701,7 @@ true "description": "Translated strings for the issuer_name. Recommended maximum length is 20 characters to ensure full string is displayed on smaller screens." }, "locations": { +"deprecated": true, "description": "Note: This field is currently not supported to trigger geo notifications.", "items": { "$ref": "LatLongPoint" @@ -5573,6 +5574,7 @@ true "description": "Translated strings for the pin_label." }, "locations": { +"deprecated": true, "description": "Note: This field is currently not supported to trigger geo notifications.", "items": { "$ref": "LatLongPoint" @@ -6397,6 +6399,7 @@ true "description": "Translated strings for the secondary_rewards_tier_label." }, "locations": { +"deprecated": true, "description": "Note: This field is currently not supported to trigger geo notifications.", "items": { "$ref": "LatLongPoint" @@ -7324,6 +7327,7 @@ false "description": "Translated strings for the title. Recommended maximum length is 60 characters to ensure full string is displayed on smaller screens." }, "locations": { +"deprecated": true, "description": "Note: This field is currently not supported to trigger geo notifications.", "items": { "$ref": "LatLongPoint" @@ -8696,6 +8700,7 @@ true "description": "Translated strings for the issuer_name. Recommended maximum length is 20 characters to ensure full string is displayed on smaller screens." }, "locations": { +"deprecated": true, "description": "Note: This field is currently not supported to trigger geo notifications.", "items": { "$ref": "LatLongPoint" From 57798cd0498af23eea2a9651b998bf0edd042c5e Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 17 Sep 2024 07:08:06 +0000 Subject: [PATCH 32/32] chore(docs): Add new discovery artifacts and artifacts with minor updates --- ....monetization.subscriptions.basePlans.html | 30 ++--- ...blisher_v3.monetization.subscriptions.html | 100 +++++++-------- ...pdr_v1.projects.locations.backupPlans.html | 6 +- docs/dyn/calendar_v3.events.html | 71 ++++++----- ...ourses.announcements.addOnAttachments.html | 100 +++++++-------- .../classroom_v1.courses.announcements.html | 8 +- ...1.courses.courseWork.addOnAttachments.html | 100 +++++++-------- ...k.addOnAttachments.studentSubmissions.html | 8 +- docs/dyn/classroom_v1.courses.courseWork.html | 8 +- ....courseWorkMaterials.addOnAttachments.html | 100 +++++++-------- ...ssroom_v1.courses.courseWorkMaterials.html | 8 +- ...oom_v1.courses.posts.addOnAttachments.html | 100 +++++++-------- ...s.addOnAttachments.studentSubmissions.html | 8 +- docs/dyn/classroom_v1.courses.posts.html | 8 +- .../cloudbilling_v1beta.billingAccounts.html | 2 +- docs/dyn/cloudbilling_v1beta.v1beta.html | 2 +- ..._v1.organizations.locations.customers.html | 4 +- ...eta.organizations.locations.customers.html | 4 +- ...yvideo_v2.advertisers.insertionOrders.html | 24 ++-- ...displayvideo_v2.advertisers.lineItems.html | 16 +-- .../displayvideo_v3.advertisers.adGroups.html | 4 +- ...yvideo_v3.advertisers.insertionOrders.html | 24 ++-- ...displayvideo_v3.advertisers.lineItems.html | 32 ++--- docs/dyn/iap_v1.v1.html | 12 +- ...chaenterprise_v1.projects.assessments.html | 36 +++--- ...terprise_v1.projects.firewallpolicies.html | 64 +++++----- .../recaptchaenterprise_v1.projects.keys.html | 88 ++++++------- docs/dyn/sts_v1.v1.html | 4 +- ...orkstationClusters.workstationConfigs.html | 20 +-- ...orkstationClusters.workstationConfigs.html | 30 ++--- ...sters.workstationConfigs.workstations.html | 30 ++--- docs/dyn/youtube_v3.videos.html | 10 +- .../documents/androidpublisher.v3.json | 12 +- .../documents/backupdr.v1.json | 4 +- .../documents/calendar.v3.json | 10 +- .../documents/classroom.v1.json | 116 +++++++++--------- .../documents/cloudbilling.v1beta.json | 4 +- .../documents/cloudcontrolspartner.v1.json | 4 +- .../cloudcontrolspartner.v1beta.json | 4 +- .../documents/displayvideo.v2.json | 14 +-- .../documents/displayvideo.v3.json | 16 +-- .../firebaseappdistribution.v1alpha.json | 8 +- .../discovery_cache/documents/iap.v1.json | 6 +- .../documents/recaptchaenterprise.v1.json | 58 ++++----- .../discovery_cache/documents/sts.v1.json | 6 +- .../documents/workstations.v1.json | 6 +- .../documents/workstations.v1beta.json | 14 +-- .../discovery_cache/documents/youtube.v3.json | 4 +- 48 files changed, 685 insertions(+), 662 deletions(-) diff --git a/docs/dyn/androidpublisher_v3.monetization.subscriptions.basePlans.html b/docs/dyn/androidpublisher_v3.monetization.subscriptions.basePlans.html index 9e441ab3fe6..afa4417ed46 100644 --- a/docs/dyn/androidpublisher_v3.monetization.subscriptions.basePlans.html +++ b/docs/dyn/androidpublisher_v3.monetization.subscriptions.basePlans.html @@ -133,7 +133,7 @@

Method Details

{ # A single base plan for a subscription. "autoRenewingBasePlanType": { # Represents a base plan that automatically renews at the end of its subscription period. # Set when the base plan automatically renews at a regular interval. "accountHoldDuration": "A String", # Optional. Account hold period of the subscription, specified in ISO 8601 format. Acceptable values must be in DAYS and in the range P0D (zero days) to P30D (30 days). If not specified, the default value is P30D (30 days). - "billingPeriodDuration": "A String", # Required. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center. + "billingPeriodDuration": "A String", # Required. Immutable. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center. The duration is immutable after the base plan is created. "gracePeriodDuration": "A String", # Grace period of the subscription, specified in ISO 8601 format. Acceptable values are P0D (zero days), P3D (3 days), P7D (7 days), P14D (14 days), and P30D (30 days). If not specified, a default value will be used based on the recurring period duration. "legacyCompatible": True or False, # Whether the renewing base plan is backward compatible. The backward compatible base plan is returned by the Google Play Billing Library deprecated method querySkuDetailsAsync(). Only one renewing base plan can be marked as legacy compatible for a given subscription. "legacyCompatibleSubscriptionOfferId": "A String", # Subscription offer id which is legacy compatible. The backward compatible subscription offer is returned by the Google Play Billing Library deprecated method querySkuDetailsAsync(). Only one subscription offer can be marked as legacy compatible for a given renewing base plan. To have no Subscription offer as legacy compatible set this field as empty string. @@ -143,11 +143,11 @@

Method Details

"basePlanId": "A String", # Required. Immutable. The unique identifier of this base plan. Must be unique within the subscription, and conform with RFC-1034. That is, this ID can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 63 characters. "installmentsBasePlanType": { # Represents an installments base plan where a user commits to a specified number of payments. # Set for installments base plans where a user is committed to a specified number of payments. "accountHoldDuration": "A String", # Optional. Account hold period of the subscription, specified exclusively in days and in ISO 8601 format. Acceptable values are P0D (zero days) to P30D (30days). If not specified, the default value is P30D (30 days). - "billingPeriodDuration": "A String", # Required. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center. - "committedPaymentsCount": 42, # Required. The number of payments the user is committed to. + "billingPeriodDuration": "A String", # Required. Immutable. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center. The duration is immutable after the base plan is created. + "committedPaymentsCount": 42, # Required. Immutable. The number of payments the user is committed to. It is immutable after the base plan is created. "gracePeriodDuration": "A String", # Grace period of the subscription, specified in ISO 8601 format. Acceptable values are P0D (zero days), P3D (3 days), P7D (7 days), P14D (14 days), and P30D (30 days). If not specified, a default value will be used based on the recurring period duration. "prorationMode": "A String", # The proration mode for the base plan determines what happens when a user switches to this plan from another base plan. If unspecified, defaults to CHARGE_ON_NEXT_BILLING_DATE. - "renewalType": "A String", # Required. Installments base plan renewal type. Determines the behavior at the end of the initial commitment. + "renewalType": "A String", # Required. Immutable. Installments base plan renewal type. Determines the behavior at the end of the initial commitment. The renewal type is immutable after the base plan is created. "resubscribeState": "A String", # Whether users should be able to resubscribe to this base plan in Google Play surfaces. Defaults to RESUBSCRIBE_STATE_ACTIVE if not specified. }, "offerTags": [ # List of up to 20 custom tags specified for this base plan, and returned to the app through the billing library. Subscription offers for this base plan will also receive these offer tags in the billing library. @@ -169,7 +169,7 @@

Method Details

}, }, "prepaidBasePlanType": { # Represents a base plan that does not automatically renew at the end of the base plan, and must be manually renewed by the user. # Set when the base plan does not automatically renew at the end of the billing period. - "billingPeriodDuration": "A String", # Required. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center. + "billingPeriodDuration": "A String", # Required. Immutable. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center. The duration is immutable after the base plan is created. "timeExtension": "A String", # Whether users should be able to extend this prepaid base plan in Google Play surfaces. Defaults to TIME_EXTENSION_ACTIVE if not specified. }, "regionalConfigs": [ # Region-specific information for this base plan. @@ -309,7 +309,7 @@

Method Details

body: object, The request body. The object takes the form of: -{ # A `BackupPlan` specifies some common fields, such as `display_name` as well as one or more `BackupRule` messages. Each `BackupRule` has a retention policy and defines a schedule by which the system is to perform backup workloads. +{ # A `BackupPlan` specifies some common fields, such as `description` as well as one or more `BackupRule` messages. Each `BackupRule` has a retention policy and defines a schedule by which the system is to perform backup workloads. "backupRules": [ # Required. The backup rules for this `BackupPlan`. There must be at least one `BackupRule` message. { # `BackupRule` binds the backup schedule to a retention policy. "backupRetentionDays": 42, # Required. Configures the duration for which backup data will be kept. It is defined in “days”. The value should be greater than or equal to minimum enforced retention of the backup vault. @@ -231,7 +231,7 @@

Method Details

Returns: An object of the form: - { # A `BackupPlan` specifies some common fields, such as `display_name` as well as one or more `BackupRule` messages. Each `BackupRule` has a retention policy and defines a schedule by which the system is to perform backup workloads. + { # A `BackupPlan` specifies some common fields, such as `description` as well as one or more `BackupRule` messages. Each `BackupRule` has a retention policy and defines a schedule by which the system is to perform backup workloads. "backupRules": [ # Required. The backup rules for this `BackupPlan`. There must be at least one `BackupRule` message. { # `BackupRule` binds the backup schedule to a retention policy. "backupRetentionDays": 42, # Required. Configures the duration for which backup data will be kept. It is defined in “days”. The value should be greater than or equal to minimum enforced retention of the backup vault. @@ -295,7 +295,7 @@

Method Details

{ # The response message for getting a list of `BackupPlan`. "backupPlans": [ # The list of `BackupPlans` in the project for the specified location. If the `{location}` value in the request is "-", the response contains a list of resources from all locations. In case any location is unreachable, the response will only return backup plans in reachable locations and the 'unreachable' field will be populated with a list of unreachable locations. BackupPlan - { # A `BackupPlan` specifies some common fields, such as `display_name` as well as one or more `BackupRule` messages. Each `BackupRule` has a retention policy and defines a schedule by which the system is to perform backup workloads. + { # A `BackupPlan` specifies some common fields, such as `description` as well as one or more `BackupRule` messages. Each `BackupRule` has a retention policy and defines a schedule by which the system is to perform backup workloads. "backupRules": [ # Required. The backup rules for this `BackupPlan`. There must be at least one `BackupRule` message. { # `BackupRule` binds the backup schedule to a retention policy. "backupRetentionDays": 42, # Required. Configures the duration for which backup data will be kept. It is defined in “days”. The value should be greater than or equal to minimum enforced retention of the backup vault. diff --git a/docs/dyn/calendar_v3.events.html b/docs/dyn/calendar_v3.events.html index be076afef8d..b685c5a1f64 100644 --- a/docs/dyn/calendar_v3.events.html +++ b/docs/dyn/calendar_v3.events.html @@ -103,7 +103,7 @@

Instance Methods

Retrieves the next page of results.

move(calendarId, eventId, destination, sendNotifications=None, sendUpdates=None)

Moves an event to another calendar, i.e. changes an event's organizer. Note that only default events can be moved; outOfOffice, focusTime, workingLocation and fromGmail events cannot be moved.

Moves an event to another calendar, i.e. changes an event's organizer. Note that only default events can be moved; birthday, focusTime, fromGmail, outOfOffice and workingLocation events cannot be moved.

patch(calendarId, eventId, alwaysIncludeEmail=None, body=None, conferenceDataVersion=None, maxAttendees=None, sendNotifications=None, sendUpdates=None, supportsAttachments=None)

Updates an event. This method supports patch semantics.

@@ -308,11 +308,12 @@

Method Details

"endTimeUnspecified": false, # Whether the end time is actually unspecified. An end time is still provided for compatibility reasons, even if this attribute is set to True. The default is False. "etag": "A String", # ETag of the resource. "eventType": "default", # Specific type of the event. This cannot be modified after the event is created. Possible values are: + # - "birthday" - A special all-day event with an annual recurrence. # - "default" - A regular event or not further specified. - # - "outOfOffice" - An out-of-office event. # - "focusTime" - A focus-time event. - # - "workingLocation" - A working location event. # - "fromGmail" - An event from Gmail. This type of event cannot be created. + # - "outOfOffice" - An out-of-office event. + # - "workingLocation" - A working location event. "extendedProperties": { # Extended properties of the event. "private": { # Properties that are private to the copy of the event that appears on this calendar. "a_key": "A String", # The name of the private property and the corresponding value. @@ -604,11 +605,12 @@

Method Details

alwaysIncludeEmail: boolean, Deprecated and ignored. eventTypes: string, Event types to return. Optional. This parameter can be repeated multiple times to return events of different types. If unset, returns all event types. (repeated) Allowed values + birthday - Special all-day events with an annual recurrence. default - Regular events. focusTime - Focus time events. fromGmail - Events from Gmail. @@ -2207,11 +2214,12 @@

Method Details

move(calendarId, eventId, destination, sendNotifications=None, sendUpdates=None) -

Moves an event to another calendar, i.e. changes an event's organizer. Note that only default events can be moved; outOfOffice, focusTime, workingLocation and fromGmail events cannot be moved.
+  Moves an event to another calendar, i.e. changes an event's organizer. Note that only default events can be moved; birthday, focusTime, fromGmail, outOfOffice and workingLocation events cannot be moved.
 
 Args:
   calendarId: string, Calendar identifier of the source calendar where the event currently is on. (required)
@@ -2535,11 +2543,12 @@ Method Details
   "endTimeUnspecified": false, # Whether the end time is actually unspecified. An end time is still provided for compatibility reasons, even if this attribute is set to True. The default is False.
   "etag": "A String", # ETag of the resource.
   "eventType": "default", # Specific type of the event. This cannot be modified after the event is created. Possible values are:
+      # - "birthday" - A special all-day event with an annual recurrence.
       # - "default" - A regular event or not further specified.
-      # - "outOfOffice" - An out-of-office event.
       # - "focusTime" - A focus-time event.
-      # - "workingLocation" - A working location event.
       # - "fromGmail" - An event from Gmail. This type of event cannot be created.
+      # - "outOfOffice" - An out-of-office event.
+      # - "workingLocation" - A working location event.
   "extendedProperties": { # Extended properties of the event.
     "private": { # Properties that are private to the copy of the event that appears on this calendar.
       "a_key": "A String", # The name of the private property and the corresponding value.
@@ -2831,11 +2840,12 @@ Method Details
   "endTimeUnspecified": false, # Whether the end time is actually unspecified. An end time is still provided for compatibility reasons, even if this attribute is set to True. The default is False.
   "etag": "A String", # ETag of the resource.
   "eventType": "default", # Specific type of the event. This cannot be modified after the event is created. Possible values are:
+      # - "birthday" - A special all-day event with an annual recurrence.
       # - "default" - A regular event or not further specified.
-      # - "outOfOffice" - An out-of-office event.
       # - "focusTime" - A focus-time event.
-      # - "workingLocation" - A working location event.
       # - "fromGmail" - An event from Gmail. This type of event cannot be created.
+      # - "outOfOffice" - An out-of-office event.
+      # - "workingLocation" - A working location event.
   "extendedProperties": { # Extended properties of the event.
     "private": { # Properties that are private to the copy of the event that appears on this calendar.
       "a_key": "A String", # The name of the private property and the corresponding value.
@@ -3132,11 +3142,12 @@ Method Details
   "endTimeUnspecified": false, # Whether the end time is actually unspecified. An end time is still provided for compatibility reasons, even if this attribute is set to True. The default is False.
   "etag": "A String", # ETag of the resource.
   "eventType": "default", # Specific type of the event. This cannot be modified after the event is created. Possible values are:
+      # - "birthday" - A special all-day event with an annual recurrence.
       # - "default" - A regular event or not further specified.
-      # - "outOfOffice" - An out-of-office event.
       # - "focusTime" - A focus-time event.
-      # - "workingLocation" - A working location event.
       # - "fromGmail" - An event from Gmail. This type of event cannot be created.
+      # - "outOfOffice" - An out-of-office event.
+      # - "workingLocation" - A working location event.
   "extendedProperties": { # Extended properties of the event.
     "private": { # Properties that are private to the copy of the event that appears on this calendar.
       "a_key": "A String", # The name of the private property and the corresponding value.
@@ -3437,11 +3448,12 @@ Method Details
   "endTimeUnspecified": false, # Whether the end time is actually unspecified. An end time is still provided for compatibility reasons, even if this attribute is set to True. The default is False.
   "etag": "A String", # ETag of the resource.
   "eventType": "default", # Specific type of the event. This cannot be modified after the event is created. Possible values are:
+      # - "birthday" - A special all-day event with an annual recurrence.
       # - "default" - A regular event or not further specified.
-      # - "outOfOffice" - An out-of-office event.
       # - "focusTime" - A focus-time event.
-      # - "workingLocation" - A working location event.
       # - "fromGmail" - An event from Gmail. This type of event cannot be created.
+      # - "outOfOffice" - An out-of-office event.
+      # - "workingLocation" - A working location event.
   "extendedProperties": { # Extended properties of the event.
     "private": { # Properties that are private to the copy of the event that appears on this calendar.
       "a_key": "A String", # The name of the private property and the corresponding value.
@@ -3733,11 +3745,12 @@ Method Details
   "endTimeUnspecified": false, # Whether the end time is actually unspecified. An end time is still provided for compatibility reasons, even if this attribute is set to True. The default is False.
   "etag": "A String", # ETag of the resource.
   "eventType": "default", # Specific type of the event. This cannot be modified after the event is created. Possible values are:
+      # - "birthday" - A special all-day event with an annual recurrence.
       # - "default" - A regular event or not further specified.
-      # - "outOfOffice" - An out-of-office event.
       # - "focusTime" - A focus-time event.
-      # - "workingLocation" - A working location event.
       # - "fromGmail" - An event from Gmail. This type of event cannot be created.
+      # - "outOfOffice" - An out-of-office event.
+      # - "workingLocation" - A working location event.
   "extendedProperties": { # Extended properties of the event.
     "private": { # Properties that are private to the copy of the event that appears on this calendar.
       "a_key": "A String", # The name of the private property and the corresponding value.
@@ -4034,11 +4047,12 @@ Method Details
   "endTimeUnspecified": false, # Whether the end time is actually unspecified. An end time is still provided for compatibility reasons, even if this attribute is set to True. The default is False.
   "etag": "A String", # ETag of the resource.
   "eventType": "default", # Specific type of the event. This cannot be modified after the event is created. Possible values are:
+      # - "birthday" - A special all-day event with an annual recurrence.
       # - "default" - A regular event or not further specified.
-      # - "outOfOffice" - An out-of-office event.
       # - "focusTime" - A focus-time event.
-      # - "workingLocation" - A working location event.
       # - "fromGmail" - An event from Gmail. This type of event cannot be created.
+      # - "outOfOffice" - An out-of-office event.
+      # - "workingLocation" - A working location event.
   "extendedProperties": { # Extended properties of the event.
     "private": { # Properties that are private to the copy of the event that appears on this calendar.
       "a_key": "A String", # The name of the private property and the corresponding value.
@@ -4193,6 +4207,7 @@ Method Details
   alwaysIncludeEmail: boolean, Deprecated and ignored.
   eventTypes: string, Event types to return. Optional. This parameter can be repeated multiple times to return events of different types. If unset, returns all event types. (repeated)
     Allowed values
+      birthday - Special all-day events with an annual recurrence.
       default - Regular events.
       focusTime - Focus time events.
       fromGmail - Events from Gmail.
diff --git a/docs/dyn/classroom_v1.courses.announcements.addOnAttachments.html b/docs/dyn/classroom_v1.courses.announcements.addOnAttachments.html
index d047d52a7e7..61e41cf317a 100644
--- a/docs/dyn/classroom_v1.courses.announcements.addOnAttachments.html
+++ b/docs/dyn/classroom_v1.courses.announcements.addOnAttachments.html
@@ -107,7 +107,7 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -116,8 +116,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -133,23 +133,23 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
 }
 
   addOnToken: string, Optional. Token that authorizes the request. The token is passed as a query parameter when the user is redirected from Classroom to the add-on's URL. This authorization token is required for in-Classroom attachment creation but optional for partner-first attachment creation. Returns an error if not provided for partner-first attachment creation and the developer projects that created the attachment and its parent stream item do not match.
-  postId: string, Optional. Deprecated, use item_id instead.
+  postId: string, Optional. Deprecated, use `item_id` instead.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -163,8 +163,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -180,16 +180,16 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
@@ -202,9 +202,9 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
   attachmentId: string, Required. Identifier of the attachment. (required)
-  postId: string, Optional. Deprecated, use item_id instead.
+  postId: string, Optional. Deprecated, use `item_id` instead.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -223,9 +223,9 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
   attachmentId: string, Required. Identifier of the attachment. (required)
-  postId: string, Optional. Deprecated, use item_id instead.
+  postId: string, Optional. Deprecated, use `item_id` instead.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -239,8 +239,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -256,16 +256,16 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
@@ -278,10 +278,10 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id. (required)
   pageSize: integer, The maximum number of attachments to return. The service may return fewer than this value. If unspecified, at most 20 attachments will be returned. The maximum value is 20; values above 20 will be coerced to 20.
   pageToken: string, A page token, received from a previous `ListAddOnAttachments` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListAddOnAttachments` must match the call that provided the page token.
-  postId: string, Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use item_id instead.
+  postId: string, Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use `item_id` instead.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -297,8 +297,8 @@ Method Details
         { # Identifier of a previous copy of a given attachment.
           "attachmentId": "A String", # Immutable. Identifier of the attachment.
           "courseId": "A String", # Immutable. Identifier of the course.
-          "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-          "postId": "A String", # Immutable. Deprecated, use item_id instead.
+          "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+          "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
         },
       ],
       "courseId": "A String", # Immutable. Identifier of the course.
@@ -314,16 +314,16 @@ Method Details
         "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
       },
       "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
       "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
-      "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+      "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
         "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
       },
-      "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+      "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
         "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
       },
-      "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+      "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
         "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
       },
       "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
@@ -363,8 +363,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -380,16 +380,16 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
@@ -410,8 +410,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -427,16 +427,16 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
diff --git a/docs/dyn/classroom_v1.courses.announcements.html b/docs/dyn/classroom_v1.courses.announcements.html
index a2858be0b3d..59de49dde1f 100644
--- a/docs/dyn/classroom_v1.courses.announcements.html
+++ b/docs/dyn/classroom_v1.courses.announcements.html
@@ -315,10 +315,10 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
   addOnToken: string, Optional. Token that authorizes the request. The token is passed as a query parameter when the user is redirected from Classroom to the add-on's URL. The authorization token is required when neither of the following is true: * The add-on has attachments on the post. * The developer project issuing the request is the same project that created the post.
   attachmentId: string, Optional. The identifier of the attachment. This field is required for all requests except when the user is in the [Attachment Discovery iframe](https://developers.google.com/classroom/add-ons/get-started/iframes/attachment-discovery-iframe).
-  postId: string, Optional. Deprecated, use item_id instead.
+  postId: string, Optional. Deprecated, use `item_id` instead.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -329,8 +329,8 @@ Method Details
 
     { # Attachment-relevant metadata for Classroom add-ons in the context of a specific post.
   "courseId": "A String", # Immutable. Identifier of the course.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
   "studentContext": { # Role-specific context if the requesting user is a student. # Add-on context corresponding to the requesting user's role as a student. Its presence implies that the requesting user is a student in the course.
     "submissionId": "A String", # Requesting user's submission id to be used for grade passback and to identify the student when showing student work to the teacher. This is set exactly when `supportsStudentWork` is `true`.
   },
diff --git a/docs/dyn/classroom_v1.courses.courseWork.addOnAttachments.html b/docs/dyn/classroom_v1.courses.courseWork.addOnAttachments.html
index ad517ba30b1..788267e9fcf 100644
--- a/docs/dyn/classroom_v1.courses.courseWork.addOnAttachments.html
+++ b/docs/dyn/classroom_v1.courses.courseWork.addOnAttachments.html
@@ -112,7 +112,7 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -121,8 +121,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -138,23 +138,23 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
 }
 
   addOnToken: string, Optional. Token that authorizes the request. The token is passed as a query parameter when the user is redirected from Classroom to the add-on's URL. This authorization token is required for in-Classroom attachment creation but optional for partner-first attachment creation. Returns an error if not provided for partner-first attachment creation and the developer projects that created the attachment and its parent stream item do not match.
-  postId: string, Optional. Deprecated, use item_id instead.
+  postId: string, Optional. Deprecated, use `item_id` instead.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -168,8 +168,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -185,16 +185,16 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
@@ -207,9 +207,9 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
   attachmentId: string, Required. Identifier of the attachment. (required)
-  postId: string, Optional. Deprecated, use item_id instead.
+  postId: string, Optional. Deprecated, use `item_id` instead.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -228,9 +228,9 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
   attachmentId: string, Required. Identifier of the attachment. (required)
-  postId: string, Optional. Deprecated, use item_id instead.
+  postId: string, Optional. Deprecated, use `item_id` instead.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -244,8 +244,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -261,16 +261,16 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
@@ -283,10 +283,10 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id. (required)
   pageSize: integer, The maximum number of attachments to return. The service may return fewer than this value. If unspecified, at most 20 attachments will be returned. The maximum value is 20; values above 20 will be coerced to 20.
   pageToken: string, A page token, received from a previous `ListAddOnAttachments` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListAddOnAttachments` must match the call that provided the page token.
-  postId: string, Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use item_id instead.
+  postId: string, Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use `item_id` instead.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -302,8 +302,8 @@ Method Details
         { # Identifier of a previous copy of a given attachment.
           "attachmentId": "A String", # Immutable. Identifier of the attachment.
           "courseId": "A String", # Immutable. Identifier of the course.
-          "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-          "postId": "A String", # Immutable. Deprecated, use item_id instead.
+          "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+          "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
         },
       ],
       "courseId": "A String", # Immutable. Identifier of the course.
@@ -319,16 +319,16 @@ Method Details
         "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
       },
       "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
       "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
-      "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+      "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
         "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
       },
-      "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+      "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
         "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
       },
-      "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+      "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
         "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
       },
       "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
@@ -368,8 +368,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -385,16 +385,16 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
@@ -415,8 +415,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -432,16 +432,16 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
diff --git a/docs/dyn/classroom_v1.courses.courseWork.addOnAttachments.studentSubmissions.html b/docs/dyn/classroom_v1.courses.courseWork.addOnAttachments.studentSubmissions.html
index 9ba10acb2d3..e5888bb76f7 100644
--- a/docs/dyn/classroom_v1.courses.courseWork.addOnAttachments.studentSubmissions.html
+++ b/docs/dyn/classroom_v1.courses.courseWork.addOnAttachments.studentSubmissions.html
@@ -95,10 +95,10 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
   attachmentId: string, Required. Identifier of the attachment. (required)
   submissionId: string, Required. Identifier of the student’s submission. (required)
-  postId: string, Optional. Deprecated, use item_id instead.
+  postId: string, Optional. Deprecated, use `item_id` instead.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -119,7 +119,7 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
   attachmentId: string, Required. Identifier of the attachment. (required)
   submissionId: string, Required. Identifier of the student's submission. (required)
   body: object, The request body.
@@ -130,7 +130,7 @@ Method Details
   "postSubmissionState": "A String", # Submission state of add-on attachment's parent post (i.e. assignment).
 }
 
-  postId: string, Optional. Deprecated, use item_id instead.
+  postId: string, Optional. Deprecated, use `item_id` instead.
   updateMask: string, Required. Mask that identifies which fields on the attachment to update. The update fails if invalid fields are specified. If a field supports empty values, it can be cleared by specifying it in the update mask and not in the `AddOnAttachmentStudentSubmission` object. The following fields may be specified by teachers: * `points_earned`
   x__xgafv: string, V1 error format.
     Allowed values
diff --git a/docs/dyn/classroom_v1.courses.courseWork.html b/docs/dyn/classroom_v1.courses.courseWork.html
index cb566efb8b4..09cbfa36766 100644
--- a/docs/dyn/classroom_v1.courses.courseWork.html
+++ b/docs/dyn/classroom_v1.courses.courseWork.html
@@ -425,10 +425,10 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
   addOnToken: string, Optional. Token that authorizes the request. The token is passed as a query parameter when the user is redirected from Classroom to the add-on's URL. The authorization token is required when neither of the following is true: * The add-on has attachments on the post. * The developer project issuing the request is the same project that created the post.
   attachmentId: string, Optional. The identifier of the attachment. This field is required for all requests except when the user is in the [Attachment Discovery iframe](https://developers.google.com/classroom/add-ons/get-started/iframes/attachment-discovery-iframe).
-  postId: string, Optional. Deprecated, use item_id instead.
+  postId: string, Optional. Deprecated, use `item_id` instead.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -439,8 +439,8 @@ Method Details
 
     { # Attachment-relevant metadata for Classroom add-ons in the context of a specific post.
   "courseId": "A String", # Immutable. Identifier of the course.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
   "studentContext": { # Role-specific context if the requesting user is a student. # Add-on context corresponding to the requesting user's role as a student. Its presence implies that the requesting user is a student in the course.
     "submissionId": "A String", # Requesting user's submission id to be used for grade passback and to identify the student when showing student work to the teacher. This is set exactly when `supportsStudentWork` is `true`.
   },
diff --git a/docs/dyn/classroom_v1.courses.courseWorkMaterials.addOnAttachments.html b/docs/dyn/classroom_v1.courses.courseWorkMaterials.addOnAttachments.html
index cb6b1f5efdc..21d6b0edc51 100644
--- a/docs/dyn/classroom_v1.courses.courseWorkMaterials.addOnAttachments.html
+++ b/docs/dyn/classroom_v1.courses.courseWorkMaterials.addOnAttachments.html
@@ -107,7 +107,7 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -116,8 +116,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -133,23 +133,23 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
 }
 
   addOnToken: string, Optional. Token that authorizes the request. The token is passed as a query parameter when the user is redirected from Classroom to the add-on's URL. This authorization token is required for in-Classroom attachment creation but optional for partner-first attachment creation. Returns an error if not provided for partner-first attachment creation and the developer projects that created the attachment and its parent stream item do not match.
-  postId: string, Optional. Deprecated, use item_id instead.
+  postId: string, Optional. Deprecated, use `item_id` instead.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -163,8 +163,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -180,16 +180,16 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
@@ -202,9 +202,9 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
   attachmentId: string, Required. Identifier of the attachment. (required)
-  postId: string, Optional. Deprecated, use item_id instead.
+  postId: string, Optional. Deprecated, use `item_id` instead.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -223,9 +223,9 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
   attachmentId: string, Required. Identifier of the attachment. (required)
-  postId: string, Optional. Deprecated, use item_id instead.
+  postId: string, Optional. Deprecated, use `item_id` instead.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -239,8 +239,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -256,16 +256,16 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
@@ -278,10 +278,10 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id. (required)
   pageSize: integer, The maximum number of attachments to return. The service may return fewer than this value. If unspecified, at most 20 attachments will be returned. The maximum value is 20; values above 20 will be coerced to 20.
   pageToken: string, A page token, received from a previous `ListAddOnAttachments` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListAddOnAttachments` must match the call that provided the page token.
-  postId: string, Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use item_id instead.
+  postId: string, Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use `item_id` instead.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -297,8 +297,8 @@ Method Details
         { # Identifier of a previous copy of a given attachment.
           "attachmentId": "A String", # Immutable. Identifier of the attachment.
           "courseId": "A String", # Immutable. Identifier of the course.
-          "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-          "postId": "A String", # Immutable. Deprecated, use item_id instead.
+          "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+          "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
         },
       ],
       "courseId": "A String", # Immutable. Identifier of the course.
@@ -314,16 +314,16 @@ Method Details
         "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
       },
       "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
       "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
-      "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+      "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
         "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
       },
-      "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+      "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
         "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
       },
-      "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+      "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
         "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
       },
       "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
@@ -363,8 +363,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -380,16 +380,16 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
@@ -410,8 +410,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -427,16 +427,16 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
diff --git a/docs/dyn/classroom_v1.courses.courseWorkMaterials.html b/docs/dyn/classroom_v1.courses.courseWorkMaterials.html
index db4cef97d3e..1ba32c4b977 100644
--- a/docs/dyn/classroom_v1.courses.courseWorkMaterials.html
+++ b/docs/dyn/classroom_v1.courses.courseWorkMaterials.html
@@ -318,10 +318,10 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id. (required)
   addOnToken: string, Optional. Token that authorizes the request. The token is passed as a query parameter when the user is redirected from Classroom to the add-on's URL. The authorization token is required when neither of the following is true: * The add-on has attachments on the post. * The developer project issuing the request is the same project that created the post.
   attachmentId: string, Optional. The identifier of the attachment. This field is required for all requests except when the user is in the [Attachment Discovery iframe](https://developers.google.com/classroom/add-ons/get-started/iframes/attachment-discovery-iframe).
-  postId: string, Optional. Deprecated, use item_id instead.
+  postId: string, Optional. Deprecated, use `item_id` instead.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -332,8 +332,8 @@ Method Details
 
     { # Attachment-relevant metadata for Classroom add-ons in the context of a specific post.
   "courseId": "A String", # Immutable. Identifier of the course.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
   "studentContext": { # Role-specific context if the requesting user is a student. # Add-on context corresponding to the requesting user's role as a student. Its presence implies that the requesting user is a student in the course.
     "submissionId": "A String", # Requesting user's submission id to be used for grade passback and to identify the student when showing student work to the teacher. This is set exactly when `supportsStudentWork` is `true`.
   },
diff --git a/docs/dyn/classroom_v1.courses.posts.addOnAttachments.html b/docs/dyn/classroom_v1.courses.posts.addOnAttachments.html
index 96aaffccbc9..5991cac0844 100644
--- a/docs/dyn/classroom_v1.courses.posts.addOnAttachments.html
+++ b/docs/dyn/classroom_v1.courses.posts.addOnAttachments.html
@@ -112,7 +112,7 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  postId: string, Optional. Deprecated, use item_id instead. (required)
+  postId: string, Optional. Deprecated, use `item_id` instead. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -121,8 +121,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -138,23 +138,23 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
 }
 
   addOnToken: string, Optional. Token that authorizes the request. The token is passed as a query parameter when the user is redirected from Classroom to the add-on's URL. This authorization token is required for in-Classroom attachment creation but optional for partner-first attachment creation. Returns an error if not provided for partner-first attachment creation and the developer projects that created the attachment and its parent stream item do not match.
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -168,8 +168,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -185,16 +185,16 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
@@ -207,9 +207,9 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  postId: string, Optional. Deprecated, use item_id instead. (required)
+  postId: string, Optional. Deprecated, use `item_id` instead. (required)
   attachmentId: string, Required. Identifier of the attachment. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -228,9 +228,9 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  postId: string, Optional. Deprecated, use item_id instead. (required)
+  postId: string, Optional. Deprecated, use `item_id` instead. (required)
   attachmentId: string, Required. Identifier of the attachment. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -244,8 +244,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -261,16 +261,16 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
@@ -283,8 +283,8 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  postId: string, Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use item_id instead. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.
+  postId: string, Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use `item_id` instead. (required)
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.
   pageSize: integer, The maximum number of attachments to return. The service may return fewer than this value. If unspecified, at most 20 attachments will be returned. The maximum value is 20; values above 20 will be coerced to 20.
   pageToken: string, A page token, received from a previous `ListAddOnAttachments` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListAddOnAttachments` must match the call that provided the page token.
   x__xgafv: string, V1 error format.
@@ -302,8 +302,8 @@ Method Details
         { # Identifier of a previous copy of a given attachment.
           "attachmentId": "A String", # Immutable. Identifier of the attachment.
           "courseId": "A String", # Immutable. Identifier of the course.
-          "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-          "postId": "A String", # Immutable. Deprecated, use item_id instead.
+          "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+          "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
         },
       ],
       "courseId": "A String", # Immutable. Identifier of the course.
@@ -319,16 +319,16 @@ Method Details
         "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
       },
       "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
       "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
-      "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+      "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
         "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
       },
-      "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+      "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
         "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
       },
-      "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+      "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
         "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
       },
       "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
@@ -368,8 +368,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -385,16 +385,16 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
@@ -415,8 +415,8 @@ Method Details
     { # Identifier of a previous copy of a given attachment.
       "attachmentId": "A String", # Immutable. Identifier of the attachment.
       "courseId": "A String", # Immutable. Identifier of the course.
-      "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-      "postId": "A String", # Immutable. Deprecated, use item_id instead.
+      "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+      "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
     },
   ],
   "courseId": "A String", # Immutable. Identifier of the course.
@@ -432,16 +432,16 @@ Method Details
     "seconds": 42, # Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.
   },
   "id": "A String", # Immutable. Classroom-assigned identifier for this attachment, unique per post.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.
   "maxPoints": 3.14, # Maximum grade for this attachment. Can only be set if `studentWorkReviewUri` is set. Set to a non-zero value to indicate that the attachment supports grade passback. If set, this must be a non-negative integer value. When set to zero, the attachment will not support grade passback.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
-  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
+  "studentViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
+  "studentWorkReviewUri": { # URI to be iframed after being populated with query parameters. # URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
-  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set.
+  "teacherViewUri": { # URI to be iframed after being populated with query parameters. # Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set.
     "uri": "A String", # Required. URI to be iframed after being populated with query parameters. This must be a valid UTF-8 string containing between 1 and 1800 characters.
   },
   "title": "A String", # Required. Title of this attachment. The title must be between 1 and 1000 characters.
diff --git a/docs/dyn/classroom_v1.courses.posts.addOnAttachments.studentSubmissions.html b/docs/dyn/classroom_v1.courses.posts.addOnAttachments.studentSubmissions.html
index c9ed0d639bf..96d57edc980 100644
--- a/docs/dyn/classroom_v1.courses.posts.addOnAttachments.studentSubmissions.html
+++ b/docs/dyn/classroom_v1.courses.posts.addOnAttachments.studentSubmissions.html
@@ -95,10 +95,10 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  postId: string, Optional. Deprecated, use item_id instead. (required)
+  postId: string, Optional. Deprecated, use `item_id` instead. (required)
   attachmentId: string, Required. Identifier of the attachment. (required)
   submissionId: string, Required. Identifier of the student’s submission. (required)
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -119,7 +119,7 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  postId: string, Optional. Deprecated, use item_id instead. (required)
+  postId: string, Optional. Deprecated, use `item_id` instead. (required)
   attachmentId: string, Required. Identifier of the attachment. (required)
   submissionId: string, Required. Identifier of the student's submission. (required)
   body: object, The request body.
@@ -130,7 +130,7 @@ Method Details
   "postSubmissionState": "A String", # Submission state of add-on attachment's parent post (i.e. assignment).
 }
 
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.
   updateMask: string, Required. Mask that identifies which fields on the attachment to update. The update fails if invalid fields are specified. If a field supports empty values, it can be cleared by specifying it in the update mask and not in the `AddOnAttachmentStudentSubmission` object. The following fields may be specified by teachers: * `points_earned`
   x__xgafv: string, V1 error format.
     Allowed values
diff --git a/docs/dyn/classroom_v1.courses.posts.html b/docs/dyn/classroom_v1.courses.posts.html
index 69854c1fe07..7696060f821 100644
--- a/docs/dyn/classroom_v1.courses.posts.html
+++ b/docs/dyn/classroom_v1.courses.posts.html
@@ -97,10 +97,10 @@ Method Details
 
 Args:
   courseId: string, Required. Identifier of the course. (required)
-  postId: string, Optional. Deprecated, use item_id instead. (required)
+  postId: string, Optional. Deprecated, use `item_id` instead. (required)
   addOnToken: string, Optional. Token that authorizes the request. The token is passed as a query parameter when the user is redirected from Classroom to the add-on's URL. The authorization token is required when neither of the following is true: * The add-on has attachments on the post. * The developer project issuing the request is the same project that created the post.
   attachmentId: string, Optional. The identifier of the attachment. This field is required for all requests except when the user is in the [Attachment Discovery iframe](https://developers.google.com/classroom/add-ons/get-started/iframes/attachment-discovery-iframe).
-  itemId: string, Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.
+  itemId: string, Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -111,8 +111,8 @@ Method Details
 
     { # Attachment-relevant metadata for Classroom add-ons in the context of a specific post.
   "courseId": "A String", # Immutable. Identifier of the course.
-  "itemId": "A String", # Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.
-  "postId": "A String", # Immutable. Deprecated, use item_id instead.
+  "itemId": "A String", # Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.
+  "postId": "A String", # Immutable. Deprecated, use `item_id` instead.
   "studentContext": { # Role-specific context if the requesting user is a student. # Add-on context corresponding to the requesting user's role as a student. Its presence implies that the requesting user is a student in the course.
     "submissionId": "A String", # Requesting user's submission id to be used for grade passback and to identify the student when showing student work to the teacher. This is set exactly when `supportsStudentWork` is `true`.
   },
diff --git a/docs/dyn/cloudbilling_v1beta.billingAccounts.html b/docs/dyn/cloudbilling_v1beta.billingAccounts.html
index 2a82bea9c08..09190cb1349 100644
--- a/docs/dyn/cloudbilling_v1beta.billingAccounts.html
+++ b/docs/dyn/cloudbilling_v1beta.billingAccounts.html
@@ -233,7 +233,7 @@ Method Details
             },
           },
         },
-        "cloudStorageEgressWorkload": { # Specification of a network type. Network data transfer within Google Cloud applies when you move or copy data from one Cloud Storage bucket to another or when another Google Cloud service accesses data in your Cloud Storage bucket.This includes the network data transfer within Google Cloud and the general network usage. # Usage on Cloud Storage Data Transfer.
+        "cloudStorageEgressWorkload": { # Specification of a network type. Network data transfer within Google Cloud applies when you move or copy data from one Cloud Storage bucket to another or when another Google Cloud service accesses data in your Cloud Storage bucket.This includes the network data transfer within Google Cloud and the general network usage. * If transferring data between two regions, the source and destination fields are set to different values. For example: `source_continent` = "SOURCE_CONTINENT_ASIA_PACIFIC", `destination_continent` = "SOURCE_CONTINENT_SOUTH_AMERICA". * If transferring data within one region, the source and destination fields are set to the same value. For example: `source_continent` = "SOURCE_CONTINENT_ASIA_PACIFIC", `destination_continent` = "SOURCE_CONTINENT_ASIA_PACIFIC". Some examples for the Network data transfer traffic type on the pricing page. * Data moves between different locations on the same continent. `source_continent` = "SOURCE_CONTINENT_ASIA_PACIFIC", `destination_continent` = "SOURCE_CONTINENT_ASIA_PACIFIC". * Data moves between different continents and neither is Australia. `source_continent` = "SOURCE_CONTINENT_NORTH_AMERICA", `destination_continent` = "SOURCE_CONTINENT_ASIA_PACIFIC". * Data moves between different continents and one is Australia. `source_continent` = "SOURCE_CONTINENT_NORTH_AMERICA", `destination_continent` = "SOURCE_CONTINENT_AUSTRALIA". # Usage on Cloud Storage Data Transfer.
           "destinationContinent": "A String", # Where the data is sent to.
           "egressRate": { # An amount of usage over a time frame. # Data transfer usage rate. This usage applies when you move or copy data from one Cloud Storage bucket to another or when another Google Cloud service accesses data in your Cloud Storage bucket. The expected units are GiBy/s, By/s, and so on, based on [The Unified Code for Units of Measure](https://ucum.org/ucum.html) standard.
             "usageRateTimeline": { # A timeline of usage rates. Consists of a series of entries, each of which specifies a constant rate of usage during a time interval. Each entry contains an effective time. The usage rate is in effect from that time until the effective time of the subsequent entry, or, for the last entry, for the remaining portion of estimation time frame. Effective times are specified as an offset into the estimation time frame. Usage is considered to be zero until the `effective_time` of the first entry. All subsequent entries must have an effective time greater than the previous entry and less than the estimate time frame. The effective time on all entries must be an integer number of hours. # A timeline of usage rates over the estimate interval.
diff --git a/docs/dyn/cloudbilling_v1beta.v1beta.html b/docs/dyn/cloudbilling_v1beta.v1beta.html
index ab4a3a3b074..13c6dec0903 100644
--- a/docs/dyn/cloudbilling_v1beta.v1beta.html
+++ b/docs/dyn/cloudbilling_v1beta.v1beta.html
@@ -217,7 +217,7 @@ Method Details
             },
           },
         },
-        "cloudStorageEgressWorkload": { # Specification of a network type. Network data transfer within Google Cloud applies when you move or copy data from one Cloud Storage bucket to another or when another Google Cloud service accesses data in your Cloud Storage bucket.This includes the network data transfer within Google Cloud and the general network usage. # Usage on Cloud Storage Data Transfer.
+        "cloudStorageEgressWorkload": { # Specification of a network type. Network data transfer within Google Cloud applies when you move or copy data from one Cloud Storage bucket to another or when another Google Cloud service accesses data in your Cloud Storage bucket.This includes the network data transfer within Google Cloud and the general network usage. * If transferring data between two regions, the source and destination fields are set to different values. For example: `source_continent` = "SOURCE_CONTINENT_ASIA_PACIFIC", `destination_continent` = "SOURCE_CONTINENT_SOUTH_AMERICA". * If transferring data within one region, the source and destination fields are set to the same value. For example: `source_continent` = "SOURCE_CONTINENT_ASIA_PACIFIC", `destination_continent` = "SOURCE_CONTINENT_ASIA_PACIFIC". Some examples for the Network data transfer traffic type on the pricing page. * Data moves between different locations on the same continent. `source_continent` = "SOURCE_CONTINENT_ASIA_PACIFIC", `destination_continent` = "SOURCE_CONTINENT_ASIA_PACIFIC". * Data moves between different continents and neither is Australia. `source_continent` = "SOURCE_CONTINENT_NORTH_AMERICA", `destination_continent` = "SOURCE_CONTINENT_ASIA_PACIFIC". * Data moves between different continents and one is Australia. `source_continent` = "SOURCE_CONTINENT_NORTH_AMERICA", `destination_continent` = "SOURCE_CONTINENT_AUSTRALIA". # Usage on Cloud Storage Data Transfer.
           "destinationContinent": "A String", # Where the data is sent to.
           "egressRate": { # An amount of usage over a time frame. # Data transfer usage rate. This usage applies when you move or copy data from one Cloud Storage bucket to another or when another Google Cloud service accesses data in your Cloud Storage bucket. The expected units are GiBy/s, By/s, and so on, based on [The Unified Code for Units of Measure](https://ucum.org/ucum.html) standard.
             "usageRateTimeline": { # A timeline of usage rates. Consists of a series of entries, each of which specifies a constant rate of usage during a time interval. Each entry contains an effective time. The usage rate is in effect from that time until the effective time of the subsequent entry, or, for the last entry, for the remaining portion of estimation time frame. Effective times are specified as an offset into the estimation time frame. Usage is considered to be zero until the `effective_time` of the first entry. All subsequent entries must have an effective time greater than the previous entry and less than the estimate time frame. The effective time on all entries must be an integer number of hours. # A timeline of usage rates over the estimate interval.
diff --git a/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.html b/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.html
index ba4df357799..934ce853636 100644
--- a/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.html
+++ b/docs/dyn/cloudcontrolspartner_v1.organizations.locations.customers.html
@@ -122,7 +122,7 @@ Method Details
       },
     ],
   },
-  "displayName": "A String", # The customer organization's display name. E.g. "Google".
+  "displayName": "A String", # Required. Display name for the customer
   "isOnboarded": True or False, # Output only. Indicates whether a customer is fully onboarded
   "name": "A String", # Identifier. Format: `organizations/{organization}/locations/{location}/customers/{customer}`
 }
@@ -159,7 +159,7 @@ Method Details
           },
         ],
       },
-      "displayName": "A String", # The customer organization's display name. E.g. "Google".
+      "displayName": "A String", # Required. Display name for the customer
       "isOnboarded": True or False, # Output only. Indicates whether a customer is fully onboarded
       "name": "A String", # Identifier. Format: `organizations/{organization}/locations/{location}/customers/{customer}`
     },
diff --git a/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.html b/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.html
index 3639e34accc..05d06a649d3 100644
--- a/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.html
+++ b/docs/dyn/cloudcontrolspartner_v1beta.organizations.locations.customers.html
@@ -122,7 +122,7 @@ Method Details
       },
     ],
   },
-  "displayName": "A String", # The customer organization's display name. E.g. "Google".
+  "displayName": "A String", # Required. Display name for the customer
   "isOnboarded": True or False, # Output only. Indicates whether a customer is fully onboarded
   "name": "A String", # Identifier. Format: `organizations/{organization}/locations/{location}/customers/{customer}`
 }

@@ -159,7 +159,7 @@

Method Details

}, ], }, - "displayName": "A String", # The customer organization's display name. E.g. "Google". + "displayName": "A String", # Required. Display name for the customer "isOnboarded": True or False, # Output only. Indicates whether a customer is fully onboarded "name": "A String", # Identifier. Format: `organizations/{organization}/locations/{location}/customers/{customer}` }, diff --git a/docs/dyn/displayvideo_v2.advertisers.insertionOrders.html b/docs/dyn/displayvideo_v2.advertisers.insertionOrders.html index f5c8827f954..6d22fa91a2b 100644 --- a/docs/dyn/displayvideo_v2.advertisers.insertionOrders.html +++ b/docs/dyn/displayvideo_v2.advertisers.insertionOrders.html @@ -181,11 +181,11 @@

Method Details

"integrationCode": "A String", # An external identifier to be associated with the entry. The integration code will show up together with the entry in many places in the system, for example, reporting. Must be UTF-8 encoded with a length of no more than 500 characters. }, "name": "A String", # Output only. The resource name of the insertion order. - "pacing": { # Settings that control the rate at which a budget is spent. # Required. The budget spending speed setting of the insertion order. + "pacing": { # Settings that control the rate at which a budget is spent. # Required. The budget spending speed setting of the insertion order. *Warning*: Starting on **November 5, 2024**, pacing_type `PACING_TYPE_ASAP` will no longer be compatible with pacing_period `PACING_PERIOD_FLIGHT`. [Read more about this announced change](/display-video/api/deprecations#features.io_asap). "dailyMaxImpressions": "A String", # Maximum number of impressions to serve every day. Applicable when the budget is impression based. Must be greater than 0. "dailyMaxMicros": "A String", # Maximum currency amount to spend every day in micros of advertiser's currency. Applicable when the budget is currency based. Must be greater than 0. For example, for 1.5 standard unit of the currency, set this field to 1500000. The value assigned will be rounded to whole billable units for the relevant currency by the following rules: any positive value less than a single billable unit will be rounded up to one billable unit and any value larger than a single billable unit will be rounded down to the nearest billable value. For example, if the currency's billable unit is 0.01, and this field is set to 10257770, it will round down to 10250000, a value of 10.25. If set to 505, it will round up to 10000, a value of 0.01. "pacingPeriod": "A String", # Required. The time period in which the pacing budget will be spent. When automatic budget allocation is enabled at the insertion order via automationType, this field is output only and defaults to `PACING_PERIOD_FLIGHT`. - "pacingType": "A String", # Required. The type of pacing that defines how the budget amount will be spent across the pacing_period. + "pacingType": "A String", # Required. The type of pacing that defines how the budget amount will be spent across the pacing_period. *Warning*: Starting on **November 5, 2024**, `PACING_TYPE_ASAP` will no longer be compatible with pacing_period `PACING_PERIOD_FLIGHT` for insertion orders. [Read more about this announced change](/display-video/api/deprecations#features.io_asap). }, "partnerCosts": [ # The partner costs associated with the insertion order. If absent or empty in CreateInsertionOrder method, the newly created insertion order will inherit partner costs from the partner settings. { # Settings that control a partner cost. A partner cost is any type of expense involved in running a campaign, other than the costs of purchasing impressions (which is called the media cost) and using third-party audience segment data (data fee). Some examples of partner costs include the fees for using DV360, a third-party ad server, or a third-party ad serving verification service. @@ -274,11 +274,11 @@

Method Details

"dailyMaxImpressions": "A String", # Maximum number of impressions to serve every day. Applicable when the budget is impression based. Must be greater than 0. "dailyMaxMicros": "A String", # Maximum currency amount to spend every day in micros of advertiser's currency. Applicable when the budget is currency based. Must be greater than 0. For example, for 1.5 standard unit of the currency, set this field to 1500000. The value assigned will be rounded to whole billable units for the relevant currency by the following rules: any positive value less than a single billable unit will be rounded up to one billable unit and any value larger than a single billable unit will be rounded down to the nearest billable value. For example, if the currency's billable unit is 0.01, and this field is set to 10257770, it will round down to 10250000, a value of 10.25. If set to 505, it will round up to 10000, a value of 0.01. "pacingPeriod": "A String", # Required. The time period in which the pacing budget will be spent. When automatic budget allocation is enabled at the insertion order via automationType, this field is output only and defaults to `PACING_PERIOD_FLIGHT`. - "pacingType": "A String", # Required. The type of pacing that defines how the budget amount will be spent across the pacing_period. + "pacingType": "A String", # Required. The type of pacing that defines how the budget amount will be spent across the pacing_period. *Warning*: Starting on **November 5, 2024**, `PACING_TYPE_ASAP` will no longer be compatible with pacing_period `PACING_PERIOD_FLIGHT` for insertion orders. [Read more about this announced change](/display-video/api/deprecations#features.io_asap). }, "partnerCosts": [ # The partner costs associated with the line item. If absent or empty in CreateLineItem method, the newly created line item will inherit partner costs from its parent insertion order. { # Settings that control a partner cost. A partner cost is any type of expense involved in running a campaign, other than the costs of purchasing impressions (which is called the media cost) and using third-party audience segment data (data fee). Some examples of partner costs include the fees for using DV360, a third-party ad server, or a third-party ad serving verification service. @@ -1140,7 +1140,7 @@

Method Details

@@ -580,7 +580,7 @@

Method Details

"targetingExpansion": { # Settings that control the [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. # The [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the ad group. "audienceExpansionLevel": "A String", # Output only. Magnitude of expansion for eligible first-party user lists under this ad group. This field only applies to YouTube and Partners line item and ad group resources. "audienceExpansionSeedListExcluded": True or False, # Output only. Whether to exclude seed list for audience expansion. This field only applies to YouTube and Partners line item and ad group resources. - "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. + "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. *Warning*: Starting on **September 30, 2024**, optimized targeting will no longer be compatible with a subset of bid strategies. [Read more about this announced change](/display-video/api/deprecations#features.ot_bid_strategies). }, }, ], diff --git a/docs/dyn/displayvideo_v3.advertisers.insertionOrders.html b/docs/dyn/displayvideo_v3.advertisers.insertionOrders.html index 690982a3c38..662d55bf4aa 100644 --- a/docs/dyn/displayvideo_v3.advertisers.insertionOrders.html +++ b/docs/dyn/displayvideo_v3.advertisers.insertionOrders.html @@ -194,11 +194,11 @@

Method Details

}, "name": "A String", # Output only. The resource name of the insertion order. "optimizationObjective": "A String", # Optional. The optimization objective of the insertion order. **This field is only available to allowlisted customers.** If a customer is not allowlisted, this field will be null and attempts to set it will return an error. - "pacing": { # Settings that control the rate at which a budget is spent. # Required. The budget spending speed setting of the insertion order. + "pacing": { # Settings that control the rate at which a budget is spent. # Required. The budget spending speed setting of the insertion order. *Warning*: Starting on **November 5, 2024**, pacing_type `PACING_TYPE_ASAP` will no longer be compatible with pacing_period `PACING_PERIOD_FLIGHT`. [Read more about this announced change](/display-video/api/deprecations#features.io_asap). "dailyMaxImpressions": "A String", # Maximum number of impressions to serve every day. Applicable when the budget is impression based. Must be greater than 0. "dailyMaxMicros": "A String", # Maximum currency amount to spend every day in micros of advertiser's currency. Applicable when the budget is currency based. Must be greater than 0. For example, for 1.5 standard unit of the currency, set this field to 1500000. The value assigned will be rounded to whole billable units for the relevant currency by the following rules: any positive value less than a single billable unit will be rounded up to one billable unit and any value larger than a single billable unit will be rounded down to the nearest billable value. For example, if the currency's billable unit is 0.01, and this field is set to 10257770, it will round down to 10250000, a value of 10.25. If set to 505, it will round up to 10000, a value of 0.01. "pacingPeriod": "A String", # Required. The time period in which the pacing budget will be spent. When automatic budget allocation is enabled at the insertion order via automationType, this field is output only and defaults to `PACING_PERIOD_FLIGHT`. - "pacingType": "A String", # Required. The type of pacing that defines how the budget amount will be spent across the pacing_period. + "pacingType": "A String", # Required. The type of pacing that defines how the budget amount will be spent across the pacing_period. *Warning*: Starting on **November 5, 2024**, `PACING_TYPE_ASAP` will no longer be compatible with pacing_period `PACING_PERIOD_FLIGHT` for insertion orders. [Read more about this announced change](/display-video/api/deprecations#features.io_asap). }, "partnerCosts": [ # The partner costs associated with the insertion order. If absent or empty in CreateInsertionOrder method, the newly created insertion order will inherit partner costs from the partner settings. { # Settings that control a partner cost. A partner cost is any type of expense involved in running a campaign, other than the costs of purchasing impressions (which is called the media cost) and using third-party audience segment data (data fee). Some examples of partner costs include the fees for using DV360, a third-party ad server, or a third-party ad serving verification service. @@ -294,11 +294,11 @@

Method Details

"targetingExpansion": { # Settings that control the [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. # The [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. This config is only applicable for display, video, or audio line items that use automated bidding and positively target eligible audience lists. "audienceExpansionLevel": "A String", # Output only. Magnitude of expansion for eligible first-party user lists under this ad group. This field only applies to YouTube and Partners line item and ad group resources. "audienceExpansionSeedListExcluded": True or False, # Output only. Whether to exclude seed list for audience expansion. This field only applies to YouTube and Partners line item and ad group resources. - "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. + "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. *Warning*: Starting on **September 30, 2024**, optimized targeting will no longer be compatible with a subset of bid strategies. [Read more about this announced change](/display-video/api/deprecations#features.ot_bid_strategies). }, "updateTime": "A String", # Output only. The timestamp when the line item was last updated. Assigned by the system. "warningMessages": [ # Output only. The warning messages generated by the line item. These warnings do not block saving the line item, but some may block the line item from running. @@ -1146,7 +1146,7 @@

Method Details

"targetingExpansion": { # Settings that control the [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. # The [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. This config is only applicable for display, video, or audio line items that use automated bidding and positively target eligible audience lists. "audienceExpansionLevel": "A String", # Output only. Magnitude of expansion for eligible first-party user lists under this ad group. This field only applies to YouTube and Partners line item and ad group resources. "audienceExpansionSeedListExcluded": True or False, # Output only. Whether to exclude seed list for audience expansion. This field only applies to YouTube and Partners line item and ad group resources. - "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. + "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. *Warning*: Starting on **September 30, 2024**, optimized targeting will no longer be compatible with a subset of bid strategies. [Read more about this announced change](/display-video/api/deprecations#features.ot_bid_strategies). }, "updateTime": "A String", # Output only. The timestamp when the line item was last updated. Assigned by the system. "warningMessages": [ # Output only. The warning messages generated by the line item. These warnings do not block saving the line item, but some may block the line item from running. @@ -1331,7 +1331,7 @@

Method Details

"targetingExpansion": { # Settings that control the [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. # The [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. This config is only applicable for display, video, or audio line items that use automated bidding and positively target eligible audience lists. "audienceExpansionLevel": "A String", # Output only. Magnitude of expansion for eligible first-party user lists under this ad group. This field only applies to YouTube and Partners line item and ad group resources. "audienceExpansionSeedListExcluded": True or False, # Output only. Whether to exclude seed list for audience expansion. This field only applies to YouTube and Partners line item and ad group resources. - "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. + "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. *Warning*: Starting on **September 30, 2024**, optimized targeting will no longer be compatible with a subset of bid strategies. [Read more about this announced change](/display-video/api/deprecations#features.ot_bid_strategies). }, "updateTime": "A String", # Output only. The timestamp when the line item was last updated. Assigned by the system. "warningMessages": [ # Output only. The warning messages generated by the line item. These warnings do not block saving the line item, but some may block the line item from running. @@ -1584,7 +1584,7 @@

Method Details

"targetingExpansion": { # Settings that control the [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. # The [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. This config is only applicable for display, video, or audio line items that use automated bidding and positively target eligible audience lists. "audienceExpansionLevel": "A String", # Output only. Magnitude of expansion for eligible first-party user lists under this ad group. This field only applies to YouTube and Partners line item and ad group resources. "audienceExpansionSeedListExcluded": True or False, # Output only. Whether to exclude seed list for audience expansion. This field only applies to YouTube and Partners line item and ad group resources. - "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. + "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. *Warning*: Starting on **September 30, 2024**, optimized targeting will no longer be compatible with a subset of bid strategies. [Read more about this announced change](/display-video/api/deprecations#features.ot_bid_strategies). }, "updateTime": "A String", # Output only. The timestamp when the line item was last updated. Assigned by the system. "warningMessages": [ # Output only. The warning messages generated by the line item. These warnings do not block saving the line item, but some may block the line item from running. @@ -1777,7 +1777,7 @@

Method Details

"targetingExpansion": { # Settings that control the [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. # The [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. This config is only applicable for display, video, or audio line items that use automated bidding and positively target eligible audience lists. "audienceExpansionLevel": "A String", # Output only. Magnitude of expansion for eligible first-party user lists under this ad group. This field only applies to YouTube and Partners line item and ad group resources. "audienceExpansionSeedListExcluded": True or False, # Output only. Whether to exclude seed list for audience expansion. This field only applies to YouTube and Partners line item and ad group resources. - "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. + "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. *Warning*: Starting on **September 30, 2024**, optimized targeting will no longer be compatible with a subset of bid strategies. [Read more about this announced change](/display-video/api/deprecations#features.ot_bid_strategies). }, "updateTime": "A String", # Output only. The timestamp when the line item was last updated. Assigned by the system. "warningMessages": [ # Output only. The warning messages generated by the line item. These warnings do not block saving the line item, but some may block the line item from running. @@ -1975,7 +1975,7 @@

Method Details

"targetingExpansion": { # Settings that control the [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. # The [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. This config is only applicable for display, video, or audio line items that use automated bidding and positively target eligible audience lists. "audienceExpansionLevel": "A String", # Output only. Magnitude of expansion for eligible first-party user lists under this ad group. This field only applies to YouTube and Partners line item and ad group resources. "audienceExpansionSeedListExcluded": True or False, # Output only. Whether to exclude seed list for audience expansion. This field only applies to YouTube and Partners line item and ad group resources. - "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. + "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. *Warning*: Starting on **September 30, 2024**, optimized targeting will no longer be compatible with a subset of bid strategies. [Read more about this announced change](/display-video/api/deprecations#features.ot_bid_strategies). }, "updateTime": "A String", # Output only. The timestamp when the line item was last updated. Assigned by the system. "warningMessages": [ # Output only. The warning messages generated by the line item. These warnings do not block saving the line item, but some may block the line item from running. @@ -2180,7 +2180,7 @@

Method Details

"targetingExpansion": { # Settings that control the [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. # The [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. This config is only applicable for display, video, or audio line items that use automated bidding and positively target eligible audience lists. "audienceExpansionLevel": "A String", # Output only. Magnitude of expansion for eligible first-party user lists under this ad group. This field only applies to YouTube and Partners line item and ad group resources. "audienceExpansionSeedListExcluded": True or False, # Output only. Whether to exclude seed list for audience expansion. This field only applies to YouTube and Partners line item and ad group resources. - "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. + "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. *Warning*: Starting on **September 30, 2024**, optimized targeting will no longer be compatible with a subset of bid strategies. [Read more about this announced change](/display-video/api/deprecations#features.ot_bid_strategies). }, "updateTime": "A String", # Output only. The timestamp when the line item was last updated. Assigned by the system. "warningMessages": [ # Output only. The warning messages generated by the line item. These warnings do not block saving the line item, but some may block the line item from running. @@ -2366,7 +2366,7 @@

Method Details

"targetingExpansion": { # Settings that control the [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. # The [optimized targeting](//support.google.com/displayvideo/answer/12060859) settings of the line item. This config is only applicable for display, video, or audio line items that use automated bidding and positively target eligible audience lists. "audienceExpansionLevel": "A String", # Output only. Magnitude of expansion for eligible first-party user lists under this ad group. This field only applies to YouTube and Partners line item and ad group resources. "audienceExpansionSeedListExcluded": True or False, # Output only. Whether to exclude seed list for audience expansion. This field only applies to YouTube and Partners line item and ad group resources. - "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. + "enableOptimizedTargeting": True or False, # Required. Whether to enable Optimized Targeting for the line item. *Warning*: Starting on **September 30, 2024**, optimized targeting will no longer be compatible with a subset of bid strategies. [Read more about this announced change](/display-video/api/deprecations#features.ot_bid_strategies). }, "updateTime": "A String", # Output only. The timestamp when the line item was last updated. Assigned by the system. "warningMessages": [ # Output only. The warning messages generated by the line item. These warnings do not block saving the line item, but some may block the line item from running. diff --git a/docs/dyn/iap_v1.v1.html b/docs/dyn/iap_v1.v1.html index 964bedad3f5..2b97e4f0011 100644 --- a/docs/dyn/iap_v1.v1.html +++ b/docs/dyn/iap_v1.v1.html @@ -184,7 +184,7 @@

Method Details

"A String", ], }, - "policyDelegationSettings": { # PolicyDelegationConfig allows google-internal teams to use IAP for apps hosted in a tenant project. Using these settings, the app can delegate permission check to happen against the linked customer project. This is only ever supposed to be used by google internal teams, hence the restriction on the proto. # Optional. Settings to configure Policy delegation for apps hosted in tenant projects. INTERNAL_ONLY. + "policyDelegationSettings": { # PolicyDelegationConfig allows google-internal teams to use IAP for apps hosted in a tenant project. Using these settings, the app can delegate permission check to happen against the linked customer project. This is only ever supposed to be used by google internal teams, hence the restriction on the proto. # Optional. Settings to allow google-internal teams to use IAP for apps hosted in a tenant project. "iamPermission": "A String", # Permission to check in IAM. "iamServiceName": "A String", # The DNS name of the service (e.g. "resourcemanager.googleapis.com"). This should be the domain name part of the full resource names (see https://aip.dev/122#full-resource-names), which is usually the same as IamServiceSpec.service of the service where the resource type is defined. "policyName": { # An internal name for an IAM policy, based on the resource to which the policy applies. Not to be confused with a resource's external full resource name. For more information on this distinction, see go/iam-full-resource-names. # Policy name to be checked @@ -226,7 +226,7 @@

Method Details

}, "reauthSettings": { # Configuration for IAP reauthentication policies. # Optional. Settings to configure reauthentication policies in IAP. "maxAge": "A String", # Optional. Reauth session lifetime, how long before a user has to reauthenticate again. - "method": "A String", # Reauth method requested. + "method": "A String", # Optional. Reauth method requested. "policyType": "A String", # Optional. How IAP determines the effective policy in cases of hierarchical policies. Policies are merged from higher in the hierarchy to lower in the hierarchy. }, "workforceIdentitySettings": { # WorkforceIdentitySettings allows customers to configure workforce pools and OAuth 2.0 settings to gate their applications using a third-party IdP with access control. # Optional. Settings to configure the workforce identity federation, including workforce pools and OAuth 2.0 settings. @@ -385,7 +385,7 @@

Method Details

{ # The request message to annotate an Assessment. "accountId": "A String", # Optional. A stable account identifier to apply to the assessment. This is an alternative to setting `account_id` in `CreateAssessment`, for example when a stable account identifier is not yet known in the initial request. - "annotation": "A String", # Optional. The annotation that will be assigned to the Event. This field can be left empty to provide reasons that apply to an event without concluding whether the event is legitimate or fraudulent. + "annotation": "A String", # Optional. The annotation that is assigned to the Event. This field can be left empty to provide reasons that apply to an event without concluding whether the event is legitimate or fraudulent. "hashedAccountId": "A String", # Optional. A stable hashed account identifier to apply to the assessment. This is an alternative to setting `hashed_account_id` in `CreateAssessment`, for example when a stable account identifier is not yet known in the initial request. "reasons": [ # Optional. Reasons for the annotation that are assigned to the event. "A String", @@ -130,7 +130,7 @@

Method Details

Creates an Assessment of the likelihood an event is legitimate.
 
 Args:
-  parent: string, Required. The name of the project in which the assessment will be created, in the format `projects/{project}`. (required)
+  parent: string, Required. The name of the project in which the assessment is created, in the format `projects/{project}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -160,7 +160,7 @@ Method Details
   "event": { # The event being assessed. # Optional. The event being assessed.
     "expectedAction": "A String", # Optional. The expected action for this type of event. This should be the same action provided at token generation time on client-side platforms already integrated with recaptcha enterprise.
     "express": True or False, # Optional. Flag for a reCAPTCHA express request for an assessment without a token. If enabled, `site_key` must reference an Express site key.
-    "firewallPolicyEvaluation": True or False, # Optional. Flag for enabling firewall policy config assessment. If this flag is enabled, the firewall policy will be evaluated and a suggested firewall action will be returned in the response.
+    "firewallPolicyEvaluation": True or False, # Optional. Flag for enabling firewall policy config assessment. If this flag is enabled, the firewall policy is evaluated and a suggested firewall action is returned in the response.
     "fraudPrevention": "A String", # Optional. The Fraud Prevention setting for this assessment.
     "hashedAccountId": "A String", # Optional. Deprecated: use `user_info.account_id` instead. Unique stable hashed user identifier for the request. The identifier must be hashed using hmac-sha256 with stable secret.
     "headers": [ # Optional. HTTP header information about the request.
@@ -247,7 +247,7 @@ Method Details
     "wafTokenAssessment": True or False, # Optional. Flag for running WAF token assessment. If enabled, the token must be specified, and have been created by a WAF-enabled key.
   },
   "firewallPolicyAssessment": { # Policy config assessment. # Output only. Assessment returned when firewall policies belonging to the project are evaluated using the field firewall_policy_evaluation.
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. If the processing of a policy config fails, an error will be populated and the firewall_policy will be left empty.
+    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. If the processing of a policy config fails, an error is populated and the firewall_policy is left empty.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
         {
@@ -256,22 +256,22 @@ Method Details
       ],
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
     },
-    "firewallPolicy": { # A FirewallPolicy represents a single matching pattern and resulting actions to take. # Output only. The policy that matched the request. If more than one policy may match, this is the first match. If no policy matches the incoming request, the policy field will be left empty.
+    "firewallPolicy": { # A FirewallPolicy represents a single matching pattern and resulting actions to take. # Output only. The policy that matched the request. If more than one policy may match, this is the first match. If no policy matches the incoming request, the policy field is left empty.
       "actions": [ # Optional. The actions that the caller should take regarding user access. There should be at most one terminal action. A terminal action is any action that forces a response, such as `AllowAction`, `BlockAction` or `SubstituteAction`. Zero or more non-terminal actions such as `SetHeader` might be specified. A single policy can contain up to 16 actions.
         { # An individual action. Each action represents what to do if a policy matches.
           "allow": { # An allow action continues processing a request unimpeded. # The user request did not match any policy and should be allowed access to the requested resource.
           },
-          "block": { # A block action serves an HTTP error code a prevents the request from hitting the backend. # This action will deny access to a given page. The user will get an HTTP error code.
+          "block": { # A block action serves an HTTP error code a prevents the request from hitting the backend. # This action denies access to a given page. The user gets an HTTP error code.
           },
-          "includeRecaptchaScript": { # An include reCAPTCHA script action involves injecting reCAPTCHA JavaScript code into the HTML returned by the site backend. This reCAPTCHA script is tasked with collecting user signals on the requested web page, issuing tokens as a cookie within the site domain, and enabling their utilization in subsequent page requests. # This action will inject reCAPTCHA JavaScript code into the HTML page returned by the site backend.
+          "includeRecaptchaScript": { # An include reCAPTCHA script action involves injecting reCAPTCHA JavaScript code into the HTML returned by the site backend. This reCAPTCHA script is tasked with collecting user signals on the requested web page, issuing tokens as a cookie within the site domain, and enabling their utilization in subsequent page requests. # This action injects reCAPTCHA JavaScript code into the HTML page returned by the site backend.
           },
-          "redirect": { # A redirect action returns a 307 (temporary redirect) response, pointing the user to a ReCaptcha interstitial page to attach a token. # This action will redirect the request to a ReCaptcha interstitial to attach a token.
+          "redirect": { # A redirect action returns a 307 (temporary redirect) response, pointing the user to a reCAPTCHA interstitial page to attach a token. # This action redirects the request to a reCAPTCHA interstitial to attach a token.
           },
-          "setHeader": { # A set header action sets a header and forwards the request to the backend. This can be used to trigger custom protection implemented on the backend. # This action will set a custom header but allow the request to continue to the customer backend.
+          "setHeader": { # A set header action sets a header and forwards the request to the backend. This can be used to trigger custom protection implemented on the backend. # This action sets a custom header but allow the request to continue to the customer backend.
             "key": "A String", # Optional. The header key to set in the request to the backend server.
             "value": "A String", # Optional. The header value to set in the request to the backend server.
           },
-          "substitute": { # A substitute action transparently serves a different page than the one requested. # This action will transparently serve a different page to an offending user.
+          "substitute": { # A substitute action transparently serves a different page than the one requested. # This action transparently serves a different page to an offending user.
             "path": "A String", # Optional. The address to redirect to. The target is a relative path in the current host. Example: "/blog/404.html".
           },
         },
@@ -376,7 +376,7 @@ Method Details
   "event": { # The event being assessed. # Optional. The event being assessed.
     "expectedAction": "A String", # Optional. The expected action for this type of event. This should be the same action provided at token generation time on client-side platforms already integrated with recaptcha enterprise.
     "express": True or False, # Optional. Flag for a reCAPTCHA express request for an assessment without a token. If enabled, `site_key` must reference an Express site key.
-    "firewallPolicyEvaluation": True or False, # Optional. Flag for enabling firewall policy config assessment. If this flag is enabled, the firewall policy will be evaluated and a suggested firewall action will be returned in the response.
+    "firewallPolicyEvaluation": True or False, # Optional. Flag for enabling firewall policy config assessment. If this flag is enabled, the firewall policy is evaluated and a suggested firewall action is returned in the response.
     "fraudPrevention": "A String", # Optional. The Fraud Prevention setting for this assessment.
     "hashedAccountId": "A String", # Optional. Deprecated: use `user_info.account_id` instead. Unique stable hashed user identifier for the request. The identifier must be hashed using hmac-sha256 with stable secret.
     "headers": [ # Optional. HTTP header information about the request.
@@ -463,7 +463,7 @@ Method Details
     "wafTokenAssessment": True or False, # Optional. Flag for running WAF token assessment. If enabled, the token must be specified, and have been created by a WAF-enabled key.
   },
   "firewallPolicyAssessment": { # Policy config assessment. # Output only. Assessment returned when firewall policies belonging to the project are evaluated using the field firewall_policy_evaluation.
-    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. If the processing of a policy config fails, an error will be populated and the firewall_policy will be left empty.
+    "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # Output only. If the processing of a policy config fails, an error is populated and the firewall_policy is left empty.
       "code": 42, # The status code, which should be an enum value of google.rpc.Code.
       "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
         {
@@ -472,22 +472,22 @@ Method Details
       ],
       "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
     },
-    "firewallPolicy": { # A FirewallPolicy represents a single matching pattern and resulting actions to take. # Output only. The policy that matched the request. If more than one policy may match, this is the first match. If no policy matches the incoming request, the policy field will be left empty.
+    "firewallPolicy": { # A FirewallPolicy represents a single matching pattern and resulting actions to take. # Output only. The policy that matched the request. If more than one policy may match, this is the first match. If no policy matches the incoming request, the policy field is left empty.
       "actions": [ # Optional. The actions that the caller should take regarding user access. There should be at most one terminal action. A terminal action is any action that forces a response, such as `AllowAction`, `BlockAction` or `SubstituteAction`. Zero or more non-terminal actions such as `SetHeader` might be specified. A single policy can contain up to 16 actions.
         { # An individual action. Each action represents what to do if a policy matches.
           "allow": { # An allow action continues processing a request unimpeded. # The user request did not match any policy and should be allowed access to the requested resource.
           },
-          "block": { # A block action serves an HTTP error code a prevents the request from hitting the backend. # This action will deny access to a given page. The user will get an HTTP error code.
+          "block": { # A block action serves an HTTP error code a prevents the request from hitting the backend. # This action denies access to a given page. The user gets an HTTP error code.
           },
-          "includeRecaptchaScript": { # An include reCAPTCHA script action involves injecting reCAPTCHA JavaScript code into the HTML returned by the site backend. This reCAPTCHA script is tasked with collecting user signals on the requested web page, issuing tokens as a cookie within the site domain, and enabling their utilization in subsequent page requests. # This action will inject reCAPTCHA JavaScript code into the HTML page returned by the site backend.
+          "includeRecaptchaScript": { # An include reCAPTCHA script action involves injecting reCAPTCHA JavaScript code into the HTML returned by the site backend. This reCAPTCHA script is tasked with collecting user signals on the requested web page, issuing tokens as a cookie within the site domain, and enabling their utilization in subsequent page requests. # This action injects reCAPTCHA JavaScript code into the HTML page returned by the site backend.
           },
-          "redirect": { # A redirect action returns a 307 (temporary redirect) response, pointing the user to a ReCaptcha interstitial page to attach a token. # This action will redirect the request to a ReCaptcha interstitial to attach a token.
+          "redirect": { # A redirect action returns a 307 (temporary redirect) response, pointing the user to a reCAPTCHA interstitial page to attach a token. # This action redirects the request to a reCAPTCHA interstitial to attach a token.
           },
-          "setHeader": { # A set header action sets a header and forwards the request to the backend. This can be used to trigger custom protection implemented on the backend. # This action will set a custom header but allow the request to continue to the customer backend.
+          "setHeader": { # A set header action sets a header and forwards the request to the backend. This can be used to trigger custom protection implemented on the backend. # This action sets a custom header but allow the request to continue to the customer backend.
             "key": "A String", # Optional. The header key to set in the request to the backend server.
             "value": "A String", # Optional. The header value to set in the request to the backend server.
           },
-          "substitute": { # A substitute action transparently serves a different page than the one requested. # This action will transparently serve a different page to an offending user.
+          "substitute": { # A substitute action transparently serves a different page than the one requested. # This action transparently serves a different page to an offending user.
             "path": "A String", # Optional. The address to redirect to. The target is a relative path in the current host. Example: "/blog/404.html".
           },
         },
diff --git a/docs/dyn/recaptchaenterprise_v1.projects.firewallpolicies.html b/docs/dyn/recaptchaenterprise_v1.projects.firewallpolicies.html
index 59a75f5fd85..81dd95e4d41 100644
--- a/docs/dyn/recaptchaenterprise_v1.projects.firewallpolicies.html
+++ b/docs/dyn/recaptchaenterprise_v1.projects.firewallpolicies.html
@@ -109,7 +109,7 @@ Method Details
   Creates a new FirewallPolicy, specifying conditions at which reCAPTCHA Enterprise actions can be executed. A project may have a maximum of 1000 policies.
 
 Args:
-  parent: string, Required. The name of the project this policy will apply to, in the format `projects/{project}`. (required)
+  parent: string, Required. The name of the project this policy applies to, in the format `projects/{project}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -118,17 +118,17 @@ Method Details
     { # An individual action. Each action represents what to do if a policy matches.
       "allow": { # An allow action continues processing a request unimpeded. # The user request did not match any policy and should be allowed access to the requested resource.
       },
-      "block": { # A block action serves an HTTP error code a prevents the request from hitting the backend. # This action will deny access to a given page. The user will get an HTTP error code.
+      "block": { # A block action serves an HTTP error code a prevents the request from hitting the backend. # This action denies access to a given page. The user gets an HTTP error code.
       },
-      "includeRecaptchaScript": { # An include reCAPTCHA script action involves injecting reCAPTCHA JavaScript code into the HTML returned by the site backend. This reCAPTCHA script is tasked with collecting user signals on the requested web page, issuing tokens as a cookie within the site domain, and enabling their utilization in subsequent page requests. # This action will inject reCAPTCHA JavaScript code into the HTML page returned by the site backend.
+      "includeRecaptchaScript": { # An include reCAPTCHA script action involves injecting reCAPTCHA JavaScript code into the HTML returned by the site backend. This reCAPTCHA script is tasked with collecting user signals on the requested web page, issuing tokens as a cookie within the site domain, and enabling their utilization in subsequent page requests. # This action injects reCAPTCHA JavaScript code into the HTML page returned by the site backend.
       },
-      "redirect": { # A redirect action returns a 307 (temporary redirect) response, pointing the user to a ReCaptcha interstitial page to attach a token. # This action will redirect the request to a ReCaptcha interstitial to attach a token.
+      "redirect": { # A redirect action returns a 307 (temporary redirect) response, pointing the user to a reCAPTCHA interstitial page to attach a token. # This action redirects the request to a reCAPTCHA interstitial to attach a token.
       },
-      "setHeader": { # A set header action sets a header and forwards the request to the backend. This can be used to trigger custom protection implemented on the backend. # This action will set a custom header but allow the request to continue to the customer backend.
+      "setHeader": { # A set header action sets a header and forwards the request to the backend. This can be used to trigger custom protection implemented on the backend. # This action sets a custom header but allow the request to continue to the customer backend.
         "key": "A String", # Optional. The header key to set in the request to the backend server.
         "value": "A String", # Optional. The header value to set in the request to the backend server.
       },
-      "substitute": { # A substitute action transparently serves a different page than the one requested. # This action will transparently serve a different page to an offending user.
+      "substitute": { # A substitute action transparently serves a different page than the one requested. # This action transparently serves a different page to an offending user.
         "path": "A String", # Optional. The address to redirect to. The target is a relative path in the current host. Example: "/blog/404.html".
       },
     },
@@ -152,17 +152,17 @@ Method Details
     { # An individual action. Each action represents what to do if a policy matches.
       "allow": { # An allow action continues processing a request unimpeded. # The user request did not match any policy and should be allowed access to the requested resource.
       },
-      "block": { # A block action serves an HTTP error code a prevents the request from hitting the backend. # This action will deny access to a given page. The user will get an HTTP error code.
+      "block": { # A block action serves an HTTP error code a prevents the request from hitting the backend. # This action denies access to a given page. The user gets an HTTP error code.
       },
-      "includeRecaptchaScript": { # An include reCAPTCHA script action involves injecting reCAPTCHA JavaScript code into the HTML returned by the site backend. This reCAPTCHA script is tasked with collecting user signals on the requested web page, issuing tokens as a cookie within the site domain, and enabling their utilization in subsequent page requests. # This action will inject reCAPTCHA JavaScript code into the HTML page returned by the site backend.
+      "includeRecaptchaScript": { # An include reCAPTCHA script action involves injecting reCAPTCHA JavaScript code into the HTML returned by the site backend. This reCAPTCHA script is tasked with collecting user signals on the requested web page, issuing tokens as a cookie within the site domain, and enabling their utilization in subsequent page requests. # This action injects reCAPTCHA JavaScript code into the HTML page returned by the site backend.
       },
-      "redirect": { # A redirect action returns a 307 (temporary redirect) response, pointing the user to a ReCaptcha interstitial page to attach a token. # This action will redirect the request to a ReCaptcha interstitial to attach a token.
+      "redirect": { # A redirect action returns a 307 (temporary redirect) response, pointing the user to a reCAPTCHA interstitial page to attach a token. # This action redirects the request to a reCAPTCHA interstitial to attach a token.
       },
-      "setHeader": { # A set header action sets a header and forwards the request to the backend. This can be used to trigger custom protection implemented on the backend. # This action will set a custom header but allow the request to continue to the customer backend.
+      "setHeader": { # A set header action sets a header and forwards the request to the backend. This can be used to trigger custom protection implemented on the backend. # This action sets a custom header but allow the request to continue to the customer backend.
         "key": "A String", # Optional. The header key to set in the request to the backend server.
         "value": "A String", # Optional. The header value to set in the request to the backend server.
       },
-      "substitute": { # A substitute action transparently serves a different page than the one requested. # This action will transparently serve a different page to an offending user.
+      "substitute": { # A substitute action transparently serves a different page than the one requested. # This action transparently serves a different page to an offending user.
         "path": "A String", # Optional. The address to redirect to. The target is a relative path in the current host. Example: "/blog/404.html".
       },
     },
@@ -211,17 +211,17 @@ Method Details
     { # An individual action. Each action represents what to do if a policy matches.
       "allow": { # An allow action continues processing a request unimpeded. # The user request did not match any policy and should be allowed access to the requested resource.
       },
-      "block": { # A block action serves an HTTP error code a prevents the request from hitting the backend. # This action will deny access to a given page. The user will get an HTTP error code.
+      "block": { # A block action serves an HTTP error code a prevents the request from hitting the backend. # This action denies access to a given page. The user gets an HTTP error code.
       },
-      "includeRecaptchaScript": { # An include reCAPTCHA script action involves injecting reCAPTCHA JavaScript code into the HTML returned by the site backend. This reCAPTCHA script is tasked with collecting user signals on the requested web page, issuing tokens as a cookie within the site domain, and enabling their utilization in subsequent page requests. # This action will inject reCAPTCHA JavaScript code into the HTML page returned by the site backend.
+      "includeRecaptchaScript": { # An include reCAPTCHA script action involves injecting reCAPTCHA JavaScript code into the HTML returned by the site backend. This reCAPTCHA script is tasked with collecting user signals on the requested web page, issuing tokens as a cookie within the site domain, and enabling their utilization in subsequent page requests. # This action injects reCAPTCHA JavaScript code into the HTML page returned by the site backend.
       },
-      "redirect": { # A redirect action returns a 307 (temporary redirect) response, pointing the user to a ReCaptcha interstitial page to attach a token. # This action will redirect the request to a ReCaptcha interstitial to attach a token.
+      "redirect": { # A redirect action returns a 307 (temporary redirect) response, pointing the user to a reCAPTCHA interstitial page to attach a token. # This action redirects the request to a reCAPTCHA interstitial to attach a token.
       },
-      "setHeader": { # A set header action sets a header and forwards the request to the backend. This can be used to trigger custom protection implemented on the backend. # This action will set a custom header but allow the request to continue to the customer backend.
+      "setHeader": { # A set header action sets a header and forwards the request to the backend. This can be used to trigger custom protection implemented on the backend. # This action sets a custom header but allow the request to continue to the customer backend.
         "key": "A String", # Optional. The header key to set in the request to the backend server.
         "value": "A String", # Optional. The header value to set in the request to the backend server.
       },
-      "substitute": { # A substitute action transparently serves a different page than the one requested. # This action will transparently serve a different page to an offending user.
+      "substitute": { # A substitute action transparently serves a different page than the one requested. # This action transparently serves a different page to an offending user.
         "path": "A String", # Optional. The address to redirect to. The target is a relative path in the current host. Example: "/blog/404.html".
       },
     },
@@ -256,17 +256,17 @@ Method Details
         { # An individual action. Each action represents what to do if a policy matches.
           "allow": { # An allow action continues processing a request unimpeded. # The user request did not match any policy and should be allowed access to the requested resource.
           },
-          "block": { # A block action serves an HTTP error code a prevents the request from hitting the backend. # This action will deny access to a given page. The user will get an HTTP error code.
+          "block": { # A block action serves an HTTP error code a prevents the request from hitting the backend. # This action denies access to a given page. The user gets an HTTP error code.
           },
-          "includeRecaptchaScript": { # An include reCAPTCHA script action involves injecting reCAPTCHA JavaScript code into the HTML returned by the site backend. This reCAPTCHA script is tasked with collecting user signals on the requested web page, issuing tokens as a cookie within the site domain, and enabling their utilization in subsequent page requests. # This action will inject reCAPTCHA JavaScript code into the HTML page returned by the site backend.
+          "includeRecaptchaScript": { # An include reCAPTCHA script action involves injecting reCAPTCHA JavaScript code into the HTML returned by the site backend. This reCAPTCHA script is tasked with collecting user signals on the requested web page, issuing tokens as a cookie within the site domain, and enabling their utilization in subsequent page requests. # This action injects reCAPTCHA JavaScript code into the HTML page returned by the site backend.
           },
-          "redirect": { # A redirect action returns a 307 (temporary redirect) response, pointing the user to a ReCaptcha interstitial page to attach a token. # This action will redirect the request to a ReCaptcha interstitial to attach a token.
+          "redirect": { # A redirect action returns a 307 (temporary redirect) response, pointing the user to a reCAPTCHA interstitial page to attach a token. # This action redirects the request to a reCAPTCHA interstitial to attach a token.
           },
-          "setHeader": { # A set header action sets a header and forwards the request to the backend. This can be used to trigger custom protection implemented on the backend. # This action will set a custom header but allow the request to continue to the customer backend.
+          "setHeader": { # A set header action sets a header and forwards the request to the backend. This can be used to trigger custom protection implemented on the backend. # This action sets a custom header but allow the request to continue to the customer backend.
             "key": "A String", # Optional. The header key to set in the request to the backend server.
             "value": "A String", # Optional. The header value to set in the request to the backend server.
           },
-          "substitute": { # A substitute action transparently serves a different page than the one requested. # This action will transparently serve a different page to an offending user.
+          "substitute": { # A substitute action transparently serves a different page than the one requested. # This action transparently serves a different page to an offending user.
             "path": "A String", # Optional. The address to redirect to. The target is a relative path in the current host. Example: "/blog/404.html".
           },
         },
@@ -309,17 +309,17 @@ Method Details
     { # An individual action. Each action represents what to do if a policy matches.
       "allow": { # An allow action continues processing a request unimpeded. # The user request did not match any policy and should be allowed access to the requested resource.
       },
-      "block": { # A block action serves an HTTP error code a prevents the request from hitting the backend. # This action will deny access to a given page. The user will get an HTTP error code.
+      "block": { # A block action serves an HTTP error code a prevents the request from hitting the backend. # This action denies access to a given page. The user gets an HTTP error code.
       },
-      "includeRecaptchaScript": { # An include reCAPTCHA script action involves injecting reCAPTCHA JavaScript code into the HTML returned by the site backend. This reCAPTCHA script is tasked with collecting user signals on the requested web page, issuing tokens as a cookie within the site domain, and enabling their utilization in subsequent page requests. # This action will inject reCAPTCHA JavaScript code into the HTML page returned by the site backend.
+      "includeRecaptchaScript": { # An include reCAPTCHA script action involves injecting reCAPTCHA JavaScript code into the HTML returned by the site backend. This reCAPTCHA script is tasked with collecting user signals on the requested web page, issuing tokens as a cookie within the site domain, and enabling their utilization in subsequent page requests. # This action injects reCAPTCHA JavaScript code into the HTML page returned by the site backend.
       },
-      "redirect": { # A redirect action returns a 307 (temporary redirect) response, pointing the user to a ReCaptcha interstitial page to attach a token. # This action will redirect the request to a ReCaptcha interstitial to attach a token.
+      "redirect": { # A redirect action returns a 307 (temporary redirect) response, pointing the user to a reCAPTCHA interstitial page to attach a token. # This action redirects the request to a reCAPTCHA interstitial to attach a token.
       },
-      "setHeader": { # A set header action sets a header and forwards the request to the backend. This can be used to trigger custom protection implemented on the backend. # This action will set a custom header but allow the request to continue to the customer backend.
+      "setHeader": { # A set header action sets a header and forwards the request to the backend. This can be used to trigger custom protection implemented on the backend. # This action sets a custom header but allow the request to continue to the customer backend.
         "key": "A String", # Optional. The header key to set in the request to the backend server.
         "value": "A String", # Optional. The header value to set in the request to the backend server.
       },
-      "substitute": { # A substitute action transparently serves a different page than the one requested. # This action will transparently serve a different page to an offending user.
+      "substitute": { # A substitute action transparently serves a different page than the one requested. # This action transparently serves a different page to an offending user.
         "path": "A String", # Optional. The address to redirect to. The target is a relative path in the current host. Example: "/blog/404.html".
       },
     },
@@ -330,7 +330,7 @@ Method Details
   "path": "A String", # Optional. The path for which this policy applies, specified as a glob pattern. For more information on glob, see the [manual page](https://man7.org/linux/man-pages/man7/glob.7.html). A path has a max length of 200 characters.
 }
 
-  updateMask: string, Optional. The mask to control which fields of the policy get updated. If the mask is not present, all fields will be updated.
+  updateMask: string, Optional. The mask to control which fields of the policy get updated. If the mask is not present, all fields are updated.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -344,17 +344,17 @@ Method Details
     { # An individual action. Each action represents what to do if a policy matches.
       "allow": { # An allow action continues processing a request unimpeded. # The user request did not match any policy and should be allowed access to the requested resource.
       },
-      "block": { # A block action serves an HTTP error code a prevents the request from hitting the backend. # This action will deny access to a given page. The user will get an HTTP error code.
+      "block": { # A block action serves an HTTP error code a prevents the request from hitting the backend. # This action denies access to a given page. The user gets an HTTP error code.
       },
-      "includeRecaptchaScript": { # An include reCAPTCHA script action involves injecting reCAPTCHA JavaScript code into the HTML returned by the site backend. This reCAPTCHA script is tasked with collecting user signals on the requested web page, issuing tokens as a cookie within the site domain, and enabling their utilization in subsequent page requests. # This action will inject reCAPTCHA JavaScript code into the HTML page returned by the site backend.
+      "includeRecaptchaScript": { # An include reCAPTCHA script action involves injecting reCAPTCHA JavaScript code into the HTML returned by the site backend. This reCAPTCHA script is tasked with collecting user signals on the requested web page, issuing tokens as a cookie within the site domain, and enabling their utilization in subsequent page requests. # This action injects reCAPTCHA JavaScript code into the HTML page returned by the site backend.
       },
-      "redirect": { # A redirect action returns a 307 (temporary redirect) response, pointing the user to a ReCaptcha interstitial page to attach a token. # This action will redirect the request to a ReCaptcha interstitial to attach a token.
+      "redirect": { # A redirect action returns a 307 (temporary redirect) response, pointing the user to a reCAPTCHA interstitial page to attach a token. # This action redirects the request to a reCAPTCHA interstitial to attach a token.
       },
-      "setHeader": { # A set header action sets a header and forwards the request to the backend. This can be used to trigger custom protection implemented on the backend. # This action will set a custom header but allow the request to continue to the customer backend.
+      "setHeader": { # A set header action sets a header and forwards the request to the backend. This can be used to trigger custom protection implemented on the backend. # This action sets a custom header but allow the request to continue to the customer backend.
         "key": "A String", # Optional. The header key to set in the request to the backend server.
         "value": "A String", # Optional. The header value to set in the request to the backend server.
       },
-      "substitute": { # A substitute action transparently serves a different page than the one requested. # This action will transparently serve a different page to an offending user.
+      "substitute": { # A substitute action transparently serves a different page than the one requested. # This action transparently serves a different page to an offending user.
         "path": "A String", # Optional. The address to redirect to. The target is a relative path in the current host. Example: "/blog/404.html".
       },
     },
diff --git a/docs/dyn/recaptchaenterprise_v1.projects.keys.html b/docs/dyn/recaptchaenterprise_v1.projects.keys.html
index 6b83c4d38ac..676631abeda 100644
--- a/docs/dyn/recaptchaenterprise_v1.projects.keys.html
+++ b/docs/dyn/recaptchaenterprise_v1.projects.keys.html
@@ -76,7 +76,7 @@ reCAPTCHA Enterprise API . Instance Methods

 
   addIpOverride(name, body=None, x__xgafv=None)
-Adds an IP override to a key. The following restrictions hold: * The maximum number of IP overrides per key is 100. * For any conflict (such as IP already exists or IP part of an existing IP range), an error will be returned.
+Adds an IP override to a key. The following restrictions hold: * The maximum number of IP overrides per key is 100. * For any conflict (such as IP already exists or IP part of an existing IP range), an error is returned.
 
   close()
 Close httplib2 connections.
@@ -112,14 +112,14 @@ Instance Methods
 Updates the specified key.
 
   removeIpOverride(name, body=None, x__xgafv=None)
-Removes an IP override from a key. The following restrictions hold: * If the IP isn't found in an existing IP override, a `NOT_FOUND` error will be returned. * If the IP is found in an existing IP override, but the override type does not match, a `NOT_FOUND` error will be returned.
+Removes an IP override from a key. The following restrictions hold: * If the IP isn't found in an existing IP override, a `NOT_FOUND` error is returned. * If the IP is found in an existing IP override, but the override type does not match, a `NOT_FOUND` error is returned.
 
   retrieveLegacySecretKey(x__xgafv=None)
 Returns the secret key related to the specified public key. You must use the legacy secret key only in a 3rd party integration with legacy reCAPTCHA.
 Method Details
 
     addIpOverride(name, body=None, x__xgafv=None)
-  Adds an IP override to a key. The following restrictions hold: * The maximum number of IP overrides per key is 100. * For any conflict (such as IP already exists or IP part of an existing IP range), an error will be returned.
+  Adds an IP override to a key. The following restrictions hold: * The maximum number of IP overrides per key is 100. * For any conflict (such as IP already exists or IP part of an existing IP range), an error is returned.
 
 Args:
   name: string, Required. The name of the key to which the IP override is added, in the format `projects/{project}/keys/{key}`. (required)
@@ -155,7 +155,7 @@ Method Details
   Creates a new reCAPTCHA Enterprise key.
 
 Args:
-  parent: string, Required. The name of the project in which the key will be created, in the format `projects/{project}`. (required)
+  parent: string, Required. The name of the project in which the key is created, in the format `projects/{project}`. (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -176,7 +176,7 @@ Method Details
     "allowedBundleIds": [ # Optional. iOS bundle ids of apps allowed to use the key. Example: 'com.companyname.productname.appname'
       "A String",
     ],
-    "appleDeveloperId": { # Contains fields that are required to perform Apple-specific integrity checks. # Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA Enterprise leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA Enterprise to get a better assessment of the integrity of your app.
+    "appleDeveloperId": { # Contains fields that are required to perform Apple-specific integrity checks. # Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA to get a better assessment of the integrity of your app.
       "keyId": "A String", # Required. The Apple developer key ID (10-character string).
       "privateKey": "A String", # Required. Input only. A private key (downloaded as a text file with a .p8 file extension) generated for your Apple Developer account. Ensure that Apple DeviceCheck is enabled for the private key.
       "teamId": "A String", # Required. The Apple team ID (10-character string) owning the provisioning profile used to build your application.
@@ -187,20 +187,20 @@ Method Details
   },
   "name": "A String", # Identifier. The resource name for the Key in the format `projects/{project}/keys/{key}`.
   "testingOptions": { # Options for user acceptance testing. # Optional. Options for user acceptance testing.
-    "testingChallenge": "A String", # Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site will return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.
-    "testingScore": 3.14, # Optional. All assessments for this Key will return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.
+    "testingChallenge": "A String", # Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.
+    "testingScore": 3.14, # Optional. All assessments for this Key return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.
   },
   "wafSettings": { # Settings specific to keys that can be used for WAF (Web Application Firewall). # Optional. Settings for WAF
     "wafFeature": "A String", # Required. The WAF feature for which this key is enabled.
     "wafService": "A String", # Required. The WAF service that uses this key.
   },
   "webSettings": { # Settings specific to keys that can be used by websites. # Settings for keys that can be used by websites.
-    "allowAllDomains": True or False, # Optional. If set to true, it means allowed_domains will not be enforced.
+    "allowAllDomains": True or False, # Optional. If set to true, it means allowed_domains are not enforced.
     "allowAmpTraffic": True or False, # Optional. If set to true, the key can be used on AMP (Accelerated Mobile Pages) websites. This is supported only for the SCORE integration type.
     "allowedDomains": [ # Optional. Domains or subdomains of websites allowed to use the key. All subdomains of an allowed domain are automatically allowed. A valid domain requires a host and must not include any path, port, query or fragment. Examples: 'example.com' or 'subdomain.example.com'
       "A String",
     ],
-    "challengeSecurityPreference": "A String", # Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE.
+    "challengeSecurityPreference": "A String", # Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE and SCORE_AND_CHALLENGE.
     "integrationType": "A String", # Required. Describes how this key is integrated with the website.
   },
 }
@@ -230,7 +230,7 @@ Method Details
     "allowedBundleIds": [ # Optional. iOS bundle ids of apps allowed to use the key. Example: 'com.companyname.productname.appname'
       "A String",
     ],
-    "appleDeveloperId": { # Contains fields that are required to perform Apple-specific integrity checks. # Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA Enterprise leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA Enterprise to get a better assessment of the integrity of your app.
+    "appleDeveloperId": { # Contains fields that are required to perform Apple-specific integrity checks. # Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA to get a better assessment of the integrity of your app.
       "keyId": "A String", # Required. The Apple developer key ID (10-character string).
       "privateKey": "A String", # Required. Input only. A private key (downloaded as a text file with a .p8 file extension) generated for your Apple Developer account. Ensure that Apple DeviceCheck is enabled for the private key.
       "teamId": "A String", # Required. The Apple team ID (10-character string) owning the provisioning profile used to build your application.
@@ -241,20 +241,20 @@ Method Details
   },
   "name": "A String", # Identifier. The resource name for the Key in the format `projects/{project}/keys/{key}`.
   "testingOptions": { # Options for user acceptance testing. # Optional. Options for user acceptance testing.
-    "testingChallenge": "A String", # Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site will return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.
-    "testingScore": 3.14, # Optional. All assessments for this Key will return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.
+    "testingChallenge": "A String", # Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.
+    "testingScore": 3.14, # Optional. All assessments for this Key return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.
   },
   "wafSettings": { # Settings specific to keys that can be used for WAF (Web Application Firewall). # Optional. Settings for WAF
     "wafFeature": "A String", # Required. The WAF feature for which this key is enabled.
     "wafService": "A String", # Required. The WAF service that uses this key.
   },
   "webSettings": { # Settings specific to keys that can be used by websites. # Settings for keys that can be used by websites.
-    "allowAllDomains": True or False, # Optional. If set to true, it means allowed_domains will not be enforced.
+    "allowAllDomains": True or False, # Optional. If set to true, it means allowed_domains are not enforced.
     "allowAmpTraffic": True or False, # Optional. If set to true, the key can be used on AMP (Accelerated Mobile Pages) websites. This is supported only for the SCORE integration type.
     "allowedDomains": [ # Optional. Domains or subdomains of websites allowed to use the key. All subdomains of an allowed domain are automatically allowed. A valid domain requires a host and must not include any path, port, query or fragment. Examples: 'example.com' or 'subdomain.example.com'
       "A String",
     ],
-    "challengeSecurityPreference": "A String", # Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE.
+    "challengeSecurityPreference": "A String", # Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE and SCORE_AND_CHALLENGE.
     "integrationType": "A String", # Required. Describes how this key is integrated with the website.
   },
 }
@@ -309,7 +309,7 @@ Method Details
     "allowedBundleIds": [ # Optional. iOS bundle ids of apps allowed to use the key. Example: 'com.companyname.productname.appname'
       "A String",
     ],
-    "appleDeveloperId": { # Contains fields that are required to perform Apple-specific integrity checks. # Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA Enterprise leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA Enterprise to get a better assessment of the integrity of your app.
+    "appleDeveloperId": { # Contains fields that are required to perform Apple-specific integrity checks. # Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA to get a better assessment of the integrity of your app.
       "keyId": "A String", # Required. The Apple developer key ID (10-character string).
       "privateKey": "A String", # Required. Input only. A private key (downloaded as a text file with a .p8 file extension) generated for your Apple Developer account. Ensure that Apple DeviceCheck is enabled for the private key.
       "teamId": "A String", # Required. The Apple team ID (10-character string) owning the provisioning profile used to build your application.
@@ -320,20 +320,20 @@ Method Details
   },
   "name": "A String", # Identifier. The resource name for the Key in the format `projects/{project}/keys/{key}`.
   "testingOptions": { # Options for user acceptance testing. # Optional. Options for user acceptance testing.
-    "testingChallenge": "A String", # Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site will return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.
-    "testingScore": 3.14, # Optional. All assessments for this Key will return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.
+    "testingChallenge": "A String", # Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.
+    "testingScore": 3.14, # Optional. All assessments for this Key return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.
   },
   "wafSettings": { # Settings specific to keys that can be used for WAF (Web Application Firewall). # Optional. Settings for WAF
     "wafFeature": "A String", # Required. The WAF feature for which this key is enabled.
     "wafService": "A String", # Required. The WAF service that uses this key.
   },
   "webSettings": { # Settings specific to keys that can be used by websites. # Settings for keys that can be used by websites.
-    "allowAllDomains": True or False, # Optional. If set to true, it means allowed_domains will not be enforced.
+    "allowAllDomains": True or False, # Optional. If set to true, it means allowed_domains are not enforced.
     "allowAmpTraffic": True or False, # Optional. If set to true, the key can be used on AMP (Accelerated Mobile Pages) websites. This is supported only for the SCORE integration type.
     "allowedDomains": [ # Optional. Domains or subdomains of websites allowed to use the key. All subdomains of an allowed domain are automatically allowed. A valid domain requires a host and must not include any path, port, query or fragment. Examples: 'example.com' or 'subdomain.example.com'
       "A String",
     ],
-    "challengeSecurityPreference": "A String", # Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE.
+    "challengeSecurityPreference": "A String", # Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE and SCORE_AND_CHALLENGE.
     "integrationType": "A String", # Required. Describes how this key is integrated with the website.
   },
 }
@@ -354,7 +354,7 @@ Method Details
   An object of the form:
 
     { # Metrics for a single Key.
-  "challengeMetrics": [ # Metrics will be continuous and in order by dates, and in the granularity of day. Only challenge-based keys (CHECKBOX, INVISIBLE), will have challenge-based data.
+  "challengeMetrics": [ # Metrics are continuous and in order by dates, and in the granularity of day. Only challenge-based keys (CHECKBOX, INVISIBLE) have challenge-based data.
     { # Metrics related to challenges.
       "failedCount": "A String", # Count of submitted challenge solutions that were incorrect or otherwise deemed suspicious such that a subsequent challenge was triggered.
       "nocaptchaCount": "A String", # Count of nocaptchas (successful verification without a challenge) issued.
@@ -363,7 +363,7 @@ Method Details
     },
   ],
   "name": "A String", # Output only. Identifier. The name of the metrics, in the format `projects/{project}/keys/{key}/metrics`.
-  "scoreMetrics": [ # Metrics will be continuous and in order by dates, and in the granularity of day. All Key types should have score-based data.
+  "scoreMetrics": [ # Metrics are continuous and in order by dates, and in the granularity of day. All Key types should have score-based data.
     { # Metrics related to scoring.
       "actionMetrics": { # Action-based metrics. The map key is the action name which specified by the site owners at time of the "execute" client-side call.
         "a_key": { # Score distribution.
@@ -388,7 +388,7 @@ Method Details
   Returns the list of all keys that belong to a project.
 
 Args:
-  parent: string, Required. The name of the project that contains the keys that will be listed, in the format `projects/{project}`. (required)
+  parent: string, Required. The name of the project that contains the keys that is listed, in the format `projects/{project}`. (required)
   pageSize: integer, Optional. The maximum number of keys to return. Default is 10. Max limit is 1000.
   pageToken: string, Optional. The next_page_token value returned from a previous. ListKeysRequest, if any.
   x__xgafv: string, V1 error format.
@@ -418,7 +418,7 @@ Method Details
         "allowedBundleIds": [ # Optional. iOS bundle ids of apps allowed to use the key. Example: 'com.companyname.productname.appname'
           "A String",
         ],
-        "appleDeveloperId": { # Contains fields that are required to perform Apple-specific integrity checks. # Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA Enterprise leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA Enterprise to get a better assessment of the integrity of your app.
+        "appleDeveloperId": { # Contains fields that are required to perform Apple-specific integrity checks. # Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA to get a better assessment of the integrity of your app.
           "keyId": "A String", # Required. The Apple developer key ID (10-character string).
           "privateKey": "A String", # Required. Input only. A private key (downloaded as a text file with a .p8 file extension) generated for your Apple Developer account. Ensure that Apple DeviceCheck is enabled for the private key.
           "teamId": "A String", # Required. The Apple team ID (10-character string) owning the provisioning profile used to build your application.
@@ -429,20 +429,20 @@ Method Details
       },
       "name": "A String", # Identifier. The resource name for the Key in the format `projects/{project}/keys/{key}`.
       "testingOptions": { # Options for user acceptance testing. # Optional. Options for user acceptance testing.
-        "testingChallenge": "A String", # Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site will return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.
-        "testingScore": 3.14, # Optional. All assessments for this Key will return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.
+        "testingChallenge": "A String", # Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.
+        "testingScore": 3.14, # Optional. All assessments for this Key return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.
       },
       "wafSettings": { # Settings specific to keys that can be used for WAF (Web Application Firewall). # Optional. Settings for WAF
         "wafFeature": "A String", # Required. The WAF feature for which this key is enabled.
         "wafService": "A String", # Required. The WAF service that uses this key.
       },
       "webSettings": { # Settings specific to keys that can be used by websites. # Settings for keys that can be used by websites.
-        "allowAllDomains": True or False, # Optional. If set to true, it means allowed_domains will not be enforced.
+        "allowAllDomains": True or False, # Optional. If set to true, it means allowed_domains are not enforced.
         "allowAmpTraffic": True or False, # Optional. If set to true, the key can be used on AMP (Accelerated Mobile Pages) websites. This is supported only for the SCORE integration type.
         "allowedDomains": [ # Optional. Domains or subdomains of websites allowed to use the key. All subdomains of an allowed domain are automatically allowed. A valid domain requires a host and must not include any path, port, query or fragment. Examples: 'example.com' or 'subdomain.example.com'
           "A String",
         ],
-        "challengeSecurityPreference": "A String", # Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE.
+        "challengeSecurityPreference": "A String", # Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE and SCORE_AND_CHALLENGE.
         "integrationType": "A String", # Required. Describes how this key is integrated with the website.
       },
     },
@@ -544,7 +544,7 @@ Method Details
     "allowedBundleIds": [ # Optional. iOS bundle ids of apps allowed to use the key. Example: 'com.companyname.productname.appname'
       "A String",
     ],
-    "appleDeveloperId": { # Contains fields that are required to perform Apple-specific integrity checks. # Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA Enterprise leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA Enterprise to get a better assessment of the integrity of your app.
+    "appleDeveloperId": { # Contains fields that are required to perform Apple-specific integrity checks. # Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA to get a better assessment of the integrity of your app.
       "keyId": "A String", # Required. The Apple developer key ID (10-character string).
       "privateKey": "A String", # Required. Input only. A private key (downloaded as a text file with a .p8 file extension) generated for your Apple Developer account. Ensure that Apple DeviceCheck is enabled for the private key.
       "teamId": "A String", # Required. The Apple team ID (10-character string) owning the provisioning profile used to build your application.
@@ -555,20 +555,20 @@ Method Details
   },
   "name": "A String", # Identifier. The resource name for the Key in the format `projects/{project}/keys/{key}`.
   "testingOptions": { # Options for user acceptance testing. # Optional. Options for user acceptance testing.
-    "testingChallenge": "A String", # Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site will return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.
-    "testingScore": 3.14, # Optional. All assessments for this Key will return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.
+    "testingChallenge": "A String", # Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.
+    "testingScore": 3.14, # Optional. All assessments for this Key return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.
   },
   "wafSettings": { # Settings specific to keys that can be used for WAF (Web Application Firewall). # Optional. Settings for WAF
     "wafFeature": "A String", # Required. The WAF feature for which this key is enabled.
     "wafService": "A String", # Required. The WAF service that uses this key.
   },
   "webSettings": { # Settings specific to keys that can be used by websites. # Settings for keys that can be used by websites.
-    "allowAllDomains": True or False, # Optional. If set to true, it means allowed_domains will not be enforced.
+    "allowAllDomains": True or False, # Optional. If set to true, it means allowed_domains are not enforced.
     "allowAmpTraffic": True or False, # Optional. If set to true, the key can be used on AMP (Accelerated Mobile Pages) websites. This is supported only for the SCORE integration type.
     "allowedDomains": [ # Optional. Domains or subdomains of websites allowed to use the key. All subdomains of an allowed domain are automatically allowed. A valid domain requires a host and must not include any path, port, query or fragment. Examples: 'example.com' or 'subdomain.example.com'
       "A String",
     ],
-    "challengeSecurityPreference": "A String", # Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE.
+    "challengeSecurityPreference": "A String", # Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE and SCORE_AND_CHALLENGE.
     "integrationType": "A String", # Required. Describes how this key is integrated with the website.
   },
 }
@@ -600,7 +600,7 @@ Method Details
     "allowedBundleIds": [ # Optional. iOS bundle ids of apps allowed to use the key. Example: 'com.companyname.productname.appname'
       "A String",
     ],
-    "appleDeveloperId": { # Contains fields that are required to perform Apple-specific integrity checks. # Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA Enterprise leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA Enterprise to get a better assessment of the integrity of your app.
+    "appleDeveloperId": { # Contains fields that are required to perform Apple-specific integrity checks. # Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA to get a better assessment of the integrity of your app.
       "keyId": "A String", # Required. The Apple developer key ID (10-character string).
       "privateKey": "A String", # Required. Input only. A private key (downloaded as a text file with a .p8 file extension) generated for your Apple Developer account. Ensure that Apple DeviceCheck is enabled for the private key.
       "teamId": "A String", # Required. The Apple team ID (10-character string) owning the provisioning profile used to build your application.
@@ -611,25 +611,25 @@ Method Details
   },
   "name": "A String", # Identifier. The resource name for the Key in the format `projects/{project}/keys/{key}`.
   "testingOptions": { # Options for user acceptance testing. # Optional. Options for user acceptance testing.
-    "testingChallenge": "A String", # Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site will return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.
-    "testingScore": 3.14, # Optional. All assessments for this Key will return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.
+    "testingChallenge": "A String", # Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.
+    "testingScore": 3.14, # Optional. All assessments for this Key return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.
   },
   "wafSettings": { # Settings specific to keys that can be used for WAF (Web Application Firewall). # Optional. Settings for WAF
     "wafFeature": "A String", # Required. The WAF feature for which this key is enabled.
     "wafService": "A String", # Required. The WAF service that uses this key.
   },
   "webSettings": { # Settings specific to keys that can be used by websites. # Settings for keys that can be used by websites.
-    "allowAllDomains": True or False, # Optional. If set to true, it means allowed_domains will not be enforced.
+    "allowAllDomains": True or False, # Optional. If set to true, it means allowed_domains are not enforced.
     "allowAmpTraffic": True or False, # Optional. If set to true, the key can be used on AMP (Accelerated Mobile Pages) websites. This is supported only for the SCORE integration type.
     "allowedDomains": [ # Optional. Domains or subdomains of websites allowed to use the key. All subdomains of an allowed domain are automatically allowed. A valid domain requires a host and must not include any path, port, query or fragment. Examples: 'example.com' or 'subdomain.example.com'
       "A String",
     ],
-    "challengeSecurityPreference": "A String", # Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE.
+    "challengeSecurityPreference": "A String", # Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE and SCORE_AND_CHALLENGE.
     "integrationType": "A String", # Required. Describes how this key is integrated with the website.
   },
 }
 
-  updateMask: string, Optional. The mask to control which fields of the key get updated. If the mask is not present, all fields will be updated.
+  updateMask: string, Optional. The mask to control which fields of the key get updated. If the mask is not present, all fields are updated.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -655,7 +655,7 @@ Method Details
     "allowedBundleIds": [ # Optional. iOS bundle ids of apps allowed to use the key. Example: 'com.companyname.productname.appname'
       "A String",
     ],
-    "appleDeveloperId": { # Contains fields that are required to perform Apple-specific integrity checks. # Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA Enterprise leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA Enterprise to get a better assessment of the integrity of your app.
+    "appleDeveloperId": { # Contains fields that are required to perform Apple-specific integrity checks. # Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA to get a better assessment of the integrity of your app.
       "keyId": "A String", # Required. The Apple developer key ID (10-character string).
       "privateKey": "A String", # Required. Input only. A private key (downloaded as a text file with a .p8 file extension) generated for your Apple Developer account. Ensure that Apple DeviceCheck is enabled for the private key.
       "teamId": "A String", # Required. The Apple team ID (10-character string) owning the provisioning profile used to build your application.
@@ -666,20 +666,20 @@ Method Details
   },
   "name": "A String", # Identifier. The resource name for the Key in the format `projects/{project}/keys/{key}`.
   "testingOptions": { # Options for user acceptance testing. # Optional. Options for user acceptance testing.
-    "testingChallenge": "A String", # Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site will return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.
-    "testingScore": 3.14, # Optional. All assessments for this Key will return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.
+    "testingChallenge": "A String", # Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.
+    "testingScore": 3.14, # Optional. All assessments for this Key return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.
   },
   "wafSettings": { # Settings specific to keys that can be used for WAF (Web Application Firewall). # Optional. Settings for WAF
     "wafFeature": "A String", # Required. The WAF feature for which this key is enabled.
     "wafService": "A String", # Required. The WAF service that uses this key.
   },
   "webSettings": { # Settings specific to keys that can be used by websites. # Settings for keys that can be used by websites.
-    "allowAllDomains": True or False, # Optional. If set to true, it means allowed_domains will not be enforced.
+    "allowAllDomains": True or False, # Optional. If set to true, it means allowed_domains are not enforced.
     "allowAmpTraffic": True or False, # Optional. If set to true, the key can be used on AMP (Accelerated Mobile Pages) websites. This is supported only for the SCORE integration type.
     "allowedDomains": [ # Optional. Domains or subdomains of websites allowed to use the key. All subdomains of an allowed domain are automatically allowed. A valid domain requires a host and must not include any path, port, query or fragment. Examples: 'example.com' or 'subdomain.example.com'
       "A String",
     ],
-    "challengeSecurityPreference": "A String", # Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE.
+    "challengeSecurityPreference": "A String", # Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE and SCORE_AND_CHALLENGE.
     "integrationType": "A String", # Required. Describes how this key is integrated with the website.
   },
 }
@@ -687,7 +687,7 @@ Method Details
 
 
     removeIpOverride(name, body=None, x__xgafv=None)
-  Removes an IP override from a key. The following restrictions hold: * If the IP isn't found in an existing IP override, a `NOT_FOUND` error will be returned. * If the IP is found in an existing IP override, but the override type does not match, a `NOT_FOUND` error will be returned.
+  Removes an IP override from a key. The following restrictions hold: * If the IP isn't found in an existing IP override, a `NOT_FOUND` error is returned. * If the IP is found in an existing IP override, but the override type does not match, a `NOT_FOUND` error is returned.
 
 Args:
   name: string, Required. The name of the key from which the IP override is removed, in the format `projects/{project}/keys/{key}`. (required)
diff --git a/docs/dyn/sts_v1.v1.html b/docs/dyn/sts_v1.v1.html
index 49ee357a4c3..6ff4eb55bd7 100644
--- a/docs/dyn/sts_v1.v1.html
+++ b/docs/dyn/sts_v1.v1.html
@@ -98,7 +98,7 @@ Method Details
   "audience": "A String", # The full resource name of the identity provider; for example: `//iam.googleapis.com/projects//locations/global/workloadIdentityPools//providers/` for workload identity pool providers, or `//iam.googleapis.com/locations/global/workforcePools//providers/` for workforce pool providers. Required when exchanging an external credential for a Google access token.
   "grantType": "A String", # Required. The grant type. Must be `urn:ietf:params:oauth:grant-type:token-exchange`, which indicates a token exchange.
   "options": "A String", # A set of features that Security Token Service supports, in addition to the standard OAuth 2.0 token exchange, formatted as a serialized JSON object of Options. The size of the parameter value must not exceed 4096 characters.
-  "requestedTokenType": "A String", # Required. An identifier for the type of requested security token. Can be `urn:ietf:params:oauth:token-type:access_token` or `urn:ietf:params:oauth:token-type:access_boundary_intermediate_token`.
+  "requestedTokenType": "A String", # Required. An identifier for the type of requested security token. Can be `urn:ietf:params:oauth:token-type:access_token` or `urn:ietf:params:oauth:token-type:access_boundary_intermediary_token`.
   "scope": "A String", # The OAuth 2.0 scopes to include on the resulting access token, formatted as a list of space-delimited, case-sensitive strings. Required when exchanging an external credential for a Google access token.
   "subjectToken": "A String", # Required. The input token. This token is either an external credential issued by a workload identity pool provider, or a short-lived access token issued by Google. If the token is an OIDC JWT, it must use the JWT format defined in [RFC 7523](https://tools.ietf.org/html/rfc7523), and the `subject_token_type` must be either `urn:ietf:params:oauth:token-type:jwt` or `urn:ietf:params:oauth:token-type:id_token`. The following headers are required: - `kid`: The identifier of the signing key securing the JWT. - `alg`: The cryptographic algorithm securing the JWT. Must be `RS256` or `ES256`. The following payload fields are required. For more information, see [RFC 7523, Section 3](https://tools.ietf.org/html/rfc7523#section-3): - `iss`: The issuer of the token. The issuer must provide a discovery document at the URL `/.well-known/openid-configuration`, where `` is the value of this field. The document must be formatted according to section 4.2 of the [OIDC 1.0 Discovery specification](https://openid.net/specs/openid-connect-discovery-1_0.html#ProviderConfigurationResponse). - `iat`: The issue time, in seconds, since the Unix epoch. Must be in the past. - `exp`: The expiration time, in seconds, since the Unix epoch. Must be less than 48 hours after `iat`. Shorter expiration times are more secure. If possible, we recommend setting an expiration time less than 6 hours. - `sub`: The identity asserted in the JWT. - `aud`: For workload identity pools, this must be a value specified in the allowed audiences for the workload identity pool provider, or one of the audiences allowed by default if no audiences were specified. See https://cloud.google.com/iam/docs/reference/rest/v1/projects.locations.workloadIdentityPools.providers#oidc. For workforce pools, this must match the client ID specified in the provider configuration. See https://cloud.google.com/iam/docs/reference/rest/v1/locations.workforcePools.providers#oidc. Example header: ``` { "alg": "RS256", "kid": "us-east-11" } ``` Example payload: ``` { "iss": "https://accounts.google.com", "iat": 1517963104, "exp": 1517966704, "aud": "//iam.googleapis.com/projects/1234567890123/locations/global/workloadIdentityPools/my-pool/providers/my-provider", "sub": "113475438248934895348", "my_claims": { "additional_claim": "value" } } ``` If `subject_token` is for AWS, it must be a serialized `GetCallerIdentity` token. This token contains the same information as a request to the AWS [`GetCallerIdentity()`](https://docs.aws.amazon.com/STS/latest/APIReference/API_GetCallerIdentity) method, as well as the AWS [signature](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) for the request information. Use Signature Version 4. Format the request as URL-encoded JSON, and set the `subject_token_type` parameter to `urn:ietf:params:aws:token-type:aws4_request`. The following parameters are required: - `url`: The URL of the AWS STS endpoint for `GetCallerIdentity()`, such as `https://sts.amazonaws.com?Action=GetCallerIdentity&Version=2011-06-15`. Regional endpoints are also supported. - `method`: The HTTP request method: `POST`. - `headers`: The HTTP request headers, which must include: - `Authorization`: The request signature. - `x-amz-date`: The time you will send the request, formatted as an [ISO8601 Basic](https://docs.aws.amazon.com/general/latest/gr/sigv4_elements.html#sigv4_elements_date) string. This value is typically set to the current time and is used to help prevent replay attacks. - `host`: The hostname of the `url` field; for example, `sts.amazonaws.com`. - `x-goog-cloud-target-resource`: The full, canonical resource name of the workload identity pool provider, with or without an `https:` prefix. To help ensure data integrity, we recommend including this header in the `SignedHeaders` field of the signed request. For example: //iam.googleapis.com/projects//locations/global/workloadIdentityPools//providers/ https://iam.googleapis.com/projects//locations/global/workloadIdentityPools//providers/ If you are using temporary security credentials provided by AWS, you must also include the header `x-amz-security-token`, with the value set to the session token. The following example shows a `GetCallerIdentity` token: ``` { "headers": [ {"key": "x-amz-date", "value": "20200815T015049Z"}, {"key": "Authorization", "value": "AWS4-HMAC-SHA256+Credential=$credential,+SignedHeaders=host;x-amz-date;x-goog-cloud-target-resource,+Signature=$signature"}, {"key": "x-goog-cloud-target-resource", "value": "//iam.googleapis.com/projects//locations/global/workloadIdentityPools//providers/"}, {"key": "host", "value": "sts.amazonaws.com"} . ], "method": "POST", "url": "https://sts.amazonaws.com?Action=GetCallerIdentity&Version=2011-06-15" } ``` If the token is a SAML 2.0 assertion, it must use the format defined in [the SAML 2.0 spec](https://docs.oasis-open.org/security/saml/Post2.0/sstc-saml-tech-overview-2.0-cd-02.pdf), and the `subject_token_type` must be `urn:ietf:params:oauth:token-type:saml2`. See [Verification of external credentials](https://cloud.google.com/iam/docs/using-workload-identity-federation#verification_of_external_credentials) for details on how SAML 2.0 assertions are validated during token exchanges. You can also use a Google-issued OAuth 2.0 access token with this field to obtain an access token with new security attributes applied, such as a Credential Access Boundary. In this case, set `subject_token_type` to `urn:ietf:params:oauth:token-type:access_token`. If an access token already contains security attributes, you cannot apply additional security attributes.
   "subjectTokenType": "A String", # Required. An identifier that indicates the type of the security token in the `subject_token` parameter. Supported values are `urn:ietf:params:oauth:token-type:jwt`, `urn:ietf:params:oauth:token-type:id_token`, `urn:ietf:params:aws:token-type:aws4_request`, `urn:ietf:params:oauth:token-type:access_token`, and `urn:ietf:params:oauth:token-type:saml2`.
@@ -113,7 +113,7 @@ Method Details
   An object of the form:
 
     { # Response message for ExchangeToken.
-  "access_boundary_session_key": "A String", # The access boundary session key. This key is used along with the access boundary intermediate token to generate Credential Access Boundary tokens at client side. This field is absent when the `requested_token_type` from the request is not `urn:ietf:params:oauth:token-type:access_boundary_intermediate_token`.
+  "access_boundary_session_key": "A String", # The access boundary session key. This key is used along with the access boundary intermediary token to generate Credential Access Boundary tokens at client side. This field is absent when the `requested_token_type` from the request is not `urn:ietf:params:oauth:token-type:access_boundary_intermediary_token`.
   "access_token": "A String", # An OAuth 2.0 security token, issued by Google, in response to the token exchange request. Tokens can vary in size, depending in part on the size of mapped claims, up to a maximum of 12288 bytes (12 KB). Google reserves the right to change the token size and the maximum length at any time.
   "expires_in": 42, # The amount of time, in seconds, between the time when the access token was issued and the time when the access token will expire. This field is absent when the `subject_token` in the request is a Google-issued, short-lived access token. In this case, the access token has the same expiration time as the `subject_token`.
   "issued_token_type": "A String", # The token type. Always matches the value of `requested_token_type` from the request.
diff --git a/docs/dyn/workstations_v1.projects.locations.workstationClusters.workstationConfigs.html b/docs/dyn/workstations_v1.projects.locations.workstationClusters.workstationConfigs.html
index 1bd66d046c5..f70a358cd7f 100644
--- a/docs/dyn/workstations_v1.projects.locations.workstationClusters.workstationConfigs.html
+++ b/docs/dyn/workstations_v1.projects.locations.workstationClusters.workstationConfigs.html
@@ -170,7 +170,7 @@ Method Details
   "deleteTime": "A String", # Output only. Time when this workstation configuration was soft-deleted.
   "disableTcpConnections": True or False, # Optional. Disables support for plain TCP connections in the workstation. By default the service supports TCP connections through a websocket relay. Setting this option to true disables that relay, which prevents the usage of services that require plain TCP connections, such as SSH. When enabled, all communication must occur over HTTPS or WSS.
   "displayName": "A String", # Optional. Human-readable name for this workstation configuration.
-  "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](http://cloud/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
+  "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](https://cloud.google.com/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
   "encryptionKey": { # A customer-managed encryption key (CMEK) for the Compute Engine resources of the associated workstation configuration. Specify the name of your Cloud KMS encryption key and the default service account. We recommend that you use a separate service account and follow [Cloud KMS best practices](https://cloud.google.com/kms/docs/separation-of-duties). # Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key (CMEK). If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk might be lost. If the encryption key is revoked, the workstation session automatically stops within 7 hours. Immutable after the workstation configuration is created.
     "kmsKey": "A String", # Immutable. The name of the Google Cloud KMS encryption key. For example, `"projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"`. The key must be in the same region as the workstation configuration.
     "kmsKeyServiceAccount": "A String", # Immutable. The service account to use with the specified KMS key. We recommend that you use a separate service account and follow KMS best practices. For more information, see [Separation of duties](https://cloud.google.com/kms/docs/separation-of-duties) and `gcloud kms keys add-iam-policy-binding` [`--member`](https://cloud.google.com/sdk/gcloud/reference/kms/keys/add-iam-policy-binding#--member).
@@ -227,7 +227,7 @@ Method Details
   "labels": { # Optional. [Labels](https://cloud.google.com/workstations/docs/label-resources) that are applied to the workstation configuration and that are also propagated to the underlying Compute Engine resources.
     "a_key": "A String",
   },
-  "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this config a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified defaults to 0 which indicates unlimited.
+  "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this configuration a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified, defaults to `0`, which indicates unlimited.
   "name": "A String", # Identifier. Full name of this workstation configuration.
   "persistentDirectories": [ # Optional. Directories to persist across workstation sessions.
     { # A directory to persist across workstation sessions.
@@ -379,7 +379,7 @@ Method Details
   "deleteTime": "A String", # Output only. Time when this workstation configuration was soft-deleted.
   "disableTcpConnections": True or False, # Optional. Disables support for plain TCP connections in the workstation. By default the service supports TCP connections through a websocket relay. Setting this option to true disables that relay, which prevents the usage of services that require plain TCP connections, such as SSH. When enabled, all communication must occur over HTTPS or WSS.
   "displayName": "A String", # Optional. Human-readable name for this workstation configuration.
-  "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](http://cloud/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
+  "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](https://cloud.google.com/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
   "encryptionKey": { # A customer-managed encryption key (CMEK) for the Compute Engine resources of the associated workstation configuration. Specify the name of your Cloud KMS encryption key and the default service account. We recommend that you use a separate service account and follow [Cloud KMS best practices](https://cloud.google.com/kms/docs/separation-of-duties). # Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key (CMEK). If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk might be lost. If the encryption key is revoked, the workstation session automatically stops within 7 hours. Immutable after the workstation configuration is created.
     "kmsKey": "A String", # Immutable. The name of the Google Cloud KMS encryption key. For example, `"projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"`. The key must be in the same region as the workstation configuration.
     "kmsKeyServiceAccount": "A String", # Immutable. The service account to use with the specified KMS key. We recommend that you use a separate service account and follow KMS best practices. For more information, see [Separation of duties](https://cloud.google.com/kms/docs/separation-of-duties) and `gcloud kms keys add-iam-policy-binding` [`--member`](https://cloud.google.com/sdk/gcloud/reference/kms/keys/add-iam-policy-binding#--member).
@@ -436,7 +436,7 @@ Method Details
   "labels": { # Optional. [Labels](https://cloud.google.com/workstations/docs/label-resources) that are applied to the workstation configuration and that are also propagated to the underlying Compute Engine resources.
     "a_key": "A String",
   },
-  "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this config a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified defaults to 0 which indicates unlimited.
+  "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this configuration a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified, defaults to `0`, which indicates unlimited.
   "name": "A String", # Identifier. Full name of this workstation configuration.
   "persistentDirectories": [ # Optional. Directories to persist across workstation sessions.
     { # A directory to persist across workstation sessions.
@@ -576,7 +576,7 @@ Method Details
       "deleteTime": "A String", # Output only. Time when this workstation configuration was soft-deleted.
       "disableTcpConnections": True or False, # Optional. Disables support for plain TCP connections in the workstation. By default the service supports TCP connections through a websocket relay. Setting this option to true disables that relay, which prevents the usage of services that require plain TCP connections, such as SSH. When enabled, all communication must occur over HTTPS or WSS.
       "displayName": "A String", # Optional. Human-readable name for this workstation configuration.
-      "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](http://cloud/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
+      "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](https://cloud.google.com/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
       "encryptionKey": { # A customer-managed encryption key (CMEK) for the Compute Engine resources of the associated workstation configuration. Specify the name of your Cloud KMS encryption key and the default service account. We recommend that you use a separate service account and follow [Cloud KMS best practices](https://cloud.google.com/kms/docs/separation-of-duties). # Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key (CMEK). If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk might be lost. If the encryption key is revoked, the workstation session automatically stops within 7 hours. Immutable after the workstation configuration is created.
         "kmsKey": "A String", # Immutable. The name of the Google Cloud KMS encryption key. For example, `"projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"`. The key must be in the same region as the workstation configuration.
         "kmsKeyServiceAccount": "A String", # Immutable. The service account to use with the specified KMS key. We recommend that you use a separate service account and follow KMS best practices. For more information, see [Separation of duties](https://cloud.google.com/kms/docs/separation-of-duties) and `gcloud kms keys add-iam-policy-binding` [`--member`](https://cloud.google.com/sdk/gcloud/reference/kms/keys/add-iam-policy-binding#--member).
@@ -633,7 +633,7 @@ Method Details
       "labels": { # Optional. [Labels](https://cloud.google.com/workstations/docs/label-resources) that are applied to the workstation configuration and that are also propagated to the underlying Compute Engine resources.
         "a_key": "A String",
       },
-      "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this config a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified defaults to 0 which indicates unlimited.
+      "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this configuration a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified, defaults to `0`, which indicates unlimited.
       "name": "A String", # Identifier. Full name of this workstation configuration.
       "persistentDirectories": [ # Optional. Directories to persist across workstation sessions.
         { # A directory to persist across workstation sessions.
@@ -727,7 +727,7 @@ Method Details
       "deleteTime": "A String", # Output only. Time when this workstation configuration was soft-deleted.
       "disableTcpConnections": True or False, # Optional. Disables support for plain TCP connections in the workstation. By default the service supports TCP connections through a websocket relay. Setting this option to true disables that relay, which prevents the usage of services that require plain TCP connections, such as SSH. When enabled, all communication must occur over HTTPS or WSS.
       "displayName": "A String", # Optional. Human-readable name for this workstation configuration.
-      "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](http://cloud/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
+      "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](https://cloud.google.com/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
       "encryptionKey": { # A customer-managed encryption key (CMEK) for the Compute Engine resources of the associated workstation configuration. Specify the name of your Cloud KMS encryption key and the default service account. We recommend that you use a separate service account and follow [Cloud KMS best practices](https://cloud.google.com/kms/docs/separation-of-duties). # Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key (CMEK). If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk might be lost. If the encryption key is revoked, the workstation session automatically stops within 7 hours. Immutable after the workstation configuration is created.
         "kmsKey": "A String", # Immutable. The name of the Google Cloud KMS encryption key. For example, `"projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"`. The key must be in the same region as the workstation configuration.
         "kmsKeyServiceAccount": "A String", # Immutable. The service account to use with the specified KMS key. We recommend that you use a separate service account and follow KMS best practices. For more information, see [Separation of duties](https://cloud.google.com/kms/docs/separation-of-duties) and `gcloud kms keys add-iam-policy-binding` [`--member`](https://cloud.google.com/sdk/gcloud/reference/kms/keys/add-iam-policy-binding#--member).
@@ -784,7 +784,7 @@ Method Details
       "labels": { # Optional. [Labels](https://cloud.google.com/workstations/docs/label-resources) that are applied to the workstation configuration and that are also propagated to the underlying Compute Engine resources.
         "a_key": "A String",
       },
-      "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this config a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified defaults to 0 which indicates unlimited.
+      "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this configuration a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified, defaults to `0`, which indicates unlimited.
       "name": "A String", # Identifier. Full name of this workstation configuration.
       "persistentDirectories": [ # Optional. Directories to persist across workstation sessions.
         { # A directory to persist across workstation sessions.
@@ -893,7 +893,7 @@ Method Details
   "deleteTime": "A String", # Output only. Time when this workstation configuration was soft-deleted.
   "disableTcpConnections": True or False, # Optional. Disables support for plain TCP connections in the workstation. By default the service supports TCP connections through a websocket relay. Setting this option to true disables that relay, which prevents the usage of services that require plain TCP connections, such as SSH. When enabled, all communication must occur over HTTPS or WSS.
   "displayName": "A String", # Optional. Human-readable name for this workstation configuration.
-  "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](http://cloud/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
+  "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](https://cloud.google.com/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
   "encryptionKey": { # A customer-managed encryption key (CMEK) for the Compute Engine resources of the associated workstation configuration. Specify the name of your Cloud KMS encryption key and the default service account. We recommend that you use a separate service account and follow [Cloud KMS best practices](https://cloud.google.com/kms/docs/separation-of-duties). # Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key (CMEK). If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk might be lost. If the encryption key is revoked, the workstation session automatically stops within 7 hours. Immutable after the workstation configuration is created.
     "kmsKey": "A String", # Immutable. The name of the Google Cloud KMS encryption key. For example, `"projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"`. The key must be in the same region as the workstation configuration.
     "kmsKeyServiceAccount": "A String", # Immutable. The service account to use with the specified KMS key. We recommend that you use a separate service account and follow KMS best practices. For more information, see [Separation of duties](https://cloud.google.com/kms/docs/separation-of-duties) and `gcloud kms keys add-iam-policy-binding` [`--member`](https://cloud.google.com/sdk/gcloud/reference/kms/keys/add-iam-policy-binding#--member).
@@ -950,7 +950,7 @@ Method Details
   "labels": { # Optional. [Labels](https://cloud.google.com/workstations/docs/label-resources) that are applied to the workstation configuration and that are also propagated to the underlying Compute Engine resources.
     "a_key": "A String",
   },
-  "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this config a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified defaults to 0 which indicates unlimited.
+  "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this configuration a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified, defaults to `0`, which indicates unlimited.
   "name": "A String", # Identifier. Full name of this workstation configuration.
   "persistentDirectories": [ # Optional. Directories to persist across workstation sessions.
     { # A directory to persist across workstation sessions.
diff --git a/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.html b/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.html
index 19c511a5fb3..f31a1fbac05 100644
--- a/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.html
+++ b/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.html
@@ -170,7 +170,7 @@ Method Details
   "deleteTime": "A String", # Output only. Time when this workstation configuration was soft-deleted.
   "disableTcpConnections": True or False, # Optional. Disables support for plain TCP connections in the workstation. By default the service supports TCP connections through a websocket relay. Setting this option to true disables that relay, which prevents the usage of services that require plain TCP connections, such as SSH. When enabled, all communication must occur over HTTPS or WSS.
   "displayName": "A String", # Optional. Human-readable name for this workstation configuration.
-  "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](http://cloud/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
+  "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](https://cloud.google.com/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
   "encryptionKey": { # A customer-managed encryption key (CMEK) for the Compute Engine resources of the associated workstation configuration. Specify the name of your Cloud KMS encryption key and the default service account. We recommend that you use a separate service account and follow [Cloud KMS best practices](https://cloud.google.com/kms/docs/separation-of-duties). # Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key (CMEK). If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk might be lost. If the encryption key is revoked, the workstation session automatically stops within 7 hours. Immutable after the workstation configuration is created.
     "kmsKey": "A String", # Immutable. The name of the Google Cloud KMS encryption key. For example, `"projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"`. The key must be in the same region as the workstation configuration.
     "kmsKeyServiceAccount": "A String", # Immutable. The service account to use with the specified KMS key. We recommend that you use a separate service account and follow KMS best practices. For more information, see [Separation of duties](https://cloud.google.com/kms/docs/separation-of-duties) and `gcloud kms keys add-iam-policy-binding` [`--member`](https://cloud.google.com/sdk/gcloud/reference/kms/keys/add-iam-policy-binding#--member).
@@ -206,7 +206,7 @@ Method Details
           ],
           "bootDiskSizeGb": 42, # Optional. The size of the boot disk for the VM in gigabytes (GB). The minimum boot disk size is `30` GB. Defaults to `50` GB.
           "enableNestedVirtualization": True or False, # Optional. Whether to enable nested virtualization on boosted Cloud Workstations VMs running using this boost configuration. Defaults to false. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the [same restrictions as Compute Engine instances](https://cloud.google.com/compute/docs/instances/nested-virtualization/overview#restrictions): * **Organization policy**: projects, folders, or organizations may be restricted from creating nested VMs if the **Disable VM nested virtualization** constraint is enforced in the organization policy. For more information, see the Compute Engine section, [Checking whether nested virtualization is allowed](https://cloud.google.com/compute/docs/instances/nested-virtualization/managing-constraint#checking_whether_nested_virtualization_is_allowed). * **Performance**: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * **Machine Type**: nested virtualization can only be enabled on boost configurations that specify a machine_type in the N1 or N2 machine series.
-          "id": "A String", # Optional. Required. The id to be used for the boost config.
+          "id": "A String", # Optional. Required. The id to be used for the boost configuration.
           "machineType": "A String", # Optional. The type of machine that boosted VM instances will use—for example, `e2-standard-4`. For more information about machine types that Cloud Workstations supports, see the list of [available machine types](https://cloud.google.com/workstations/docs/available-machine-types). Defaults to `e2-standard-4`.
           "poolSize": 42, # Optional. The number of boost VMs that the system should keep idle so that workstations can be boosted quickly. Defaults to `0`.
         },
@@ -245,7 +245,7 @@ Method Details
   "labels": { # Optional. [Labels](https://cloud.google.com/workstations/docs/label-resources) that are applied to the workstation configuration and that are also propagated to the underlying Compute Engine resources.
     "a_key": "A String",
   },
-  "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this config a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified defaults to 0 which indicates unlimited.
+  "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this configuration a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified, defaults to `0`, which indicates unlimited.
   "name": "A String", # Identifier. Full name of this workstation configuration.
   "persistentDirectories": [ # Optional. Directories to persist across workstation sessions.
     { # A directory to persist across workstation sessions.
@@ -399,7 +399,7 @@ Method Details
   "deleteTime": "A String", # Output only. Time when this workstation configuration was soft-deleted.
   "disableTcpConnections": True or False, # Optional. Disables support for plain TCP connections in the workstation. By default the service supports TCP connections through a websocket relay. Setting this option to true disables that relay, which prevents the usage of services that require plain TCP connections, such as SSH. When enabled, all communication must occur over HTTPS or WSS.
   "displayName": "A String", # Optional. Human-readable name for this workstation configuration.
-  "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](http://cloud/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
+  "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](https://cloud.google.com/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
   "encryptionKey": { # A customer-managed encryption key (CMEK) for the Compute Engine resources of the associated workstation configuration. Specify the name of your Cloud KMS encryption key and the default service account. We recommend that you use a separate service account and follow [Cloud KMS best practices](https://cloud.google.com/kms/docs/separation-of-duties). # Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key (CMEK). If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk might be lost. If the encryption key is revoked, the workstation session automatically stops within 7 hours. Immutable after the workstation configuration is created.
     "kmsKey": "A String", # Immutable. The name of the Google Cloud KMS encryption key. For example, `"projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"`. The key must be in the same region as the workstation configuration.
     "kmsKeyServiceAccount": "A String", # Immutable. The service account to use with the specified KMS key. We recommend that you use a separate service account and follow KMS best practices. For more information, see [Separation of duties](https://cloud.google.com/kms/docs/separation-of-duties) and `gcloud kms keys add-iam-policy-binding` [`--member`](https://cloud.google.com/sdk/gcloud/reference/kms/keys/add-iam-policy-binding#--member).
@@ -435,7 +435,7 @@ Method Details
           ],
           "bootDiskSizeGb": 42, # Optional. The size of the boot disk for the VM in gigabytes (GB). The minimum boot disk size is `30` GB. Defaults to `50` GB.
           "enableNestedVirtualization": True or False, # Optional. Whether to enable nested virtualization on boosted Cloud Workstations VMs running using this boost configuration. Defaults to false. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the [same restrictions as Compute Engine instances](https://cloud.google.com/compute/docs/instances/nested-virtualization/overview#restrictions): * **Organization policy**: projects, folders, or organizations may be restricted from creating nested VMs if the **Disable VM nested virtualization** constraint is enforced in the organization policy. For more information, see the Compute Engine section, [Checking whether nested virtualization is allowed](https://cloud.google.com/compute/docs/instances/nested-virtualization/managing-constraint#checking_whether_nested_virtualization_is_allowed). * **Performance**: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * **Machine Type**: nested virtualization can only be enabled on boost configurations that specify a machine_type in the N1 or N2 machine series.
-          "id": "A String", # Optional. Required. The id to be used for the boost config.
+          "id": "A String", # Optional. Required. The id to be used for the boost configuration.
           "machineType": "A String", # Optional. The type of machine that boosted VM instances will use—for example, `e2-standard-4`. For more information about machine types that Cloud Workstations supports, see the list of [available machine types](https://cloud.google.com/workstations/docs/available-machine-types). Defaults to `e2-standard-4`.
           "poolSize": 42, # Optional. The number of boost VMs that the system should keep idle so that workstations can be boosted quickly. Defaults to `0`.
         },
@@ -474,7 +474,7 @@ Method Details
   "labels": { # Optional. [Labels](https://cloud.google.com/workstations/docs/label-resources) that are applied to the workstation configuration and that are also propagated to the underlying Compute Engine resources.
     "a_key": "A String",
   },
-  "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this config a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified defaults to 0 which indicates unlimited.
+  "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this configuration a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified, defaults to `0`, which indicates unlimited.
   "name": "A String", # Identifier. Full name of this workstation configuration.
   "persistentDirectories": [ # Optional. Directories to persist across workstation sessions.
     { # A directory to persist across workstation sessions.
@@ -616,7 +616,7 @@ Method Details
       "deleteTime": "A String", # Output only. Time when this workstation configuration was soft-deleted.
       "disableTcpConnections": True or False, # Optional. Disables support for plain TCP connections in the workstation. By default the service supports TCP connections through a websocket relay. Setting this option to true disables that relay, which prevents the usage of services that require plain TCP connections, such as SSH. When enabled, all communication must occur over HTTPS or WSS.
       "displayName": "A String", # Optional. Human-readable name for this workstation configuration.
-      "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](http://cloud/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
+      "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](https://cloud.google.com/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
       "encryptionKey": { # A customer-managed encryption key (CMEK) for the Compute Engine resources of the associated workstation configuration. Specify the name of your Cloud KMS encryption key and the default service account. We recommend that you use a separate service account and follow [Cloud KMS best practices](https://cloud.google.com/kms/docs/separation-of-duties). # Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key (CMEK). If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk might be lost. If the encryption key is revoked, the workstation session automatically stops within 7 hours. Immutable after the workstation configuration is created.
         "kmsKey": "A String", # Immutable. The name of the Google Cloud KMS encryption key. For example, `"projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"`. The key must be in the same region as the workstation configuration.
         "kmsKeyServiceAccount": "A String", # Immutable. The service account to use with the specified KMS key. We recommend that you use a separate service account and follow KMS best practices. For more information, see [Separation of duties](https://cloud.google.com/kms/docs/separation-of-duties) and `gcloud kms keys add-iam-policy-binding` [`--member`](https://cloud.google.com/sdk/gcloud/reference/kms/keys/add-iam-policy-binding#--member).
@@ -652,7 +652,7 @@ Method Details
               ],
               "bootDiskSizeGb": 42, # Optional. The size of the boot disk for the VM in gigabytes (GB). The minimum boot disk size is `30` GB. Defaults to `50` GB.
               "enableNestedVirtualization": True or False, # Optional. Whether to enable nested virtualization on boosted Cloud Workstations VMs running using this boost configuration. Defaults to false. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the [same restrictions as Compute Engine instances](https://cloud.google.com/compute/docs/instances/nested-virtualization/overview#restrictions): * **Organization policy**: projects, folders, or organizations may be restricted from creating nested VMs if the **Disable VM nested virtualization** constraint is enforced in the organization policy. For more information, see the Compute Engine section, [Checking whether nested virtualization is allowed](https://cloud.google.com/compute/docs/instances/nested-virtualization/managing-constraint#checking_whether_nested_virtualization_is_allowed). * **Performance**: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * **Machine Type**: nested virtualization can only be enabled on boost configurations that specify a machine_type in the N1 or N2 machine series.
-              "id": "A String", # Optional. Required. The id to be used for the boost config.
+              "id": "A String", # Optional. Required. The id to be used for the boost configuration.
               "machineType": "A String", # Optional. The type of machine that boosted VM instances will use—for example, `e2-standard-4`. For more information about machine types that Cloud Workstations supports, see the list of [available machine types](https://cloud.google.com/workstations/docs/available-machine-types). Defaults to `e2-standard-4`.
               "poolSize": 42, # Optional. The number of boost VMs that the system should keep idle so that workstations can be boosted quickly. Defaults to `0`.
             },
@@ -691,7 +691,7 @@ Method Details
       "labels": { # Optional. [Labels](https://cloud.google.com/workstations/docs/label-resources) that are applied to the workstation configuration and that are also propagated to the underlying Compute Engine resources.
         "a_key": "A String",
       },
-      "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this config a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified defaults to 0 which indicates unlimited.
+      "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this configuration a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified, defaults to `0`, which indicates unlimited.
       "name": "A String", # Identifier. Full name of this workstation configuration.
       "persistentDirectories": [ # Optional. Directories to persist across workstation sessions.
         { # A directory to persist across workstation sessions.
@@ -787,7 +787,7 @@ Method Details
       "deleteTime": "A String", # Output only. Time when this workstation configuration was soft-deleted.
       "disableTcpConnections": True or False, # Optional. Disables support for plain TCP connections in the workstation. By default the service supports TCP connections through a websocket relay. Setting this option to true disables that relay, which prevents the usage of services that require plain TCP connections, such as SSH. When enabled, all communication must occur over HTTPS or WSS.
       "displayName": "A String", # Optional. Human-readable name for this workstation configuration.
-      "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](http://cloud/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
+      "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](https://cloud.google.com/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
       "encryptionKey": { # A customer-managed encryption key (CMEK) for the Compute Engine resources of the associated workstation configuration. Specify the name of your Cloud KMS encryption key and the default service account. We recommend that you use a separate service account and follow [Cloud KMS best practices](https://cloud.google.com/kms/docs/separation-of-duties). # Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key (CMEK). If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk might be lost. If the encryption key is revoked, the workstation session automatically stops within 7 hours. Immutable after the workstation configuration is created.
         "kmsKey": "A String", # Immutable. The name of the Google Cloud KMS encryption key. For example, `"projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"`. The key must be in the same region as the workstation configuration.
         "kmsKeyServiceAccount": "A String", # Immutable. The service account to use with the specified KMS key. We recommend that you use a separate service account and follow KMS best practices. For more information, see [Separation of duties](https://cloud.google.com/kms/docs/separation-of-duties) and `gcloud kms keys add-iam-policy-binding` [`--member`](https://cloud.google.com/sdk/gcloud/reference/kms/keys/add-iam-policy-binding#--member).
@@ -823,7 +823,7 @@ Method Details
               ],
               "bootDiskSizeGb": 42, # Optional. The size of the boot disk for the VM in gigabytes (GB). The minimum boot disk size is `30` GB. Defaults to `50` GB.
               "enableNestedVirtualization": True or False, # Optional. Whether to enable nested virtualization on boosted Cloud Workstations VMs running using this boost configuration. Defaults to false. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the [same restrictions as Compute Engine instances](https://cloud.google.com/compute/docs/instances/nested-virtualization/overview#restrictions): * **Organization policy**: projects, folders, or organizations may be restricted from creating nested VMs if the **Disable VM nested virtualization** constraint is enforced in the organization policy. For more information, see the Compute Engine section, [Checking whether nested virtualization is allowed](https://cloud.google.com/compute/docs/instances/nested-virtualization/managing-constraint#checking_whether_nested_virtualization_is_allowed). * **Performance**: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * **Machine Type**: nested virtualization can only be enabled on boost configurations that specify a machine_type in the N1 or N2 machine series.
-              "id": "A String", # Optional. Required. The id to be used for the boost config.
+              "id": "A String", # Optional. Required. The id to be used for the boost configuration.
               "machineType": "A String", # Optional. The type of machine that boosted VM instances will use—for example, `e2-standard-4`. For more information about machine types that Cloud Workstations supports, see the list of [available machine types](https://cloud.google.com/workstations/docs/available-machine-types). Defaults to `e2-standard-4`.
               "poolSize": 42, # Optional. The number of boost VMs that the system should keep idle so that workstations can be boosted quickly. Defaults to `0`.
             },
@@ -862,7 +862,7 @@ Method Details
       "labels": { # Optional. [Labels](https://cloud.google.com/workstations/docs/label-resources) that are applied to the workstation configuration and that are also propagated to the underlying Compute Engine resources.
         "a_key": "A String",
       },
-      "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this config a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified defaults to 0 which indicates unlimited.
+      "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this configuration a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified, defaults to `0`, which indicates unlimited.
       "name": "A String", # Identifier. Full name of this workstation configuration.
       "persistentDirectories": [ # Optional. Directories to persist across workstation sessions.
         { # A directory to persist across workstation sessions.
@@ -973,7 +973,7 @@ Method Details
   "deleteTime": "A String", # Output only. Time when this workstation configuration was soft-deleted.
   "disableTcpConnections": True or False, # Optional. Disables support for plain TCP connections in the workstation. By default the service supports TCP connections through a websocket relay. Setting this option to true disables that relay, which prevents the usage of services that require plain TCP connections, such as SSH. When enabled, all communication must occur over HTTPS or WSS.
   "displayName": "A String", # Optional. Human-readable name for this workstation configuration.
-  "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](http://cloud/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
+  "enableAuditAgent": True or False, # Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](https://cloud.google.com/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type="gce_instance" log_name:"/logs/linux-auditd"
   "encryptionKey": { # A customer-managed encryption key (CMEK) for the Compute Engine resources of the associated workstation configuration. Specify the name of your Cloud KMS encryption key and the default service account. We recommend that you use a separate service account and follow [Cloud KMS best practices](https://cloud.google.com/kms/docs/separation-of-duties). # Immutable. Encrypts resources of this workstation configuration using a customer-managed encryption key (CMEK). If specified, the boot disk of the Compute Engine instance and the persistent disk are encrypted using this encryption key. If this field is not set, the disks are encrypted using a generated key. Customer-managed encryption keys do not protect disk metadata. If the customer-managed encryption key is rotated, when the workstation instance is stopped, the system attempts to recreate the persistent disk with the new version of the key. Be sure to keep older versions of the key until the persistent disk is recreated. Otherwise, data on the persistent disk might be lost. If the encryption key is revoked, the workstation session automatically stops within 7 hours. Immutable after the workstation configuration is created.
     "kmsKey": "A String", # Immutable. The name of the Google Cloud KMS encryption key. For example, `"projects/PROJECT_ID/locations/REGION/keyRings/KEY_RING/cryptoKeys/KEY_NAME"`. The key must be in the same region as the workstation configuration.
     "kmsKeyServiceAccount": "A String", # Immutable. The service account to use with the specified KMS key. We recommend that you use a separate service account and follow KMS best practices. For more information, see [Separation of duties](https://cloud.google.com/kms/docs/separation-of-duties) and `gcloud kms keys add-iam-policy-binding` [`--member`](https://cloud.google.com/sdk/gcloud/reference/kms/keys/add-iam-policy-binding#--member).
@@ -1009,7 +1009,7 @@ Method Details
           ],
           "bootDiskSizeGb": 42, # Optional. The size of the boot disk for the VM in gigabytes (GB). The minimum boot disk size is `30` GB. Defaults to `50` GB.
           "enableNestedVirtualization": True or False, # Optional. Whether to enable nested virtualization on boosted Cloud Workstations VMs running using this boost configuration. Defaults to false. Nested virtualization lets you run virtual machine (VM) instances inside your workstation. Before enabling nested virtualization, consider the following important considerations. Cloud Workstations instances are subject to the [same restrictions as Compute Engine instances](https://cloud.google.com/compute/docs/instances/nested-virtualization/overview#restrictions): * **Organization policy**: projects, folders, or organizations may be restricted from creating nested VMs if the **Disable VM nested virtualization** constraint is enforced in the organization policy. For more information, see the Compute Engine section, [Checking whether nested virtualization is allowed](https://cloud.google.com/compute/docs/instances/nested-virtualization/managing-constraint#checking_whether_nested_virtualization_is_allowed). * **Performance**: nested VMs might experience a 10% or greater decrease in performance for workloads that are CPU-bound and possibly greater than a 10% decrease for workloads that are input/output bound. * **Machine Type**: nested virtualization can only be enabled on boost configurations that specify a machine_type in the N1 or N2 machine series.
-          "id": "A String", # Optional. Required. The id to be used for the boost config.
+          "id": "A String", # Optional. Required. The id to be used for the boost configuration.
           "machineType": "A String", # Optional. The type of machine that boosted VM instances will use—for example, `e2-standard-4`. For more information about machine types that Cloud Workstations supports, see the list of [available machine types](https://cloud.google.com/workstations/docs/available-machine-types). Defaults to `e2-standard-4`.
           "poolSize": 42, # Optional. The number of boost VMs that the system should keep idle so that workstations can be boosted quickly. Defaults to `0`.
         },
@@ -1048,7 +1048,7 @@ Method Details
   "labels": { # Optional. [Labels](https://cloud.google.com/workstations/docs/label-resources) that are applied to the workstation configuration and that are also propagated to the underlying Compute Engine resources.
     "a_key": "A String",
   },
-  "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this config a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified defaults to 0 which indicates unlimited.
+  "maxUsableWorkstations": 42, # Optional. Maximum number of workstations under this configuration a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified, defaults to `0`, which indicates unlimited.
   "name": "A String", # Identifier. Full name of this workstation configuration.
   "persistentDirectories": [ # Optional. Directories to persist across workstation sessions.
     { # A directory to persist across workstation sessions.
diff --git a/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.workstations.html b/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.workstations.html
index 726af00b263..cc4dbfd203b 100644
--- a/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.workstations.html
+++ b/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.workstations.html
@@ -138,9 +138,9 @@ Method Details
   "annotations": { # Optional. Client-specified annotations.
     "a_key": "A String",
   },
-  "boostConfigs": [ # Output only. List of available boost configuration ids that this workstation can be boosted up to
-    { # Boost config for this workstation. This object is populated from the parent workstation config.
-      "id": "A String", # Output only. Boost config id.
+  "boostConfigs": [ # Output only. List of available boost configuration IDs that this workstation can be boosted up to.
+    { # Boost configuration for this workstation. This object is populated from the parent workstation configuration.
+      "id": "A String", # Output only. Boost configuration ID.
     },
   ],
   "createTime": "A String", # Output only. Time when this workstation was created.
@@ -281,9 +281,9 @@ Method Details
   "annotations": { # Optional. Client-specified annotations.
     "a_key": "A String",
   },
-  "boostConfigs": [ # Output only. List of available boost configuration ids that this workstation can be boosted up to
-    { # Boost config for this workstation. This object is populated from the parent workstation config.
-      "id": "A String", # Output only. Boost config id.
+  "boostConfigs": [ # Output only. List of available boost configuration IDs that this workstation can be boosted up to.
+    { # Boost configuration for this workstation. This object is populated from the parent workstation configuration.
+      "id": "A String", # Output only. Boost configuration ID.
     },
   ],
   "createTime": "A String", # Output only. Time when this workstation was created.
@@ -384,9 +384,9 @@ Method Details
       "annotations": { # Optional. Client-specified annotations.
         "a_key": "A String",
       },
-      "boostConfigs": [ # Output only. List of available boost configuration ids that this workstation can be boosted up to
-        { # Boost config for this workstation. This object is populated from the parent workstation config.
-          "id": "A String", # Output only. Boost config id.
+      "boostConfigs": [ # Output only. List of available boost configuration IDs that this workstation can be boosted up to.
+        { # Boost configuration for this workstation. This object is populated from the parent workstation configuration.
+          "id": "A String", # Output only. Boost configuration ID.
         },
       ],
       "createTime": "A String", # Output only. Time when this workstation was created.
@@ -441,9 +441,9 @@ Method Details
       "annotations": { # Optional. Client-specified annotations.
         "a_key": "A String",
       },
-      "boostConfigs": [ # Output only. List of available boost configuration ids that this workstation can be boosted up to
-        { # Boost config for this workstation. This object is populated from the parent workstation config.
-          "id": "A String", # Output only. Boost config id.
+      "boostConfigs": [ # Output only. List of available boost configuration IDs that this workstation can be boosted up to.
+        { # Boost configuration for this workstation. This object is populated from the parent workstation configuration.
+          "id": "A String", # Output only. Boost configuration ID.
         },
       ],
       "createTime": "A String", # Output only. Time when this workstation was created.
@@ -513,9 +513,9 @@ Method Details
   "annotations": { # Optional. Client-specified annotations.
     "a_key": "A String",
   },
-  "boostConfigs": [ # Output only. List of available boost configuration ids that this workstation can be boosted up to
-    { # Boost config for this workstation. This object is populated from the parent workstation config.
-      "id": "A String", # Output only. Boost config id.
+  "boostConfigs": [ # Output only. List of available boost configuration IDs that this workstation can be boosted up to.
+    { # Boost configuration for this workstation. This object is populated from the parent workstation configuration.
+      "id": "A String", # Output only. Boost configuration ID.
     },
   ],
   "createTime": "A String", # Output only. Time when this workstation was created.
diff --git a/docs/dyn/youtube_v3.videos.html b/docs/dyn/youtube_v3.videos.html
index 60567181de6..6fe2c546380 100644
--- a/docs/dyn/youtube_v3.videos.html
+++ b/docs/dyn/youtube_v3.videos.html
@@ -401,7 +401,7 @@ Method Details
     "likeCount": "A String", # The number of users who have indicated that they liked the video by giving it a positive rating.
     "viewCount": "A String", # The number of times the video has been viewed.
   },
-  "status": { # Basic details about a video category, such as its localized title. Next Id: 18 # The status object contains information about the video's uploading, processing, and privacy statuses.
+  "status": { # Basic details about a video category, such as its localized title. Next Id: 19 # The status object contains information about the video's uploading, processing, and privacy statuses.
     "embeddable": True or False, # This value indicates if the video can be embedded on another website. @mutable youtube.videos.insert youtube.videos.update
     "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the uploadStatus property indicates that the upload failed.
     "license": "A String", # The video's license. @mutable youtube.videos.insert youtube.videos.update
@@ -705,7 +705,7 @@ Method Details
     "likeCount": "A String", # The number of users who have indicated that they liked the video by giving it a positive rating.
     "viewCount": "A String", # The number of times the video has been viewed.
   },
-  "status": { # Basic details about a video category, such as its localized title. Next Id: 18 # The status object contains information about the video's uploading, processing, and privacy statuses.
+  "status": { # Basic details about a video category, such as its localized title. Next Id: 19 # The status object contains information about the video's uploading, processing, and privacy statuses.
     "embeddable": True or False, # This value indicates if the video can be embedded on another website. @mutable youtube.videos.insert youtube.videos.update
     "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the uploadStatus property indicates that the upload failed.
     "license": "A String", # The video's license. @mutable youtube.videos.insert youtube.videos.update
@@ -1032,7 +1032,7 @@ Method Details
         "likeCount": "A String", # The number of users who have indicated that they liked the video by giving it a positive rating.
         "viewCount": "A String", # The number of times the video has been viewed.
       },
-      "status": { # Basic details about a video category, such as its localized title. Next Id: 18 # The status object contains information about the video's uploading, processing, and privacy statuses.
+      "status": { # Basic details about a video category, such as its localized title. Next Id: 19 # The status object contains information about the video's uploading, processing, and privacy statuses.
         "embeddable": True or False, # This value indicates if the video can be embedded on another website. @mutable youtube.videos.insert youtube.videos.update
         "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the uploadStatus property indicates that the upload failed.
         "license": "A String", # The video's license. @mutable youtube.videos.insert youtube.videos.update
@@ -1399,7 +1399,7 @@ Method Details
     "likeCount": "A String", # The number of users who have indicated that they liked the video by giving it a positive rating.
     "viewCount": "A String", # The number of times the video has been viewed.
   },
-  "status": { # Basic details about a video category, such as its localized title. Next Id: 18 # The status object contains information about the video's uploading, processing, and privacy statuses.
+  "status": { # Basic details about a video category, such as its localized title. Next Id: 19 # The status object contains information about the video's uploading, processing, and privacy statuses.
     "embeddable": True or False, # This value indicates if the video can be embedded on another website. @mutable youtube.videos.insert youtube.videos.update
     "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the uploadStatus property indicates that the upload failed.
     "license": "A String", # The video's license. @mutable youtube.videos.insert youtube.videos.update
@@ -1697,7 +1697,7 @@ Method Details
     "likeCount": "A String", # The number of users who have indicated that they liked the video by giving it a positive rating.
     "viewCount": "A String", # The number of times the video has been viewed.
   },
-  "status": { # Basic details about a video category, such as its localized title. Next Id: 18 # The status object contains information about the video's uploading, processing, and privacy statuses.
+  "status": { # Basic details about a video category, such as its localized title. Next Id: 19 # The status object contains information about the video's uploading, processing, and privacy statuses.
     "embeddable": True or False, # This value indicates if the video can be embedded on another website. @mutable youtube.videos.insert youtube.videos.update
     "failureReason": "A String", # This value explains why a video failed to upload. This property is only present if the uploadStatus property indicates that the upload failed.
     "license": "A String", # The video's license. @mutable youtube.videos.insert youtube.videos.update
diff --git a/googleapiclient/discovery_cache/documents/androidpublisher.v3.json b/googleapiclient/discovery_cache/documents/androidpublisher.v3.json
index d17420a7b0e..f1e9573665a 100644
--- a/googleapiclient/discovery_cache/documents/androidpublisher.v3.json
+++ b/googleapiclient/discovery_cache/documents/androidpublisher.v3.json
@@ -4732,7 +4732,7 @@
 }
 }
 },
-"revision": "20240821",
+"revision": "20240912",
 "rootUrl": "https://androidpublisher.googleapis.com/",
 "schemas": {
 "Abi": {
@@ -5253,7 +5253,7 @@
 "type": "string"
 },
 "billingPeriodDuration": {
-"description": "Required. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center.",
+"description": "Required. Immutable. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center. The duration is immutable after the base plan is created.",
 "type": "string"
 },
 "gracePeriodDuration": {
@@ -7085,11 +7085,11 @@ false
 "type": "string"
 },
 "billingPeriodDuration": {
-"description": "Required. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center.",
+"description": "Required. Immutable. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center. The duration is immutable after the base plan is created.",
 "type": "string"
 },
 "committedPaymentsCount": {
-"description": "Required. The number of payments the user is committed to.",
+"description": "Required. Immutable. The number of payments the user is committed to. It is immutable after the base plan is created.",
 "format": "int32",
 "type": "integer"
 },
@@ -7112,7 +7112,7 @@ false
 "type": "string"
 },
 "renewalType": {
-"description": "Required. Installments base plan renewal type. Determines the behavior at the end of the initial commitment.",
+"description": "Required. Immutable. Installments base plan renewal type. Determines the behavior at the end of the initial commitment. The renewal type is immutable after the base plan is created.",
 "enum": [
 "RENEWAL_TYPE_UNSPECIFIED",
 "RENEWAL_TYPE_RENEWS_WITHOUT_COMMITMENT",
@@ -7748,7 +7748,7 @@ false
 "id": "PrepaidBasePlanType",
 "properties": {
 "billingPeriodDuration": {
-"description": "Required. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center.",
+"description": "Required. Immutable. Subscription period, specified in ISO 8601 format. For a list of acceptable billing periods, refer to the help center. The duration is immutable after the base plan is created.",
 "type": "string"
 },
 "timeExtension": {
diff --git a/googleapiclient/discovery_cache/documents/backupdr.v1.json b/googleapiclient/discovery_cache/documents/backupdr.v1.json
index 2e6d0c4c03d..36e13a1b34e 100644
--- a/googleapiclient/discovery_cache/documents/backupdr.v1.json
+++ b/googleapiclient/discovery_cache/documents/backupdr.v1.json
@@ -1598,7 +1598,7 @@
 }
 }
 },
-"revision": "20240828",
+"revision": "20240904",
 "rootUrl": "https://backupdr.googleapis.com/",
 "schemas": {
 "AbandonBackupRequest": {
@@ -2278,7 +2278,7 @@
 "type": "object"
 },
 "BackupPlan": {
-"description": "A `BackupPlan` specifies some common fields, such as `display_name` as well as one or more `BackupRule` messages. Each `BackupRule` has a retention policy and defines a schedule by which the system is to perform backup workloads.",
+"description": "A `BackupPlan` specifies some common fields, such as `description` as well as one or more `BackupRule` messages. Each `BackupRule` has a retention policy and defines a schedule by which the system is to perform backup workloads.",
 "id": "BackupPlan",
 "properties": {
 "backupRules": {
diff --git a/googleapiclient/discovery_cache/documents/calendar.v3.json b/googleapiclient/discovery_cache/documents/calendar.v3.json
index 8efb4643508..92838bc4993 100644
--- a/googleapiclient/discovery_cache/documents/calendar.v3.json
+++ b/googleapiclient/discovery_cache/documents/calendar.v3.json
@@ -1090,6 +1090,7 @@
 "eventTypes": {
 "description": "Event types to return. Optional. This parameter can be repeated multiple times to return events of different types. If unset, returns all event types.",
 "enum": [
+"birthday",
 "default",
 "focusTime",
 "fromGmail",
@@ -1097,6 +1098,7 @@
 "workingLocation"
 ],
 "enumDescriptions": [
+"Special all-day events with an annual recurrence.",
 "Regular events.",
 "Focus time events.",
 "Events from Gmail.",
@@ -1219,7 +1221,7 @@
 "supportsSubscription": true
 },
 "move": {
-"description": "Moves an event to another calendar, i.e. changes an event's organizer. Note that only default events can be moved; outOfOffice, focusTime, workingLocation and fromGmail events cannot be moved.",
+"description": "Moves an event to another calendar, i.e. changes an event's organizer. Note that only default events can be moved; birthday, focusTime, fromGmail, outOfOffice and workingLocation events cannot be moved.",
 "httpMethod": "POST",
 "id": "calendar.events.move",
 "parameterOrder": [
@@ -1507,6 +1509,7 @@
 "eventTypes": {
 "description": "Event types to return. Optional. This parameter can be repeated multiple times to return events of different types. If unset, returns all event types.",
 "enum": [
+"birthday",
 "default",
 "focusTime",
 "fromGmail",
@@ -1514,6 +1517,7 @@
 "workingLocation"
 ],
 "enumDescriptions": [
+"Special all-day events with an annual recurrence.",
 "Regular events.",
 "Focus time events.",
 "Events from Gmail.",
@@ -1763,7 +1767,7 @@
 }
 }
 },
-"revision": "20240705",
+"revision": "20240906",
 "rootUrl": "https://www.googleapis.com/",
 "schemas": {
 "Acl": {
@@ -2420,7 +2424,7 @@
 },
 "eventType": {
 "default": "default",
-"description": "Specific type of the event. This cannot be modified after the event is created. Possible values are:  \n- \"default\" - A regular event or not further specified. \n- \"outOfOffice\" - An out-of-office event. \n- \"focusTime\" - A focus-time event. \n- \"workingLocation\" - A working location event. \n- \"fromGmail\" - An event from Gmail. This type of event cannot be created.",
+"description": "Specific type of the event. This cannot be modified after the event is created. Possible values are:  \n- \"birthday\" - A special all-day event with an annual recurrence. \n- \"default\" - A regular event or not further specified. \n- \"focusTime\" - A focus-time event. \n- \"fromGmail\" - An event from Gmail. This type of event cannot be created. \n- \"outOfOffice\" - An out-of-office event. \n- \"workingLocation\" - A working location event.",
 "type": "string"
 },
 "extendedProperties": {
diff --git a/googleapiclient/discovery_cache/documents/classroom.v1.json b/googleapiclient/discovery_cache/documents/classroom.v1.json
index 1a68e8e8396..31d0f36230a 100644
--- a/googleapiclient/discovery_cache/documents/classroom.v1.json
+++ b/googleapiclient/discovery_cache/documents/classroom.v1.json
@@ -575,14 +575,14 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "postId": {
 "deprecated": true,
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "query",
 "type": "string"
 }
@@ -751,14 +751,14 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "postId": {
 "deprecated": true,
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "query",
 "type": "string"
 }
@@ -795,14 +795,14 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "postId": {
 "deprecated": true,
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "query",
 "type": "string"
 }
@@ -836,14 +836,14 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "postId": {
 "deprecated": true,
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "query",
 "type": "string"
 }
@@ -870,7 +870,7 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -888,7 +888,7 @@
 },
 "postId": {
 "deprecated": true,
-"description": "Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use item_id instead.",
+"description": "Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use `item_id` instead.",
 "location": "query",
 "type": "string"
 }
@@ -1072,14 +1072,14 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "postId": {
 "deprecated": true,
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "query",
 "type": "string"
 }
@@ -1250,14 +1250,14 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "postId": {
 "deprecated": true,
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "query",
 "type": "string"
 }
@@ -1294,14 +1294,14 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "postId": {
 "deprecated": true,
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "query",
 "type": "string"
 }
@@ -1335,14 +1335,14 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "postId": {
 "deprecated": true,
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "query",
 "type": "string"
 }
@@ -1369,7 +1369,7 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -1387,7 +1387,7 @@
 },
 "postId": {
 "deprecated": true,
-"description": "Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use item_id instead.",
+"description": "Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use `item_id` instead.",
 "location": "query",
 "type": "string"
 }
@@ -1475,14 +1475,14 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "postId": {
 "deprecated": true,
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "query",
 "type": "string"
 },
@@ -1526,14 +1526,14 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "postId": {
 "deprecated": true,
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "query",
 "type": "string"
 },
@@ -2032,14 +2032,14 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "postId": {
 "deprecated": true,
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "query",
 "type": "string"
 }
@@ -2184,14 +2184,14 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "postId": {
 "deprecated": true,
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "query",
 "type": "string"
 }
@@ -2228,14 +2228,14 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "postId": {
 "deprecated": true,
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "query",
 "type": "string"
 }
@@ -2269,14 +2269,14 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "path",
 "required": true,
 "type": "string"
 },
 "postId": {
 "deprecated": true,
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "query",
 "type": "string"
 }
@@ -2303,7 +2303,7 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2321,7 +2321,7 @@
 },
 "postId": {
 "deprecated": true,
-"description": "Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use item_id instead.",
+"description": "Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use `item_id` instead.",
 "location": "query",
 "type": "string"
 }
@@ -2413,12 +2413,12 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "query",
 "type": "string"
 },
 "postId": {
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2455,12 +2455,12 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which to create the attachment. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "query",
 "type": "string"
 },
 "postId": {
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2498,12 +2498,12 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "query",
 "type": "string"
 },
 "postId": {
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2538,12 +2538,12 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "query",
 "type": "string"
 },
 "postId": {
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2571,7 +2571,7 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` whose attachments should be enumerated. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "query",
 "type": "string"
 },
@@ -2587,7 +2587,7 @@
 "type": "string"
 },
 "postId": {
-"description": "Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use item_id instead.",
+"description": "Optional. Identifier of the post under the course whose attachments to enumerate. Deprecated, use `item_id` instead.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2676,12 +2676,12 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "query",
 "type": "string"
 },
 "postId": {
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -2726,12 +2726,12 @@
 "type": "string"
 },
 "itemId": {
-"description": "Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
+"description": "Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. This field is required, but is not marked as such while we are migrating from post_id.",
 "location": "query",
 "type": "string"
 },
 "postId": {
-"description": "Optional. Deprecated, use item_id instead.",
+"description": "Optional. Deprecated, use `item_id` instead.",
 "location": "path",
 "required": true,
 "type": "string"
@@ -3695,7 +3695,7 @@
 }
 }
 },
-"revision": "20240713",
+"revision": "20240911",
 "rootUrl": "https://classroom.googleapis.com/",
 "schemas": {
 "AddOnAttachment": {
@@ -3727,7 +3727,7 @@
 "type": "string"
 },
 "itemId": {
-"description": "Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached. Unique per course.",
+"description": "Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached. Unique per course.",
 "type": "string"
 },
 "maxPoints": {
@@ -3737,20 +3737,20 @@
 },
 "postId": {
 "deprecated": true,
-"description": "Immutable. Deprecated, use item_id instead.",
+"description": "Immutable. Deprecated, use `item_id` instead.",
 "type": "string"
 },
 "studentViewUri": {
 "$ref": "EmbedUri",
-"description": "Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set."
+"description": "Required. URI to show the student view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set."
 },
 "studentWorkReviewUri": {
 "$ref": "EmbedUri",
-"description": "URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `postId`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned by google.classroom.AddOns.GetAddOnContext when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded."
+"description": "URI for the teacher to see student work on the attachment, if applicable. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, `attachmentId`, and `submissionId` query parameters set. This is the same `submissionId` returned in the [`AddOnContext.studentContext`](//devsite.google.com/classroom/reference/rest/v1/AddOnContext#StudentContext) field when a student views the attachment. If the URI is omitted or removed, `max_points` will also be discarded."
 },
 "teacherViewUri": {
 "$ref": "EmbedUri",
-"description": "Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `postId`, and `attachmentId` query parameters set."
+"description": "Required. URI to show the teacher view of the attachment. The URI will be opened in an iframe with the `courseId`, `itemId`, `itemType`, and `attachmentId` query parameters set."
 },
 "title": {
 "description": "Required. Title of this attachment. The title must be between 1 and 1000 characters.",
@@ -3800,12 +3800,12 @@
 "type": "string"
 },
 "itemId": {
-"description": "Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.",
+"description": "Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.",
 "type": "string"
 },
 "postId": {
 "deprecated": true,
-"description": "Immutable. Deprecated, use item_id instead.",
+"description": "Immutable. Deprecated, use `item_id` instead.",
 "type": "string"
 },
 "studentContext": {
@@ -3978,12 +3978,12 @@
 "type": "string"
 },
 "itemId": {
-"description": "Immutable. Identifier of the announcement, courseWork, or courseWorkMaterial under which the attachment is attached.",
+"description": "Immutable. Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which the attachment is attached.",
 "type": "string"
 },
 "postId": {
 "deprecated": true,
-"description": "Immutable. Deprecated, use item_id instead.",
+"description": "Immutable. Deprecated, use `item_id` instead.",
 "type": "string"
 }
 },
diff --git a/googleapiclient/discovery_cache/documents/cloudbilling.v1beta.json b/googleapiclient/discovery_cache/documents/cloudbilling.v1beta.json
index 45696e94593..fe677b6376e 100644
--- a/googleapiclient/discovery_cache/documents/cloudbilling.v1beta.json
+++ b/googleapiclient/discovery_cache/documents/cloudbilling.v1beta.json
@@ -761,7 +761,7 @@
 }
 }
 },
-"revision": "20240614",
+"revision": "20240906",
 "rootUrl": "https://cloudbilling.googleapis.com/",
 "schemas": {
 "CacheFillRegions": {
@@ -961,7 +961,7 @@
 "type": "object"
 },
 "CloudStorageEgressWorkload": {
-"description": "Specification of a network type. Network data transfer within Google Cloud applies when you move or copy data from one Cloud Storage bucket to another or when another Google Cloud service accesses data in your Cloud Storage bucket.This includes the network data transfer within Google Cloud and the general network usage.",
+"description": "Specification of a network type. Network data transfer within Google Cloud applies when you move or copy data from one Cloud Storage bucket to another or when another Google Cloud service accesses data in your Cloud Storage bucket.This includes the network data transfer within Google Cloud and the general network usage. * If transferring data between two regions, the source and destination fields are set to different values. For example: `source_continent` = \"SOURCE_CONTINENT_ASIA_PACIFIC\", `destination_continent` = \"SOURCE_CONTINENT_SOUTH_AMERICA\". * If transferring data within one region, the source and destination fields are set to the same value. For example: `source_continent` = \"SOURCE_CONTINENT_ASIA_PACIFIC\", `destination_continent` = \"SOURCE_CONTINENT_ASIA_PACIFIC\". Some examples for the Network data transfer traffic type on the pricing page. * Data moves between different locations on the same continent. `source_continent` = \"SOURCE_CONTINENT_ASIA_PACIFIC\", `destination_continent` = \"SOURCE_CONTINENT_ASIA_PACIFIC\". * Data moves between different continents and neither is Australia. `source_continent` = \"SOURCE_CONTINENT_NORTH_AMERICA\", `destination_continent` = \"SOURCE_CONTINENT_ASIA_PACIFIC\". * Data moves between different continents and one is Australia. `source_continent` = \"SOURCE_CONTINENT_NORTH_AMERICA\", `destination_continent` = \"SOURCE_CONTINENT_AUSTRALIA\".",
 "id": "CloudStorageEgressWorkload",
 "properties": {
 "destinationContinent": {
diff --git a/googleapiclient/discovery_cache/documents/cloudcontrolspartner.v1.json b/googleapiclient/discovery_cache/documents/cloudcontrolspartner.v1.json
index 130878c483c..c2483be0b3b 100644
--- a/googleapiclient/discovery_cache/documents/cloudcontrolspartner.v1.json
+++ b/googleapiclient/discovery_cache/documents/cloudcontrolspartner.v1.json
@@ -484,7 +484,7 @@
 }
 }
 },
-"revision": "20240814",
+"revision": "20240904",
 "rootUrl": "https://cloudcontrolspartner.googleapis.com/",
 "schemas": {
 "AccessApprovalRequest": {
@@ -598,7 +598,7 @@
 "readOnly": true
 },
 "displayName": {
-"description": "The customer organization's display name. E.g. \"Google\".",
+"description": "Required. Display name for the customer",
 "type": "string"
 },
 "isOnboarded": {
diff --git a/googleapiclient/discovery_cache/documents/cloudcontrolspartner.v1beta.json b/googleapiclient/discovery_cache/documents/cloudcontrolspartner.v1beta.json
index 58c4320d297..bf45c9d57e1 100644
--- a/googleapiclient/discovery_cache/documents/cloudcontrolspartner.v1beta.json
+++ b/googleapiclient/discovery_cache/documents/cloudcontrolspartner.v1beta.json
@@ -484,7 +484,7 @@
 }
 }
 },
-"revision": "20240814",
+"revision": "20240904",
 "rootUrl": "https://cloudcontrolspartner.googleapis.com/",
 "schemas": {
 "AccessApprovalRequest": {
@@ -598,7 +598,7 @@
 "readOnly": true
 },
 "displayName": {
-"description": "The customer organization's display name. E.g. \"Google\".",
+"description": "Required. Display name for the customer",
 "type": "string"
 },
 "isOnboarded": {
diff --git a/googleapiclient/discovery_cache/documents/displayvideo.v2.json b/googleapiclient/discovery_cache/documents/displayvideo.v2.json
index 545eaa672e4..247bd1fb88f 100644
--- a/googleapiclient/discovery_cache/documents/displayvideo.v2.json
+++ b/googleapiclient/discovery_cache/documents/displayvideo.v2.json
@@ -9267,7 +9267,7 @@
 }
 }
 },
-"revision": "20240808",
+"revision": "20240905",
 "rootUrl": "https://displayvideo.googleapis.com/",
 "schemas": {
 "ActivateManualTriggerRequest": {
@@ -16191,7 +16191,7 @@ true
 },
 "pacing": {
 "$ref": "Pacing",
-"description": "Required. The budget spending speed setting of the insertion order."
+"description": "Required. The budget spending speed setting of the insertion order. *Warning*: Starting on **November 5, 2024**, pacing_type `PACING_TYPE_ASAP` will no longer be compatible with pacing_period `PACING_PERIOD_FLIGHT`. [Read more about this announced change](/display-video/api/deprecations#features.io_asap)."
 },
 "partnerCosts": {
 "description": "The partner costs associated with the insertion order. If absent or empty in CreateInsertionOrder method, the newly created insertion order will inherit partner costs from the partner settings.",
@@ -18843,7 +18843,7 @@ true
 "type": "string"
 },
 "pacingType": {
-"description": "Required. The type of pacing that defines how the budget amount will be spent across the pacing_period.",
+"description": "Required. The type of pacing that defines how the budget amount will be spent across the pacing_period. *Warning*: Starting on **November 5, 2024**, `PACING_TYPE_ASAP` will no longer be compatible with pacing_period `PACING_PERIOD_FLIGHT` for insertion orders. [Read more about this announced change](/display-video/api/deprecations#features.io_asap).",
 "enum": [
 "PACING_TYPE_UNSPECIFIED",
 "PACING_TYPE_AHEAD",
@@ -20060,8 +20060,8 @@ false
 "Content related to motor vehicle, aviation or other transportation accidents.",
 "Issues that evoke strong, opposing views and spark debate. These include issues that are controversial in most countries and markets (such as abortion), as well as those that are controversial in specific countries and markets (such as immigration reform in the United States).",
 "Content which may be considered shocking or disturbing, such as violent news stories, stunts, or toilet humor.",
-"YouTube videos embedded on websites outside of YouTube.com. Only applicable to YouTube and Partners line items.",
-"Video of live events streamed over the internet. Only applicable to YouTube and Partners line items."
+"YouTube videos embedded on websites outside of YouTube.com. Only applicable to YouTube and Partners line items. *Warning*: On **September 30, 2024**, this value will be sunset. [Read more about this announced change](/display-video/api/deprecations#features.yt_li_categories).",
+"Video of live events streamed over the internet. Only applicable to YouTube and Partners line items. *Warning*: On **September 30, 2024**, this value will be sunset. [Read more about this announced change](/display-video/api/deprecations#features.yt_li_categories)."
 ],
 "type": "string"
 }
@@ -20115,8 +20115,8 @@ false
 "Content related to motor vehicle, aviation or other transportation accidents.",
 "Issues that evoke strong, opposing views and spark debate. These include issues that are controversial in most countries and markets (such as abortion), as well as those that are controversial in specific countries and markets (such as immigration reform in the United States).",
 "Content which may be considered shocking or disturbing, such as violent news stories, stunts, or toilet humor.",
-"YouTube videos embedded on websites outside of YouTube.com. Only applicable to YouTube and Partners line items.",
-"Video of live events streamed over the internet. Only applicable to YouTube and Partners line items."
+"YouTube videos embedded on websites outside of YouTube.com. Only applicable to YouTube and Partners line items. *Warning*: On **September 30, 2024**, this value will be sunset. [Read more about this announced change](/display-video/api/deprecations#features.yt_li_categories).",
+"Video of live events streamed over the internet. Only applicable to YouTube and Partners line items. *Warning*: On **September 30, 2024**, this value will be sunset. [Read more about this announced change](/display-video/api/deprecations#features.yt_li_categories)."
 ],
 "readOnly": true,
 "type": "string"
diff --git a/googleapiclient/discovery_cache/documents/displayvideo.v3.json b/googleapiclient/discovery_cache/documents/displayvideo.v3.json
index b9984a32e23..5e3e1675af9 100644
--- a/googleapiclient/discovery_cache/documents/displayvideo.v3.json
+++ b/googleapiclient/discovery_cache/documents/displayvideo.v3.json
@@ -9222,7 +9222,7 @@
 }
 }
 },
-"revision": "20240808",
+"revision": "20240905",
 "rootUrl": "https://displayvideo.googleapis.com/",
 "schemas": {
 "ActiveViewVideoViewabilityMetricConfig": {
@@ -16925,7 +16925,7 @@ false
 },
 "pacing": {
 "$ref": "Pacing",
-"description": "Required. The budget spending speed setting of the insertion order."
+"description": "Required. The budget spending speed setting of the insertion order. *Warning*: Starting on **November 5, 2024**, pacing_type `PACING_TYPE_ASAP` will no longer be compatible with pacing_period `PACING_PERIOD_FLIGHT`. [Read more about this announced change](/display-video/api/deprecations#features.io_asap)."
 },
 "partnerCosts": {
 "description": "The partner costs associated with the insertion order. If absent or empty in CreateInsertionOrder method, the newly created insertion order will inherit partner costs from the partner settings.",
@@ -19594,7 +19594,7 @@ false
 "type": "string"
 },
 "pacingType": {
-"description": "Required. The type of pacing that defines how the budget amount will be spent across the pacing_period.",
+"description": "Required. The type of pacing that defines how the budget amount will be spent across the pacing_period. *Warning*: Starting on **November 5, 2024**, `PACING_TYPE_ASAP` will no longer be compatible with pacing_period `PACING_PERIOD_FLIGHT` for insertion orders. [Read more about this announced change](/display-video/api/deprecations#features.io_asap).",
 "enum": [
 "PACING_TYPE_UNSPECIFIED",
 "PACING_TYPE_AHEAD",
@@ -20831,8 +20831,8 @@ false
 "Content related to motor vehicle, aviation or other transportation accidents.",
 "Issues that evoke strong, opposing views and spark debate. These include issues that are controversial in most countries and markets (such as abortion), as well as those that are controversial in specific countries and markets (such as immigration reform in the United States).",
 "Content which may be considered shocking or disturbing, such as violent news stories, stunts, or toilet humor.",
-"YouTube videos embedded on websites outside of YouTube.com. Only applicable to YouTube and Partners line items.",
-"Video of live events streamed over the internet. Only applicable to YouTube and Partners line items."
+"YouTube videos embedded on websites outside of YouTube.com. Only applicable to YouTube and Partners line items. *Warning*: On **September 30, 2024**, this value will be sunset. [Read more about this announced change](/display-video/api/deprecations#features.yt_li_categories).",
+"Video of live events streamed over the internet. Only applicable to YouTube and Partners line items. *Warning*: On **September 30, 2024**, this value will be sunset. [Read more about this announced change](/display-video/api/deprecations#features.yt_li_categories)."
 ],
 "type": "string"
 }
@@ -20886,8 +20886,8 @@ false
 "Content related to motor vehicle, aviation or other transportation accidents.",
 "Issues that evoke strong, opposing views and spark debate. These include issues that are controversial in most countries and markets (such as abortion), as well as those that are controversial in specific countries and markets (such as immigration reform in the United States).",
 "Content which may be considered shocking or disturbing, such as violent news stories, stunts, or toilet humor.",
-"YouTube videos embedded on websites outside of YouTube.com. Only applicable to YouTube and Partners line items.",
-"Video of live events streamed over the internet. Only applicable to YouTube and Partners line items."
+"YouTube videos embedded on websites outside of YouTube.com. Only applicable to YouTube and Partners line items. *Warning*: On **September 30, 2024**, this value will be sunset. [Read more about this announced change](/display-video/api/deprecations#features.yt_li_categories).",
+"Video of live events streamed over the internet. Only applicable to YouTube and Partners line items. *Warning*: On **September 30, 2024**, this value will be sunset. [Read more about this announced change](/display-video/api/deprecations#features.yt_li_categories)."
 ],
 "readOnly": true,
 "type": "string"
@@ -21048,7 +21048,7 @@ false
 "type": "boolean"
 },
 "enableOptimizedTargeting": {
-"description": "Required. Whether to enable Optimized Targeting for the line item.",
+"description": "Required. Whether to enable Optimized Targeting for the line item. *Warning*: Starting on **September 30, 2024**, optimized targeting will no longer be compatible with a subset of bid strategies. [Read more about this announced change](/display-video/api/deprecations#features.ot_bid_strategies).",
 "type": "boolean"
 }
 },
diff --git a/googleapiclient/discovery_cache/documents/firebaseappdistribution.v1alpha.json b/googleapiclient/discovery_cache/documents/firebaseappdistribution.v1alpha.json
index bb201190fd7..4f97f19f1d1 100644
--- a/googleapiclient/discovery_cache/documents/firebaseappdistribution.v1alpha.json
+++ b/googleapiclient/discovery_cache/documents/firebaseappdistribution.v1alpha.json
@@ -585,7 +585,7 @@
 }
 }
 },
-"revision": "20240726",
+"revision": "20240911",
 "rootUrl": "https://firebaseappdistribution.googleapis.com/",
 "schemas": {
 "AndroidxCrawlerOutputPoint": {
@@ -943,7 +943,8 @@
 "NOT_INSTALLED",
 "UNABLE_TO_CRAWL",
 "DEVICE_OUT_OF_MEMORY",
-"FAILED_AI_STEP"
+"FAILED_AI_STEP",
+"TIMED_OUT"
 ],
 "enumDescriptions": [
 "Reason unspecified.",
@@ -951,7 +952,8 @@
 "If an app is not installed and thus no test can be run with the app. This might be caused by trying to run a test on an unsupported platform.",
 "If the app could not be crawled (possibly because the app did not start).",
 "If the device ran out of memory during the test.",
-"At least one AI step failed."
+"At least one AI step failed.",
+"The crawl reached the time limit before the test could be completed."
 ],
 "readOnly": true,
 "type": "string"
diff --git a/googleapiclient/discovery_cache/documents/iap.v1.json b/googleapiclient/discovery_cache/documents/iap.v1.json
index 8c09f4fc4ed..d2b15ba9d8c 100644
--- a/googleapiclient/discovery_cache/documents/iap.v1.json
+++ b/googleapiclient/discovery_cache/documents/iap.v1.json
@@ -682,7 +682,7 @@
 }
 }
 },
-"revision": "20240701",
+"revision": "20240909",
 "rootUrl": "https://iap.googleapis.com/",
 "schemas": {
 "AccessDeniedPageSettings": {
@@ -741,7 +741,7 @@
 },
 "policyDelegationSettings": {
 "$ref": "PolicyDelegationSettings",
-"description": "Optional. Settings to configure Policy delegation for apps hosted in tenant projects. INTERNAL_ONLY."
+"description": "Optional. Settings to allow google-internal teams to use IAP for apps hosted in a tenant project."
 },
 "reauthSettings": {
 "$ref": "ReauthSettings",
@@ -1188,7 +1188,7 @@
 "type": "string"
 },
 "method": {
-"description": "Reauth method requested.",
+"description": "Optional. Reauth method requested.",
 "enum": [
 "METHOD_UNSPECIFIED",
 "LOGIN",
diff --git a/googleapiclient/discovery_cache/documents/recaptchaenterprise.v1.json b/googleapiclient/discovery_cache/documents/recaptchaenterprise.v1.json
index 9b3eafa6dce..3fbca64f837 100644
--- a/googleapiclient/discovery_cache/documents/recaptchaenterprise.v1.json
+++ b/googleapiclient/discovery_cache/documents/recaptchaenterprise.v1.json
@@ -147,7 +147,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The name of the project in which the assessment will be created, in the format `projects/{project}`.",
+"description": "Required. The name of the project in which the assessment is created, in the format `projects/{project}`.",
 "location": "path",
 "pattern": "^projects/[^/]+$",
 "required": true,
@@ -179,7 +179,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The name of the project this policy will apply to, in the format `projects/{project}`.",
+"description": "Required. The name of the project this policy applies to, in the format `projects/{project}`.",
 "location": "path",
 "pattern": "^projects/[^/]+$",
 "required": true,
@@ -300,7 +300,7 @@
 "type": "string"
 },
 "updateMask": {
-"description": "Optional. The mask to control which fields of the policy get updated. If the mask is not present, all fields will be updated.",
+"description": "Optional. The mask to control which fields of the policy get updated. If the mask is not present, all fields are updated.",
 "format": "google-fieldmask",
 "location": "query",
 "type": "string"
@@ -350,7 +350,7 @@
 "keys": {
 "methods": {
 "addIpOverride": {
-"description": "Adds an IP override to a key. The following restrictions hold: * The maximum number of IP overrides per key is 100. * For any conflict (such as IP already exists or IP part of an existing IP range), an error will be returned.",
+"description": "Adds an IP override to a key. The following restrictions hold: * The maximum number of IP overrides per key is 100. * For any conflict (such as IP already exists or IP part of an existing IP range), an error is returned.",
 "flatPath": "v1/projects/{projectsId}/keys/{keysId}:addIpOverride",
 "httpMethod": "POST",
 "id": "recaptchaenterprise.projects.keys.addIpOverride",
@@ -387,7 +387,7 @@
 ],
 "parameters": {
 "parent": {
-"description": "Required. The name of the project in which the key will be created, in the format `projects/{project}`.",
+"description": "Required. The name of the project in which the key is created, in the format `projects/{project}`.",
 "location": "path",
 "pattern": "^projects/[^/]+$",
 "required": true,
@@ -501,7 +501,7 @@
 "type": "string"
 },
 "parent": {
-"description": "Required. The name of the project that contains the keys that will be listed, in the format `projects/{project}`.",
+"description": "Required. The name of the project that contains the keys that is listed, in the format `projects/{project}`.",
 "location": "path",
 "pattern": "^projects/[^/]+$",
 "required": true,
@@ -597,7 +597,7 @@
 "type": "string"
 },
 "updateMask": {
-"description": "Optional. The mask to control which fields of the key get updated. If the mask is not present, all fields will be updated.",
+"description": "Optional. The mask to control which fields of the key get updated. If the mask is not present, all fields are updated.",
 "format": "google-fieldmask",
 "location": "query",
 "type": "string"
@@ -615,7 +615,7 @@
 ]
 },
 "removeIpOverride": {
-"description": "Removes an IP override from a key. The following restrictions hold: * If the IP isn't found in an existing IP override, a `NOT_FOUND` error will be returned. * If the IP is found in an existing IP override, but the override type does not match, a `NOT_FOUND` error will be returned.",
+"description": "Removes an IP override from a key. The following restrictions hold: * If the IP isn't found in an existing IP override, a `NOT_FOUND` error is returned. * If the IP is found in an existing IP override, but the override type does not match, a `NOT_FOUND` error is returned.",
 "flatPath": "v1/projects/{projectsId}/keys/{keysId}:removeIpOverride",
 "httpMethod": "POST",
 "id": "recaptchaenterprise.projects.keys.removeIpOverride",
@@ -786,7 +786,7 @@
 }
 }
 },
-"revision": "20240825",
+"revision": "20240906",
 "rootUrl": "https://recaptchaenterprise.googleapis.com/",
 "schemas": {
 "GoogleCloudRecaptchaenterpriseV1AccountDefenderAssessment": {
@@ -918,7 +918,7 @@
 "type": "string"
 },
 "annotation": {
-"description": "Optional. The annotation that will be assigned to the Event. This field can be left empty to provide reasons that apply to an event without concluding whether the event is legitimate or fraudulent.",
+"description": "Optional. The annotation that is assigned to the Event. This field can be left empty to provide reasons that apply to an event without concluding whether the event is legitimate or fraudulent.",
 "enum": [
 "ANNOTATION_UNSPECIFIED",
 "LEGITIMATE",
@@ -1164,7 +1164,7 @@ true
 "type": "boolean"
 },
 "firewallPolicyEvaluation": {
-"description": "Optional. Flag for enabling firewall policy config assessment. If this flag is enabled, the firewall policy will be evaluated and a suggested firewall action will be returned in the response.",
+"description": "Optional. Flag for enabling firewall policy config assessment. If this flag is enabled, the firewall policy is evaluated and a suggested firewall action is returned in the response.",
 "type": "boolean"
 },
 "fraudPrevention": {
@@ -1249,23 +1249,23 @@ true
 },
 "block": {
 "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallActionBlockAction",
-"description": "This action will deny access to a given page. The user will get an HTTP error code."
+"description": "This action denies access to a given page. The user gets an HTTP error code."
 },
 "includeRecaptchaScript": {
 "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallActionIncludeRecaptchaScriptAction",
-"description": "This action will inject reCAPTCHA JavaScript code into the HTML page returned by the site backend."
+"description": "This action injects reCAPTCHA JavaScript code into the HTML page returned by the site backend."
 },
 "redirect": {
 "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallActionRedirectAction",
-"description": "This action will redirect the request to a ReCaptcha interstitial to attach a token."
+"description": "This action redirects the request to a reCAPTCHA interstitial to attach a token."
 },
 "setHeader": {
 "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallActionSetHeaderAction",
-"description": "This action will set a custom header but allow the request to continue to the customer backend."
+"description": "This action sets a custom header but allow the request to continue to the customer backend."
 },
 "substitute": {
 "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallActionSubstituteAction",
-"description": "This action will transparently serve a different page to an offending user."
+"description": "This action transparently serves a different page to an offending user."
 }
 },
 "type": "object"
@@ -1289,7 +1289,7 @@ true
 "type": "object"
 },
 "GoogleCloudRecaptchaenterpriseV1FirewallActionRedirectAction": {
-"description": "A redirect action returns a 307 (temporary redirect) response, pointing the user to a ReCaptcha interstitial page to attach a token.",
+"description": "A redirect action returns a 307 (temporary redirect) response, pointing the user to a reCAPTCHA interstitial page to attach a token.",
 "id": "GoogleCloudRecaptchaenterpriseV1FirewallActionRedirectAction",
 "properties": {},
 "type": "object"
@@ -1356,12 +1356,12 @@ true
 "properties": {
 "error": {
 "$ref": "GoogleRpcStatus",
-"description": "Output only. If the processing of a policy config fails, an error will be populated and the firewall_policy will be left empty.",
+"description": "Output only. If the processing of a policy config fails, an error is populated and the firewall_policy is left empty.",
 "readOnly": true
 },
 "firewallPolicy": {
 "$ref": "GoogleCloudRecaptchaenterpriseV1FirewallPolicy",
-"description": "Output only. The policy that matched the request. If more than one policy may match, this is the first match. If no policy matches the incoming request, the policy field will be left empty.",
+"description": "Output only. The policy that matched the request. If more than one policy may match, this is the first match. If no policy matches the incoming request, the policy field is left empty.",
 "readOnly": true
 }
 },
@@ -1514,7 +1514,7 @@ true
 },
 "appleDeveloperId": {
 "$ref": "GoogleCloudRecaptchaenterpriseV1AppleDeveloperId",
-"description": "Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA Enterprise leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA Enterprise to get a better assessment of the integrity of your app."
+"description": "Optional. Apple Developer account details for the app that is protected by the reCAPTCHA Key. reCAPTCHA leverages platform-specific checks like Apple App Attest and Apple DeviceCheck to protect your app from abuse. Providing these fields allows reCAPTCHA to get a better assessment of the integrity of your app."
 }
 },
 "type": "object"
@@ -1689,7 +1689,7 @@ true
 "id": "GoogleCloudRecaptchaenterpriseV1Metrics",
 "properties": {
 "challengeMetrics": {
-"description": "Metrics will be continuous and in order by dates, and in the granularity of day. Only challenge-based keys (CHECKBOX, INVISIBLE), will have challenge-based data.",
+"description": "Metrics are continuous and in order by dates, and in the granularity of day. Only challenge-based keys (CHECKBOX, INVISIBLE) have challenge-based data.",
 "items": {
 "$ref": "GoogleCloudRecaptchaenterpriseV1ChallengeMetrics"
 },
@@ -1701,7 +1701,7 @@ true
 "type": "string"
 },
 "scoreMetrics": {
-"description": "Metrics will be continuous and in order by dates, and in the granularity of day. All Key types should have score-based data.",
+"description": "Metrics are continuous and in order by dates, and in the granularity of day. All Key types should have score-based data.",
 "items": {
 "$ref": "GoogleCloudRecaptchaenterpriseV1ScoreMetrics"
 },
@@ -2010,7 +2010,7 @@ true
 "id": "GoogleCloudRecaptchaenterpriseV1TestingOptions",
 "properties": {
 "testingChallenge": {
-"description": "Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site will return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.",
+"description": "Optional. For challenge-based keys only (CHECKBOX, INVISIBLE), all challenge requests for this site return nocaptcha if NOCAPTCHA, or an unsolvable challenge if CHALLENGE.",
 "enum": [
 "TESTING_CHALLENGE_UNSPECIFIED",
 "NOCAPTCHA",
@@ -2024,7 +2024,7 @@ true
 "type": "string"
 },
 "testingScore": {
-"description": "Optional. All assessments for this Key will return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.",
+"description": "Optional. All assessments for this Key return this score. Must be between 0 (likely not legitimate) and 1 (likely legitimate) inclusive.",
 "format": "float",
 "type": "number"
 }
@@ -2410,13 +2410,15 @@ true
 "WAF_SERVICE_UNSPECIFIED",
 "CA",
 "FASTLY",
-"CLOUDFLARE"
+"CLOUDFLARE",
+"AKAMAI"
 ],
 "enumDescriptions": [
 "Undefined WAF",
 "Cloud Armor",
 "Fastly",
-"Cloudflare"
+"Cloudflare",
+"Akamai"
 ],
 "type": "string"
 }
@@ -2428,7 +2430,7 @@ true
 "id": "GoogleCloudRecaptchaenterpriseV1WebKeySettings",
 "properties": {
 "allowAllDomains": {
-"description": "Optional. If set to true, it means allowed_domains will not be enforced.",
+"description": "Optional. If set to true, it means allowed_domains are not enforced.",
 "type": "boolean"
 },
 "allowAmpTraffic": {
@@ -2443,7 +2445,7 @@ true
 "type": "array"
 },
 "challengeSecurityPreference": {
-"description": "Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE.",
+"description": "Optional. Settings for the frequency and difficulty at which this key triggers captcha challenges. This should only be specified for IntegrationTypes CHECKBOX and INVISIBLE and SCORE_AND_CHALLENGE.",
 "enum": [
 "CHALLENGE_SECURITY_PREFERENCE_UNSPECIFIED",
 "USABILITY",
diff --git a/googleapiclient/discovery_cache/documents/sts.v1.json b/googleapiclient/discovery_cache/documents/sts.v1.json
index 333d599de7d..48104eb4d43 100644
--- a/googleapiclient/discovery_cache/documents/sts.v1.json
+++ b/googleapiclient/discovery_cache/documents/sts.v1.json
@@ -116,7 +116,7 @@
 }
 }
 },
-"revision": "20240704",
+"revision": "20240904",
 "rootUrl": "https://sts.googleapis.com/",
 "schemas": {
 "GoogleIamV1Binding": {
@@ -194,7 +194,7 @@
 "type": "string"
 },
 "requestedTokenType": {
-"description": "Required. An identifier for the type of requested security token. Can be `urn:ietf:params:oauth:token-type:access_token` or `urn:ietf:params:oauth:token-type:access_boundary_intermediate_token`.",
+"description": "Required. An identifier for the type of requested security token. Can be `urn:ietf:params:oauth:token-type:access_token` or `urn:ietf:params:oauth:token-type:access_boundary_intermediary_token`.",
 "type": "string"
 },
 "scope": {
@@ -217,7 +217,7 @@
 "id": "GoogleIdentityStsV1ExchangeTokenResponse",
 "properties": {
 "access_boundary_session_key": {
-"description": "The access boundary session key. This key is used along with the access boundary intermediate token to generate Credential Access Boundary tokens at client side. This field is absent when the `requested_token_type` from the request is not `urn:ietf:params:oauth:token-type:access_boundary_intermediate_token`.",
+"description": "The access boundary session key. This key is used along with the access boundary intermediary token to generate Credential Access Boundary tokens at client side. This field is absent when the `requested_token_type` from the request is not `urn:ietf:params:oauth:token-type:access_boundary_intermediary_token`.",
 "format": "byte",
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/workstations.v1.json b/googleapiclient/discovery_cache/documents/workstations.v1.json
index 1f3fea8575d..b5e39851d2e 100644
--- a/googleapiclient/discovery_cache/documents/workstations.v1.json
+++ b/googleapiclient/discovery_cache/documents/workstations.v1.json
@@ -1195,7 +1195,7 @@
 }
 }
 },
-"revision": "20240820",
+"revision": "20240904",
 "rootUrl": "https://workstations.googleapis.com/",
 "schemas": {
 "Accelerator": {
@@ -2356,7 +2356,7 @@
 "type": "string"
 },
 "enableAuditAgent": {
-"description": "Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](http://cloud/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type=\"gce_instance\" log_name:\"/logs/linux-auditd\"",
+"description": "Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](https://cloud.google.com/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type=\"gce_instance\" log_name:\"/logs/linux-auditd\"",
 "type": "boolean"
 },
 "encryptionKey": {
@@ -2395,7 +2395,7 @@
 "type": "object"
 },
 "maxUsableWorkstations": {
-"description": "Optional. Maximum number of workstations under this config a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified defaults to 0 which indicates unlimited.",
+"description": "Optional. Maximum number of workstations under this configuration a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified, defaults to `0`, which indicates unlimited.",
 "format": "int32",
 "type": "integer"
 },
diff --git a/googleapiclient/discovery_cache/documents/workstations.v1beta.json b/googleapiclient/discovery_cache/documents/workstations.v1beta.json
index 8c53d296b22..06114e0511b 100644
--- a/googleapiclient/discovery_cache/documents/workstations.v1beta.json
+++ b/googleapiclient/discovery_cache/documents/workstations.v1beta.json
@@ -1127,7 +1127,7 @@
 }
 }
 },
-"revision": "20240820",
+"revision": "20240904",
 "rootUrl": "https://workstations.googleapis.com/",
 "schemas": {
 "Accelerator": {
@@ -1237,7 +1237,7 @@
 "type": "boolean"
 },
 "id": {
-"description": "Optional. Required. The id to be used for the boost config.",
+"description": "Optional. Required. The id to be used for the boost configuration.",
 "type": "string"
 },
 "machineType": {
@@ -2052,7 +2052,7 @@
 "type": "object"
 },
 "boostConfigs": {
-"description": "Output only. List of available boost configuration ids that this workstation can be boosted up to",
+"description": "Output only. List of available boost configuration IDs that this workstation can be boosted up to.",
 "items": {
 "$ref": "WorkstationBoostConfig"
 },
@@ -2166,11 +2166,11 @@
 "type": "object"
 },
 "WorkstationBoostConfig": {
-"description": "Boost config for this workstation. This object is populated from the parent workstation config.",
+"description": "Boost configuration for this workstation. This object is populated from the parent workstation configuration.",
 "id": "WorkstationBoostConfig",
 "properties": {
 "id": {
-"description": "Output only. Boost config id.",
+"description": "Output only. Boost configuration ID.",
 "readOnly": true,
 "type": "string"
 }
@@ -2338,7 +2338,7 @@
 "type": "string"
 },
 "enableAuditAgent": {
-"description": "Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](http://cloud/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type=\"gce_instance\" log_name:\"/logs/linux-auditd\"",
+"description": "Optional. Whether to enable Linux `auditd` logging on the workstation. When enabled, a service_account must also be specified that has `roles/logging.logWriter` and `roles/monitoring.metricWriter` on the project. Operating system audit logging is distinct from [Cloud Audit Logs](https://cloud.google.com/workstations/docs/audit-logging) and [Container output logging](https://cloud.google.com/workstations/docs/container-output-logging#overview). Operating system audit logs are available in the [Cloud Logging](https://cloud.google.com/logging/docs) console by querying: resource.type=\"gce_instance\" log_name:\"/logs/linux-auditd\"",
 "type": "boolean"
 },
 "encryptionKey": {
@@ -2381,7 +2381,7 @@
 "type": "object"
 },
 "maxUsableWorkstations": {
-"description": "Optional. Maximum number of workstations under this config a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified defaults to 0 which indicates unlimited.",
+"description": "Optional. Maximum number of workstations under this configuration a user can have `workstations.workstation.use` permission on. Only enforced on CreateWorkstation API calls on the user issuing the API request. Can be overridden by: - granting a user workstations.workstationConfigs.exemptMaxUsableWorkstationLimit permission, or - having a user with that permission create a workstation and granting another user `workstations.workstation.use` permission on that workstation. If not specified, defaults to `0`, which indicates unlimited.",
 "format": "int32",
 "type": "integer"
 },
diff --git a/googleapiclient/discovery_cache/documents/youtube.v3.json b/googleapiclient/discovery_cache/documents/youtube.v3.json
index 8c2f5ee887b..10e2ef58e73 100644
--- a/googleapiclient/discovery_cache/documents/youtube.v3.json
+++ b/googleapiclient/discovery_cache/documents/youtube.v3.json
@@ -4072,7 +4072,7 @@
 }
 }
 },
-"revision": "20240814",
+"revision": "20240909",
 "rootUrl": "https://youtube.googleapis.com/",
 "schemas": {
 "AbuseReport": {
@@ -11939,7 +11939,7 @@ true
 "type": "object"
 },
 "VideoStatus": {
-"description": "Basic details about a video category, such as its localized title. Next Id: 18",
+"description": "Basic details about a video category, such as its localized title. Next Id: 19",
 "id": "VideoStatus",
 "properties": {
 "embeddable": {