From 7dc323c1ee1e2c44ac3237920b979668b62c506a Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 29 Jul 2025 07:12:11 +0000 Subject: [PATCH 01/36] feat(aiplatform): update the api #### aiplatform:v1 The following keys were added: - resources.projects.resources.locations.resources.endpoints.methods.list.parameters.gdcZone (Total Keys: 2) - schemas.GoogleCloudAiplatformV1DeployRequestModelConfig.properties.modelUserId.type (Total Keys: 1) - schemas.GoogleCloudAiplatformV1DeployedModel.properties.gdcConnectedModel.type (Total Keys: 1) - schemas.GoogleCloudAiplatformV1Endpoint.properties.gdcConfig.$ref (Total Keys: 1) - schemas.GoogleCloudAiplatformV1GdcConfig (Total Keys: 3) #### aiplatform:v1beta1 The following keys were added: - resources.projects.methods.fetchPublisherModelConfig (Total Keys: 11) - resources.projects.methods.setPublisherModelConfig (Total Keys: 12) - resources.projects.resources.locations.resources.endpoints.methods.list.parameters.gdcZone (Total Keys: 2) - schemas.GoogleCloudAiplatformV1beta1DeployRequest.properties.customModel.$ref (Total Keys: 1) - schemas.GoogleCloudAiplatformV1beta1DeployRequestCustomModel (Total Keys: 5) - schemas.GoogleCloudAiplatformV1beta1DeployRequestModelConfig.properties.modelUserId.type (Total Keys: 1) - schemas.GoogleCloudAiplatformV1beta1DeployedModel.properties.gdcConnectedModel.type (Total Keys: 1) - schemas.GoogleCloudAiplatformV1beta1Endpoint.properties.gdcConfig.$ref (Total Keys: 1) - schemas.GoogleCloudAiplatformV1beta1GdcConfig (Total Keys: 3) - schemas.GoogleCloudAiplatformV1beta1Session.properties.expireTime (Total Keys: 2) - schemas.GoogleCloudAiplatformV1beta1Session.properties.ttl (Total Keys: 2) --- ...cts.locations.deploymentResourcePools.html | 1 + ...tform_v1.projects.locations.endpoints.html | 37 +++++- .../dyn/aiplatform_v1.projects.locations.html | 1 + ...form_v1.projects.locations.tuningJobs.html | 10 +- docs/dyn/aiplatform_v1beta1.projects.html | 85 +++++++++++++ ...cts.locations.deploymentResourcePools.html | 1 + ..._v1beta1.projects.locations.endpoints.html | 37 +++++- ...aiplatform_v1beta1.projects.locations.html | 5 + ...s.locations.reasoningEngines.sessions.html | 10 ++ ...v1beta1.projects.locations.tuningJobs.html | 10 +- ...orm_v1beta1.reasoningEngines.sessions.html | 10 ++ .../documents/aiplatform.v1.json | 36 +++++- .../documents/aiplatform.v1beta1.json | 119 +++++++++++++++++- 13 files changed, 334 insertions(+), 28 deletions(-) diff --git a/docs/dyn/aiplatform_v1.projects.locations.deploymentResourcePools.html b/docs/dyn/aiplatform_v1.projects.locations.deploymentResourcePools.html index 73f4ee9b176..41e63372ba2 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.deploymentResourcePools.html +++ b/docs/dyn/aiplatform_v1.projects.locations.deploymentResourcePools.html @@ -598,6 +598,7 @@

Method Details

"fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment. "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model. }, + "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002. "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`. "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed. "modelVersionId": "A String", # Output only. The version ID of the model that is deployed. diff --git a/docs/dyn/aiplatform_v1.projects.locations.endpoints.html b/docs/dyn/aiplatform_v1.projects.locations.endpoints.html index b528ce9fb48..151d2c669ce 100644 --- a/docs/dyn/aiplatform_v1.projects.locations.endpoints.html +++ b/docs/dyn/aiplatform_v1.projects.locations.endpoints.html @@ -121,14 +121,14 @@

Instance Methods

get(name, x__xgafv=None)

Gets an Endpoint.

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

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

Lists Endpoints in a Location.

list_next()

Retrieves the next page of results.

mutateDeployedModel(endpoint, body=None, x__xgafv=None)

-

Updates an existing deployed model. Updatable fields include `min_replica_count`, `max_replica_count`, `autoscaling_metric_specs`, `disable_container_logging` (v1 only), and `enable_container_logging` (v1beta1 only).

+

Updates an existing deployed model. Updatable fields include `min_replica_count`, `max_replica_count`, `required_replica_count`, `autoscaling_metric_specs`, `disable_container_logging` (v1 only), and `enable_container_logging` (v1beta1 only).

patch(name, body=None, updateMask=None, x__xgafv=None)

Updates an Endpoint.

@@ -809,6 +809,7 @@

Method Details

"fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment. "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model. }, + "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002. "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`. "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed. "modelVersionId": "A String", # Output only. The version ID of the model that is deployed. @@ -846,6 +847,9 @@

Method Details

"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. }, "etag": "A String", # Used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens. + "gdcConfig": { # Google Distributed Cloud (GDC) config. # Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment. + "zone": "A String", # GDC zone. A cluster will be designated for the Vertex AI workload in this zone. + }, "genAiAdvancedFeaturesConfig": { # Configuration for GenAiAdvancedFeatures. # Optional. Configuration for GenAiAdvancedFeatures. If the endpoint is serving GenAI models, advanced features like native RAG integration can be configured. Currently, only Model Garden models are supported. "ragConfig": { # Configuration for Retrieval Augmented Generation feature. # Configuration for Retrieval Augmented Generation feature. "enableRag": True or False, # If true, enable Retrieval Augmented Generation in ChatCompletion request. Once enabled, the endpoint will be identified as GenAI endpoint and Arthedain router will be used. @@ -1111,6 +1115,7 @@

Method Details

"fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment. "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model. }, + "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002. "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`. "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed. "modelVersionId": "A String", # Output only. The version ID of the model that is deployed. @@ -2364,6 +2369,7 @@

Method Details

"fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment. "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model. }, + "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002. "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`. "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed. "modelVersionId": "A String", # Output only. The version ID of the model that is deployed. @@ -2401,6 +2407,9 @@

Method Details

"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. }, "etag": "A String", # Used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens. + "gdcConfig": { # Google Distributed Cloud (GDC) config. # Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment. + "zone": "A String", # GDC zone. A cluster will be designated for the Vertex AI workload in this zone. + }, "genAiAdvancedFeaturesConfig": { # Configuration for GenAiAdvancedFeatures. # Optional. Configuration for GenAiAdvancedFeatures. If the endpoint is serving GenAI models, advanced features like native RAG integration can be configured. Currently, only Model Garden models are supported. "ragConfig": { # Configuration for Retrieval Augmented Generation feature. # Configuration for Retrieval Augmented Generation feature. "enableRag": True or False, # If true, enable Retrieval Augmented Generation in ChatCompletion request. Once enabled, the endpoint will be identified as GenAI endpoint and Arthedain router will be used. @@ -2446,12 +2455,13 @@

Method Details

- list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None) + list(parent, filter=None, gdcZone=None, orderBy=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None) 
Lists Endpoints in a Location.
 
 Args:
   parent: string, Required. The resource name of the Location from which to list the Endpoints. Format: `projects/{project}/locations/{location}` (required)
   filter: string, Optional. An expression for filtering the results of the request. For field names both snake_case and camelCase are supported. * `endpoint` supports `=` and `!=`. `endpoint` represents the Endpoint ID, i.e. the last segment of the Endpoint's resource name. * `display_name` supports `=` and `!=`. * `labels` supports general map functions that is: * `labels.key=value` - key:value equality * `labels.key:*` or `labels:key` - key existence * A key including a space must be quoted. `labels."a key"`. * `base_model_name` only supports `=`. Some examples: * `endpoint=1` * `displayName="myDisplayName"` * `labels.myKey="myValue"` * `baseModelName="text-bison"`
+  gdcZone: string, Optional. Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment.
   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: * `display_name` * `create_time` * `update_time` Example: `display_name, create_time desc`.
   pageSize: integer, Optional. The standard list page size.
   pageToken: string, Optional. The standard list page token. Typically obtained via ListEndpointsResponse.next_page_token of the previous EndpointService.ListEndpoints call.
@@ -2621,6 +2631,7 @@ 
Method Details

           "fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment.
             "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model.
           },
+          "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002.
           "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`.
           "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed.
           "modelVersionId": "A String", # Output only. The version ID of the model that is deployed.
@@ -2658,6 +2669,9 @@ 
Method Details

         "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.
       },
       "etag": "A String", # Used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
+      "gdcConfig": { # Google Distributed Cloud (GDC) config. # Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment.
+        "zone": "A String", # GDC zone. A cluster will be designated for the Vertex AI workload in this zone.
+      },
       "genAiAdvancedFeaturesConfig": { # Configuration for GenAiAdvancedFeatures. # Optional. Configuration for GenAiAdvancedFeatures. If the endpoint is serving GenAI models, advanced features like native RAG integration can be configured. Currently, only Model Garden models are supported.
         "ragConfig": { # Configuration for Retrieval Augmented Generation feature. # Configuration for Retrieval Augmented Generation feature.
           "enableRag": True or False, # If true, enable Retrieval Augmented Generation in ChatCompletion request. Once enabled, the endpoint will be identified as GenAI endpoint and Arthedain router will be used.
@@ -2721,7 +2735,7 @@ 
Method Details

 
 

     mutateDeployedModel(endpoint, body=None, x__xgafv=None)
-  
Updates an existing deployed model. Updatable fields include `min_replica_count`, `max_replica_count`, `autoscaling_metric_specs`, `disable_container_logging` (v1 only), and `enable_container_logging` (v1beta1 only).
+  
Updates an existing deployed model. Updatable fields include `min_replica_count`, `max_replica_count`, `required_replica_count`, `autoscaling_metric_specs`, `disable_container_logging` (v1 only), and `enable_container_logging` (v1beta1 only).
 
 Args:
   endpoint: string, Required. The name of the Endpoint resource into which to mutate a DeployedModel. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}` (required)
@@ -2729,7 +2743,7 @@ 
Method Details

     The object takes the form of:
 
 { # Request message for EndpointService.MutateDeployedModel.
-  "deployedModel": { # A deployment of a Model. Endpoints contain one or more DeployedModels. # Required. The DeployedModel to be mutated within the Endpoint. Only the following fields can be mutated: * `min_replica_count` in either DedicatedResources or AutomaticResources * `max_replica_count` in either DedicatedResources or AutomaticResources * autoscaling_metric_specs * `disable_container_logging` (v1 only) * `enable_container_logging` (v1beta1 only)
+  "deployedModel": { # A deployment of a Model. Endpoints contain one or more DeployedModels. # Required. The DeployedModel to be mutated within the Endpoint. Only the following fields can be mutated: * `min_replica_count` in either DedicatedResources or AutomaticResources * `max_replica_count` in either DedicatedResources or AutomaticResources * `required_replica_count` in DedicatedResources * autoscaling_metric_specs * `disable_container_logging` (v1 only) * `enable_container_logging` (v1beta1 only)
     "automaticResources": { # A description of resources that to large degree are decided by Vertex AI, and require only a modest additional configuration. Each Model supporting these resources documents its specific guidelines. # A description of resources that to large degree are decided by Vertex AI, and require only a modest additional configuration.
       "maxReplicaCount": 42, # Immutable. The maximum number of replicas that may be deployed on when the traffic against it increases. If the requested value is too large, the deployment will error, but if deployment succeeds then the ability to scale to that many replicas is guaranteed (barring service outages). If traffic increases beyond what its replicas at maximum may handle, a portion of the traffic will be dropped. If this value is not provided, a no upper bound for scaling under heavy traffic will be assume, though Vertex AI may be unable to scale beyond certain replica number.
       "minReplicaCount": 42, # Immutable. The minimum number of replicas that will be always deployed on. If traffic against it increases, it may dynamically be deployed onto more replicas up to max_replica_count, and as traffic decreases, some of these extra replicas may be freed. If the requested value is too large, the deployment will error.
@@ -2876,6 +2890,7 @@ 
Method Details

     "fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment.
       "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model.
     },
+    "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002.
     "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`.
     "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed.
     "modelVersionId": "A String", # Output only. The version ID of the model that is deployed.
@@ -3101,6 +3116,7 @@ 
Method Details

       "fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment.
         "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model.
       },
+      "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002.
       "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`.
       "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed.
       "modelVersionId": "A String", # Output only. The version ID of the model that is deployed.
@@ -3138,6 +3154,9 @@ 
Method Details

     "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.
   },
   "etag": "A String", # Used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
+  "gdcConfig": { # Google Distributed Cloud (GDC) config. # Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment.
+    "zone": "A String", # GDC zone. A cluster will be designated for the Vertex AI workload in this zone.
+  },
   "genAiAdvancedFeaturesConfig": { # Configuration for GenAiAdvancedFeatures. # Optional. Configuration for GenAiAdvancedFeatures. If the endpoint is serving GenAI models, advanced features like native RAG integration can be configured. Currently, only Model Garden models are supported.
     "ragConfig": { # Configuration for Retrieval Augmented Generation feature. # Configuration for Retrieval Augmented Generation feature.
       "enableRag": True or False, # If true, enable Retrieval Augmented Generation in ChatCompletion request. Once enabled, the endpoint will be identified as GenAI endpoint and Arthedain router will be used.
@@ -3345,6 +3364,7 @@ 
Method Details

       "fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment.
         "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model.
       },
+      "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002.
       "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`.
       "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed.
       "modelVersionId": "A String", # Output only. The version ID of the model that is deployed.
@@ -3382,6 +3402,9 @@ 
Method Details

     "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.
   },
   "etag": "A String", # Used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
+  "gdcConfig": { # Google Distributed Cloud (GDC) config. # Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment.
+    "zone": "A String", # GDC zone. A cluster will be designated for the Vertex AI workload in this zone.
+  },
   "genAiAdvancedFeaturesConfig": { # Configuration for GenAiAdvancedFeatures. # Optional. Configuration for GenAiAdvancedFeatures. If the endpoint is serving GenAI models, advanced features like native RAG integration can be configured. Currently, only Model Garden models are supported.
     "ragConfig": { # Configuration for Retrieval Augmented Generation feature. # Configuration for Retrieval Augmented Generation feature.
       "enableRag": True or False, # If true, enable Retrieval Augmented Generation in ChatCompletion request. Once enabled, the endpoint will be identified as GenAI endpoint and Arthedain router will be used.
@@ -4604,6 +4627,7 @@ 
Method Details

         "fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment.
           "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model.
         },
+        "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002.
         "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`.
         "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed.
         "modelVersionId": "A String", # Output only. The version ID of the model that is deployed.
@@ -4641,6 +4665,9 @@ 
Method Details

       "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.
     },
     "etag": "A String", # Used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
+    "gdcConfig": { # Google Distributed Cloud (GDC) config. # Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment.
+      "zone": "A String", # GDC zone. A cluster will be designated for the Vertex AI workload in this zone.
+    },
     "genAiAdvancedFeaturesConfig": { # Configuration for GenAiAdvancedFeatures. # Optional. Configuration for GenAiAdvancedFeatures. If the endpoint is serving GenAI models, advanced features like native RAG integration can be configured. Currently, only Model Garden models are supported.
       "ragConfig": { # Configuration for Retrieval Augmented Generation feature. # Configuration for Retrieval Augmented Generation feature.
         "enableRag": True or False, # If true, enable Retrieval Augmented Generation in ChatCompletion request. Once enabled, the endpoint will be identified as GenAI endpoint and Arthedain router will be used.
diff --git a/docs/dyn/aiplatform_v1.projects.locations.html b/docs/dyn/aiplatform_v1.projects.locations.html
index d389991e21c..aaa1cba70ab 100644
--- a/docs/dyn/aiplatform_v1.projects.locations.html
+++ b/docs/dyn/aiplatform_v1.projects.locations.html
@@ -727,6 +727,7 @@ 
Method Details

     "huggingFaceAccessToken": "A String", # Optional. The Hugging Face read access token used to access the model artifacts of gated models.
     "huggingFaceCacheEnabled": True or False, # Optional. If true, the model will deploy with a cached version instead of directly downloading the model artifacts from Hugging Face. This is suitable for VPC-SC users with limited internet access.
     "modelDisplayName": "A String", # Optional. The user-specified display name of the uploaded model. If not set, a default name will be used.
+    "modelUserId": "A String", # Optional. The ID to use for the uploaded Model, which will become the final component of the model resource name. When not provided, Vertex AI will generate a value for this ID. When Model Registry model is provided, this field will be ignored. This value may be up to 63 characters, and valid characters are `[a-z0-9_-]`. The first character cannot be a number or hyphen.
   },
   "publisherModelName": "A String", # The Model Garden model to deploy. Format: `publishers/{publisher}/models/{publisher_model}@{version_id}`, or `publishers/hf-{hugging-face-author}/models/{hugging-face-model-name}@001`.
 }
diff --git a/docs/dyn/aiplatform_v1.projects.locations.tuningJobs.html b/docs/dyn/aiplatform_v1.projects.locations.tuningJobs.html
index 0b134d870ac..b42f511610f 100644
--- a/docs/dyn/aiplatform_v1.projects.locations.tuningJobs.html
+++ b/docs/dyn/aiplatform_v1.projects.locations.tuningJobs.html
@@ -169,7 +169,7 @@ 
Method Details

     "hyperParameters": { # Hyperparameters for SFT. # Optional. Hyperparameters for SFT.
       "adapterSize": "A String", # Optional. Adapter size for tuning.
       "epochCount": "A String", # Optional. Number of complete passes the model makes over the entire training dataset during training.
-      "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`.
+      "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`. This feature is only available for 1P models.
     },
     "trainingDatasetUri": "A String", # Required. Training dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
     "validationDatasetUri": "A String", # Optional. Validation dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
@@ -341,7 +341,7 @@ 
Method Details

     "hyperParameters": { # Hyperparameters for SFT. # Optional. Hyperparameters for SFT.
       "adapterSize": "A String", # Optional. Adapter size for tuning.
       "epochCount": "A String", # Optional. Number of complete passes the model makes over the entire training dataset during training.
-      "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`.
+      "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`. This feature is only available for 1P models.
     },
     "trainingDatasetUri": "A String", # Required. Training dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
     "validationDatasetUri": "A String", # Optional. Validation dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
@@ -520,7 +520,7 @@ 
Method Details

     "hyperParameters": { # Hyperparameters for SFT. # Optional. Hyperparameters for SFT.
       "adapterSize": "A String", # Optional. Adapter size for tuning.
       "epochCount": "A String", # Optional. Number of complete passes the model makes over the entire training dataset during training.
-      "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`.
+      "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`. This feature is only available for 1P models.
     },
     "trainingDatasetUri": "A String", # Required. Training dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
     "validationDatasetUri": "A String", # Optional. Validation dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
@@ -705,7 +705,7 @@ 
Method Details

         "hyperParameters": { # Hyperparameters for SFT. # Optional. Hyperparameters for SFT.
           "adapterSize": "A String", # Optional. Adapter size for tuning.
           "epochCount": "A String", # Optional. Number of complete passes the model makes over the entire training dataset during training.
-          "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`.
+          "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`. This feature is only available for 1P models.
         },
         "trainingDatasetUri": "A String", # Required. Training dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
         "validationDatasetUri": "A String", # Optional. Validation dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
@@ -905,7 +905,7 @@ 
Method Details

       "hyperParameters": { # Hyperparameters for SFT. # Optional. Hyperparameters for SFT.
         "adapterSize": "A String", # Optional. Adapter size for tuning.
         "epochCount": "A String", # Optional. Number of complete passes the model makes over the entire training dataset during training.
-        "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`.
+        "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`. This feature is only available for 1P models.
       },
       "trainingDatasetUri": "A String", # Required. Training dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
       "validationDatasetUri": "A String", # Optional. Validation dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
diff --git a/docs/dyn/aiplatform_v1beta1.projects.html b/docs/dyn/aiplatform_v1beta1.projects.html
index 128e144add0..738f00355a6 100644
--- a/docs/dyn/aiplatform_v1beta1.projects.html
+++ b/docs/dyn/aiplatform_v1beta1.projects.html
@@ -87,9 +87,15 @@ 
Instance Methods

 

   close()

 
Close httplib2 connections.

+

+  fetchPublisherModelConfig(name, x__xgafv=None)

+
Fetches the configs of publisher models.

 

   getCacheConfig(name, x__xgafv=None)

 
Gets a GenAI cache config.

+

+  setPublisherModelConfig(name, body=None, x__xgafv=None)

+
Sets (creates or updates) configs of publisher models. For example, sets the request/response logging config.

 

   updateCacheConfig(name, body=None, x__xgafv=None)

 
Updates a cache config.

@@ -99,6 +105,33 @@ 
Method Details

   
Close httplib2 connections.

 

 
+

+    fetchPublisherModelConfig(name, x__xgafv=None)
+  
Fetches the configs of publisher models.
+
+Args:
+  name: string, Required. The name of the publisher model, in the format of `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # This message contains configs of a publisher model.
+  "loggingConfig": { # Configuration for logging request-response to a BigQuery table. # The prediction request/response logging config.
+    "bigqueryDestination": { # The BigQuery location for the output content. # BigQuery table for logging. If only given a project, a new dataset will be created with name `logging__` where will be made BigQuery-dataset-name compatible (e.g. most special characters will become underscores). If no table name is given, a new table will be created with name `request_response_logging`
+      "outputUri": "A String", # Required. BigQuery URI to a project or table, up to 2000 characters long. When only the project is specified, the Dataset and Table is created. When the full table reference is specified, the Dataset must exist and table must not exist. Accepted forms: * BigQuery path. For example: `bq://projectId` or `bq://projectId.bqDatasetId` or `bq://projectId.bqDatasetId.bqTableId`.
+    },
+    "enableOtelLogging": True or False, # This field is used for large models. If true, in addition to the original large model logs, logs will be converted in OTel schema format, and saved in otel_log column. Default value is false.
+    "enabled": True or False, # If logging is enabled or not.
+    "requestResponseLoggingSchemaVersion": "A String", # Output only. The schema version used in creating the BigQuery table for the request response logging. The versions are "v1" and "v2". The current default version is "v1".
+    "samplingRate": 3.14, # Percentage of requests to be logged, expressed as a fraction in range(0,1].
+  },
+}

+

+
 

     getCacheConfig(name, x__xgafv=None)
   
Gets a GenAI cache config.
@@ -119,6 +152,58 @@ 
Method Details

 }

 

 
+

+    setPublisherModelConfig(name, body=None, x__xgafv=None)
+  
Sets (creates or updates) configs of publisher models. For example, sets the request/response logging config.
+
+Args:
+  name: string, Required. The name of the publisher model, in the format of `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for EndpointService.SetPublisherModelConfig.
+  "publisherModelConfig": { # This message contains configs of a publisher model. # Required. The publisher model config.
+    "loggingConfig": { # Configuration for logging request-response to a BigQuery table. # The prediction request/response logging config.
+      "bigqueryDestination": { # The BigQuery location for the output content. # BigQuery table for logging. If only given a project, a new dataset will be created with name `logging__` where will be made BigQuery-dataset-name compatible (e.g. most special characters will become underscores). If no table name is given, a new table will be created with name `request_response_logging`
+        "outputUri": "A String", # Required. BigQuery URI to a project or table, up to 2000 characters long. When only the project is specified, the Dataset and Table is created. When the full table reference is specified, the Dataset must exist and table must not exist. Accepted forms: * BigQuery path. For example: `bq://projectId` or `bq://projectId.bqDatasetId` or `bq://projectId.bqDatasetId.bqTableId`.
+      },
+      "enableOtelLogging": True or False, # This field is used for large models. If true, in addition to the original large model logs, logs will be converted in OTel schema format, and saved in otel_log column. Default value is false.
+      "enabled": True or False, # If logging is enabled or not.
+      "requestResponseLoggingSchemaVersion": "A String", # Output only. The schema version used in creating the BigQuery table for the request response logging. The versions are "v1" and "v2". The current default version is "v1".
+      "samplingRate": 3.14, # Percentage of requests to be logged, expressed as a fraction in range(0,1].
+    },
+  },
+}
+
+  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.
+  },
+}

+

+
 

     updateCacheConfig(name, body=None, x__xgafv=None)
   
Updates a cache config.
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.deploymentResourcePools.html b/docs/dyn/aiplatform_v1beta1.projects.locations.deploymentResourcePools.html
index ef25e8820ce..545bc9fb358 100644
--- a/docs/dyn/aiplatform_v1beta1.projects.locations.deploymentResourcePools.html
+++ b/docs/dyn/aiplatform_v1beta1.projects.locations.deploymentResourcePools.html
@@ -623,6 +623,7 @@ 
Method Details

       "fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment.
         "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model.
       },
+      "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002.
       "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`.
       "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed.
       "modelVersionId": "A String", # Output only. The version ID of the model that is deployed.
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.html b/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.html
index f4e4cf06368..59d989cb913 100644
--- a/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.html
+++ b/docs/dyn/aiplatform_v1beta1.projects.locations.endpoints.html
@@ -124,14 +124,14 @@ 
Instance Methods

   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, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

+  list(parent, filter=None, gdcZone=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)

 
Lists Endpoints in a Location.

 

   list_next()

 
Retrieves the next page of results.

 

   mutateDeployedModel(endpoint, body=None, x__xgafv=None)

-
Updates an existing deployed model. Updatable fields include `min_replica_count`, `max_replica_count`, `autoscaling_metric_specs`, `disable_container_logging` (v1 only), and `enable_container_logging` (v1beta1 only).

+
Updates an existing deployed model. Updatable fields include `min_replica_count`, `max_replica_count`, `required_replica_count`, `autoscaling_metric_specs`, `disable_container_logging` (v1 only), and `enable_container_logging` (v1beta1 only).

 

   patch(name, body=None, updateMask=None, x__xgafv=None)

 
Updates an Endpoint.

@@ -843,6 +843,7 @@ 
Method Details

       "fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment.
         "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model.
       },
+      "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002.
       "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`.
       "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed.
       "modelVersionId": "A String", # Output only. The version ID of the model that is deployed.
@@ -888,6 +889,9 @@ 
Method Details

     "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.
   },
   "etag": "A String", # Used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
+  "gdcConfig": { # Google Distributed Cloud (GDC) config. # Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment.
+    "zone": "A String", # GDC zone. A cluster will be designated for the Vertex AI workload in this zone.
+  },
   "genAiAdvancedFeaturesConfig": { # Configuration for GenAiAdvancedFeatures. # Optional. Configuration for GenAiAdvancedFeatures. If the endpoint is serving GenAI models, advanced features like native RAG integration can be configured. Currently, only Model Garden models are supported.
     "ragConfig": { # Configuration for Retrieval Augmented Generation feature. # Configuration for Retrieval Augmented Generation feature.
       "enableRag": True or False, # If true, enable Retrieval Augmented Generation in ChatCompletion request. Once enabled, the endpoint will be identified as GenAI endpoint and Arthedain router will be used.
@@ -1165,6 +1169,7 @@ 
Method Details

     "fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment.
       "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model.
     },
+    "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002.
     "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`.
     "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed.
     "modelVersionId": "A String", # Output only. The version ID of the model that is deployed.
@@ -2582,6 +2587,7 @@ 
Method Details

       "fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment.
         "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model.
       },
+      "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002.
       "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`.
       "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed.
       "modelVersionId": "A String", # Output only. The version ID of the model that is deployed.
@@ -2627,6 +2633,9 @@ 
Method Details

     "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.
   },
   "etag": "A String", # Used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
+  "gdcConfig": { # Google Distributed Cloud (GDC) config. # Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment.
+    "zone": "A String", # GDC zone. A cluster will be designated for the Vertex AI workload in this zone.
+  },
   "genAiAdvancedFeaturesConfig": { # Configuration for GenAiAdvancedFeatures. # Optional. Configuration for GenAiAdvancedFeatures. If the endpoint is serving GenAI models, advanced features like native RAG integration can be configured. Currently, only Model Garden models are supported.
     "ragConfig": { # Configuration for Retrieval Augmented Generation feature. # Configuration for Retrieval Augmented Generation feature.
       "enableRag": True or False, # If true, enable Retrieval Augmented Generation in ChatCompletion request. Once enabled, the endpoint will be identified as GenAI endpoint and Arthedain router will be used.
@@ -2710,12 +2719,13 @@ 
Method Details

 

 
 

-    list(parent, filter=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)
+    list(parent, filter=None, gdcZone=None, pageSize=None, pageToken=None, readMask=None, x__xgafv=None)
   
Lists Endpoints in a Location.
 
 Args:
   parent: string, Required. The resource name of the Location from which to list the Endpoints. Format: `projects/{project}/locations/{location}` (required)
   filter: string, Optional. An expression for filtering the results of the request. For field names both snake_case and camelCase are supported. * `endpoint` supports `=` and `!=`. `endpoint` represents the Endpoint ID, i.e. the last segment of the Endpoint's resource name. * `display_name` supports `=` and `!=`. * `labels` supports general map functions that is: * `labels.key=value` - key:value equality * `labels.key:*` or `labels:key` - key existence * A key including a space must be quoted. `labels."a key"`. * `base_model_name` only supports `=`. Some examples: * `endpoint=1` * `displayName="myDisplayName"` * `labels.myKey="myValue"` * `baseModelName="text-bison"`
+  gdcZone: string, Optional. Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment.
   pageSize: integer, Optional. The standard list page size.
   pageToken: string, Optional. The standard list page token. Typically obtained via ListEndpointsResponse.next_page_token of the previous EndpointService.ListEndpoints call.
   readMask: string, Optional. Mask specifying which fields to read.
@@ -2893,6 +2903,7 @@ 
Method Details

           "fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment.
             "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model.
           },
+          "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002.
           "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`.
           "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed.
           "modelVersionId": "A String", # Output only. The version ID of the model that is deployed.
@@ -2938,6 +2949,9 @@ 
Method Details

         "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.
       },
       "etag": "A String", # Used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
+      "gdcConfig": { # Google Distributed Cloud (GDC) config. # Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment.
+        "zone": "A String", # GDC zone. A cluster will be designated for the Vertex AI workload in this zone.
+      },
       "genAiAdvancedFeaturesConfig": { # Configuration for GenAiAdvancedFeatures. # Optional. Configuration for GenAiAdvancedFeatures. If the endpoint is serving GenAI models, advanced features like native RAG integration can be configured. Currently, only Model Garden models are supported.
         "ragConfig": { # Configuration for Retrieval Augmented Generation feature. # Configuration for Retrieval Augmented Generation feature.
           "enableRag": True or False, # If true, enable Retrieval Augmented Generation in ChatCompletion request. Once enabled, the endpoint will be identified as GenAI endpoint and Arthedain router will be used.
@@ -3004,7 +3018,7 @@ 
Method Details

 
 

     mutateDeployedModel(endpoint, body=None, x__xgafv=None)
-  
Updates an existing deployed model. Updatable fields include `min_replica_count`, `max_replica_count`, `autoscaling_metric_specs`, `disable_container_logging` (v1 only), and `enable_container_logging` (v1beta1 only).
+  
Updates an existing deployed model. Updatable fields include `min_replica_count`, `max_replica_count`, `required_replica_count`, `autoscaling_metric_specs`, `disable_container_logging` (v1 only), and `enable_container_logging` (v1beta1 only).
 
 Args:
   endpoint: string, Required. The name of the Endpoint resource into which to mutate a DeployedModel. Format: `projects/{project}/locations/{location}/endpoints/{endpoint}` (required)
@@ -3012,7 +3026,7 @@ 
Method Details

     The object takes the form of:
 
 { # Request message for EndpointService.MutateDeployedModel.
-  "deployedModel": { # A deployment of a Model. Endpoints contain one or more DeployedModels. # Required. The DeployedModel to be mutated within the Endpoint. Only the following fields can be mutated: * `min_replica_count` in either DedicatedResources or AutomaticResources * `max_replica_count` in either DedicatedResources or AutomaticResources * autoscaling_metric_specs * `disable_container_logging` (v1 only) * `enable_container_logging` (v1beta1 only)
+  "deployedModel": { # A deployment of a Model. Endpoints contain one or more DeployedModels. # Required. The DeployedModel to be mutated within the Endpoint. Only the following fields can be mutated: * `min_replica_count` in either DedicatedResources or AutomaticResources * `max_replica_count` in either DedicatedResources or AutomaticResources * `required_replica_count` in DedicatedResources * autoscaling_metric_specs * `disable_container_logging` (v1 only) * `enable_container_logging` (v1beta1 only)
     "automaticResources": { # A description of resources that to large degree are decided by Vertex AI, and require only a modest additional configuration. Each Model supporting these resources documents its specific guidelines. # A description of resources that to large degree are decided by Vertex AI, and require only a modest additional configuration.
       "maxReplicaCount": 42, # Immutable. The maximum number of replicas that may be deployed on when the traffic against it increases. If the requested value is too large, the deployment will error, but if deployment succeeds then the ability to scale to that many replicas is guaranteed (barring service outages). If traffic increases beyond what its replicas at maximum may handle, a portion of the traffic will be dropped. If this value is not provided, a no upper bound for scaling under heavy traffic will be assume, though Vertex AI may be unable to scale beyond certain replica number.
       "minReplicaCount": 42, # Immutable. The minimum number of replicas that will be always deployed on. If traffic against it increases, it may dynamically be deployed onto more replicas up to max_replica_count, and as traffic decreases, some of these extra replicas may be freed. If the requested value is too large, the deployment will error.
@@ -3168,6 +3182,7 @@ 
Method Details

     "fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment.
       "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model.
     },
+    "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002.
     "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`.
     "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed.
     "modelVersionId": "A String", # Output only. The version ID of the model that is deployed.
@@ -3410,6 +3425,7 @@ 
Method Details

       "fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment.
         "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model.
       },
+      "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002.
       "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`.
       "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed.
       "modelVersionId": "A String", # Output only. The version ID of the model that is deployed.
@@ -3455,6 +3471,9 @@ 
Method Details

     "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.
   },
   "etag": "A String", # Used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
+  "gdcConfig": { # Google Distributed Cloud (GDC) config. # Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment.
+    "zone": "A String", # GDC zone. A cluster will be designated for the Vertex AI workload in this zone.
+  },
   "genAiAdvancedFeaturesConfig": { # Configuration for GenAiAdvancedFeatures. # Optional. Configuration for GenAiAdvancedFeatures. If the endpoint is serving GenAI models, advanced features like native RAG integration can be configured. Currently, only Model Garden models are supported.
     "ragConfig": { # Configuration for Retrieval Augmented Generation feature. # Configuration for Retrieval Augmented Generation feature.
       "enableRag": True or False, # If true, enable Retrieval Augmented Generation in ChatCompletion request. Once enabled, the endpoint will be identified as GenAI endpoint and Arthedain router will be used.
@@ -3674,6 +3693,7 @@ 
Method Details

       "fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment.
         "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model.
       },
+      "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002.
       "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`.
       "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed.
       "modelVersionId": "A String", # Output only. The version ID of the model that is deployed.
@@ -3719,6 +3739,9 @@ 
Method Details

     "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.
   },
   "etag": "A String", # Used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
+  "gdcConfig": { # Google Distributed Cloud (GDC) config. # Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment.
+    "zone": "A String", # GDC zone. A cluster will be designated for the Vertex AI workload in this zone.
+  },
   "genAiAdvancedFeaturesConfig": { # Configuration for GenAiAdvancedFeatures. # Optional. Configuration for GenAiAdvancedFeatures. If the endpoint is serving GenAI models, advanced features like native RAG integration can be configured. Currently, only Model Garden models are supported.
     "ragConfig": { # Configuration for Retrieval Augmented Generation feature. # Configuration for Retrieval Augmented Generation feature.
       "enableRag": True or False, # If true, enable Retrieval Augmented Generation in ChatCompletion request. Once enabled, the endpoint will be identified as GenAI endpoint and Arthedain router will be used.
@@ -5052,6 +5075,7 @@ 
Method Details

         "fasterDeploymentConfig": { # Configuration for faster model deployment. # Configuration for faster model deployment.
           "fastTryoutEnabled": True or False, # If true, enable fast tryout feature for this deployed model.
         },
+        "gdcConnectedModel": "A String", # GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002.
         "id": "A String", # Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`.
         "model": "A String", # The resource name of the Model that this is the deployment of. Note that the Model may be in a different location than the DeployedModel's Endpoint. The resource name may contain version id or version alias to specify the version. Example: `projects/{project}/locations/{location}/models/{model}@2` or `projects/{project}/locations/{location}/models/{model}@golden` if no version is specified, the default version will be deployed.
         "modelVersionId": "A String", # Output only. The version ID of the model that is deployed.
@@ -5097,6 +5121,9 @@ 
Method Details

       "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.
     },
     "etag": "A String", # Used to perform consistent read-modify-write updates. If not set, a blind "overwrite" update happens.
+    "gdcConfig": { # Google Distributed Cloud (GDC) config. # Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment.
+      "zone": "A String", # GDC zone. A cluster will be designated for the Vertex AI workload in this zone.
+    },
     "genAiAdvancedFeaturesConfig": { # Configuration for GenAiAdvancedFeatures. # Optional. Configuration for GenAiAdvancedFeatures. If the endpoint is serving GenAI models, advanced features like native RAG integration can be configured. Currently, only Model Garden models are supported.
       "ragConfig": { # Configuration for Retrieval Augmented Generation feature. # Configuration for Retrieval Augmented Generation feature.
         "enableRag": True or False, # If true, enable Retrieval Augmented Generation in ChatCompletion request. Once enabled, the endpoint will be identified as GenAI endpoint and Arthedain router will be used.
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.html b/docs/dyn/aiplatform_v1beta1.projects.locations.html
index 50d5f52bfbc..f0804848b5d 100644
--- a/docs/dyn/aiplatform_v1beta1.projects.locations.html
+++ b/docs/dyn/aiplatform_v1beta1.projects.locations.html
@@ -636,6 +636,10 @@ 
Method Details

     The object takes the form of:
 
 { # Request message for ModelGardenService.Deploy.
+  "customModel": { # The custom model to deploy from model weights in a Google Cloud Storage URI or Model Registry model. # The custom model to deploy from a Google Cloud Storage URI.
+    "gcsUri": "A String", # Immutable. The Google Cloud Storage URI of the custom model, storing weights and config files (which can be used to infer the base model).
+    "modelId": "A String", # Optional. Deprecated. Use ModelConfig.model_user_id instead.
+  },
   "deployConfig": { # The deploy config to use for the deployment. # Optional. The deploy config to use for the deployment. If not specified, the default deploy config will be used.
     "dedicatedResources": { # A description of resources that are dedicated to a DeployedModel or DeployedIndex, and that need a higher degree of manual configuration. # Optional. The dedicated resources to use for the endpoint. If not set, the default resources will be used.
       "autoscalingMetricSpecs": [ # Immutable. The metric specifications that overrides a resource utilization metric (CPU utilization, accelerator's duty cycle, and so on) target value (default to 60 if not set). At most one entry is allowed per metric. If machine_spec.accelerator_count is above 0, the autoscaling will be based on both CPU utilization and accelerator's duty cycle metrics and scale up when either metrics exceeds its target value while scale down if both metrics are under their target value. The default target value is 60 for both metrics. If machine_spec.accelerator_count is 0, the autoscaling will be based on CPU utilization metric only with default target value 60 if not explicitly set. For example, in the case of Online Prediction, if you want to override target CPU utilization to 80, you should set autoscaling_metric_specs.metric_name to `aiplatform.googleapis.com/prediction/online/cpu/utilization` and autoscaling_metric_specs.target to `80`.
@@ -807,6 +811,7 @@ 
Method Details

     "huggingFaceAccessToken": "A String", # Optional. The Hugging Face read access token used to access the model artifacts of gated models.
     "huggingFaceCacheEnabled": True or False, # Optional. If true, the model will deploy with a cached version instead of directly downloading the model artifacts from Hugging Face. This is suitable for VPC-SC users with limited internet access.
     "modelDisplayName": "A String", # Optional. The user-specified display name of the uploaded model. If not set, a default name will be used.
+    "modelUserId": "A String", # Optional. The ID to use for the uploaded Model, which will become the final component of the model resource name. When not provided, Vertex AI will generate a value for this ID. When Model Registry model is provided, this field will be ignored. This value may be up to 63 characters, and valid characters are `[a-z0-9_-]`. The first character cannot be a number or hyphen.
   },
   "publisherModelName": "A String", # The Model Garden model to deploy. Format: `publishers/{publisher}/models/{publisher_model}@{version_id}`, or `publishers/hf-{hugging-face-author}/models/{hugging-face-model-name}@001`.
 }
diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.html b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.html
index 8c59151bf55..4a2aef06bae 100644
--- a/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.html
+++ b/docs/dyn/aiplatform_v1beta1.projects.locations.reasoningEngines.sessions.html
@@ -281,10 +281,12 @@ 
Method Details

 { # A session contains a set of actions between users and Vertex agents.
   "createTime": "A String", # Output only. Timestamp when the session was created.
   "displayName": "A String", # Optional. The display name of the session.
+  "expireTime": "A String", # Optional. Timestamp of when this session is considered expired. This is *always* provided on output, regardless of what was sent on input.
   "name": "A String", # Identifier. The resource name of the session. Format: 'projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}'.
   "sessionState": { # Optional. Session specific memory which stores key conversation points.
     "a_key": "", # Properties of the object.
   },
+  "ttl": "A String", # Optional. Input only. The TTL for this session.
   "updateTime": "A String", # Output only. Timestamp when the session was updated.
   "userId": "A String", # Required. Immutable. String id provided by the user
 }
@@ -370,10 +372,12 @@ 
Method Details

     { # A session contains a set of actions between users and Vertex agents.
   "createTime": "A String", # Output only. Timestamp when the session was created.
   "displayName": "A String", # Optional. The display name of the session.
+  "expireTime": "A String", # Optional. Timestamp of when this session is considered expired. This is *always* provided on output, regardless of what was sent on input.
   "name": "A String", # Identifier. The resource name of the session. Format: 'projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}'.
   "sessionState": { # Optional. Session specific memory which stores key conversation points.
     "a_key": "", # Properties of the object.
   },
+  "ttl": "A String", # Optional. Input only. The TTL for this session.
   "updateTime": "A String", # Output only. Timestamp when the session was updated.
   "userId": "A String", # Required. Immutable. String id provided by the user
 }

@@ -403,10 +407,12 @@ 
Method Details

     { # A session contains a set of actions between users and Vertex agents.
       "createTime": "A String", # Output only. Timestamp when the session was created.
       "displayName": "A String", # Optional. The display name of the session.
+      "expireTime": "A String", # Optional. Timestamp of when this session is considered expired. This is *always* provided on output, regardless of what was sent on input.
       "name": "A String", # Identifier. The resource name of the session. Format: 'projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}'.
       "sessionState": { # Optional. Session specific memory which stores key conversation points.
         "a_key": "", # Properties of the object.
       },
+      "ttl": "A String", # Optional. Input only. The TTL for this session.
       "updateTime": "A String", # Output only. Timestamp when the session was updated.
       "userId": "A String", # Required. Immutable. String id provided by the user
     },
@@ -440,10 +446,12 @@ 
Method Details

 { # A session contains a set of actions between users and Vertex agents.
   "createTime": "A String", # Output only. Timestamp when the session was created.
   "displayName": "A String", # Optional. The display name of the session.
+  "expireTime": "A String", # Optional. Timestamp of when this session is considered expired. This is *always* provided on output, regardless of what was sent on input.
   "name": "A String", # Identifier. The resource name of the session. Format: 'projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}'.
   "sessionState": { # Optional. Session specific memory which stores key conversation points.
     "a_key": "", # Properties of the object.
   },
+  "ttl": "A String", # Optional. Input only. The TTL for this session.
   "updateTime": "A String", # Output only. Timestamp when the session was updated.
   "userId": "A String", # Required. Immutable. String id provided by the user
 }
@@ -460,10 +468,12 @@ 
Method Details

     { # A session contains a set of actions between users and Vertex agents.
   "createTime": "A String", # Output only. Timestamp when the session was created.
   "displayName": "A String", # Optional. The display name of the session.
+  "expireTime": "A String", # Optional. Timestamp of when this session is considered expired. This is *always* provided on output, regardless of what was sent on input.
   "name": "A String", # Identifier. The resource name of the session. Format: 'projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}'.
   "sessionState": { # Optional. Session specific memory which stores key conversation points.
     "a_key": "", # Properties of the object.
   },
+  "ttl": "A String", # Optional. Input only. The TTL for this session.
   "updateTime": "A String", # Output only. Timestamp when the session was updated.
   "userId": "A String", # Required. Immutable. String id provided by the user
 }

diff --git a/docs/dyn/aiplatform_v1beta1.projects.locations.tuningJobs.html b/docs/dyn/aiplatform_v1beta1.projects.locations.tuningJobs.html
index a1e55f551b9..5a81d21f136 100644
--- a/docs/dyn/aiplatform_v1beta1.projects.locations.tuningJobs.html
+++ b/docs/dyn/aiplatform_v1beta1.projects.locations.tuningJobs.html
@@ -192,7 +192,7 @@ 
Method Details

     "hyperParameters": { # Hyperparameters for SFT. # Optional. Hyperparameters for SFT.
       "adapterSize": "A String", # Optional. Adapter size for tuning.
       "epochCount": "A String", # Optional. Number of complete passes the model makes over the entire training dataset during training.
-      "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`.
+      "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`. This feature is only available for 1P models.
     },
     "trainingDatasetUri": "A String", # Required. Training dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
     "validationDatasetUri": "A String", # Optional. Validation dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
@@ -493,7 +493,7 @@ 
Method Details

     "hyperParameters": { # Hyperparameters for SFT. # Optional. Hyperparameters for SFT.
       "adapterSize": "A String", # Optional. Adapter size for tuning.
       "epochCount": "A String", # Optional. Number of complete passes the model makes over the entire training dataset during training.
-      "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`.
+      "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`. This feature is only available for 1P models.
     },
     "trainingDatasetUri": "A String", # Required. Training dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
     "validationDatasetUri": "A String", # Optional. Validation dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
@@ -801,7 +801,7 @@ 
Method Details

     "hyperParameters": { # Hyperparameters for SFT. # Optional. Hyperparameters for SFT.
       "adapterSize": "A String", # Optional. Adapter size for tuning.
       "epochCount": "A String", # Optional. Number of complete passes the model makes over the entire training dataset during training.
-      "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`.
+      "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`. This feature is only available for 1P models.
     },
     "trainingDatasetUri": "A String", # Required. Training dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
     "validationDatasetUri": "A String", # Optional. Validation dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
@@ -1115,7 +1115,7 @@ 
Method Details

         "hyperParameters": { # Hyperparameters for SFT. # Optional. Hyperparameters for SFT.
           "adapterSize": "A String", # Optional. Adapter size for tuning.
           "epochCount": "A String", # Optional. Number of complete passes the model makes over the entire training dataset during training.
-          "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`.
+          "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`. This feature is only available for 1P models.
         },
         "trainingDatasetUri": "A String", # Required. Training dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
         "validationDatasetUri": "A String", # Optional. Validation dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
@@ -1444,7 +1444,7 @@ 
Method Details

       "hyperParameters": { # Hyperparameters for SFT. # Optional. Hyperparameters for SFT.
         "adapterSize": "A String", # Optional. Adapter size for tuning.
         "epochCount": "A String", # Optional. Number of complete passes the model makes over the entire training dataset during training.
-        "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`.
+        "learningRateMultiplier": 3.14, # Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`. This feature is only available for 1P models.
       },
       "trainingDatasetUri": "A String", # Required. Training dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
       "validationDatasetUri": "A String", # Optional. Validation dataset used for tuning. The dataset can be specified as either a Cloud Storage path to a JSONL file or as the resource name of a Vertex Multimodal Dataset.
diff --git a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.html b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.html
index 3aacaafb4bf..9c353c1a8b0 100644
--- a/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.html
+++ b/docs/dyn/aiplatform_v1beta1.reasoningEngines.sessions.html
@@ -276,10 +276,12 @@ 
Method Details

 { # A session contains a set of actions between users and Vertex agents.
   "createTime": "A String", # Output only. Timestamp when the session was created.
   "displayName": "A String", # Optional. The display name of the session.
+  "expireTime": "A String", # Optional. Timestamp of when this session is considered expired. This is *always* provided on output, regardless of what was sent on input.
   "name": "A String", # Identifier. The resource name of the session. Format: 'projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}'.
   "sessionState": { # Optional. Session specific memory which stores key conversation points.
     "a_key": "", # Properties of the object.
   },
+  "ttl": "A String", # Optional. Input only. The TTL for this session.
   "updateTime": "A String", # Output only. Timestamp when the session was updated.
   "userId": "A String", # Required. Immutable. String id provided by the user
 }
@@ -365,10 +367,12 @@ 
Method Details

     { # A session contains a set of actions between users and Vertex agents.
   "createTime": "A String", # Output only. Timestamp when the session was created.
   "displayName": "A String", # Optional. The display name of the session.
+  "expireTime": "A String", # Optional. Timestamp of when this session is considered expired. This is *always* provided on output, regardless of what was sent on input.
   "name": "A String", # Identifier. The resource name of the session. Format: 'projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}'.
   "sessionState": { # Optional. Session specific memory which stores key conversation points.
     "a_key": "", # Properties of the object.
   },
+  "ttl": "A String", # Optional. Input only. The TTL for this session.
   "updateTime": "A String", # Output only. Timestamp when the session was updated.
   "userId": "A String", # Required. Immutable. String id provided by the user
 }

@@ -398,10 +402,12 @@ 
Method Details

     { # A session contains a set of actions between users and Vertex agents.
       "createTime": "A String", # Output only. Timestamp when the session was created.
       "displayName": "A String", # Optional. The display name of the session.
+      "expireTime": "A String", # Optional. Timestamp of when this session is considered expired. This is *always* provided on output, regardless of what was sent on input.
       "name": "A String", # Identifier. The resource name of the session. Format: 'projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}'.
       "sessionState": { # Optional. Session specific memory which stores key conversation points.
         "a_key": "", # Properties of the object.
       },
+      "ttl": "A String", # Optional. Input only. The TTL for this session.
       "updateTime": "A String", # Output only. Timestamp when the session was updated.
       "userId": "A String", # Required. Immutable. String id provided by the user
     },
@@ -435,10 +441,12 @@ 
Method Details

 { # A session contains a set of actions between users and Vertex agents.
   "createTime": "A String", # Output only. Timestamp when the session was created.
   "displayName": "A String", # Optional. The display name of the session.
+  "expireTime": "A String", # Optional. Timestamp of when this session is considered expired. This is *always* provided on output, regardless of what was sent on input.
   "name": "A String", # Identifier. The resource name of the session. Format: 'projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}'.
   "sessionState": { # Optional. Session specific memory which stores key conversation points.
     "a_key": "", # Properties of the object.
   },
+  "ttl": "A String", # Optional. Input only. The TTL for this session.
   "updateTime": "A String", # Output only. Timestamp when the session was updated.
   "userId": "A String", # Required. Immutable. String id provided by the user
 }
@@ -455,10 +463,12 @@ 
Method Details

     { # A session contains a set of actions between users and Vertex agents.
   "createTime": "A String", # Output only. Timestamp when the session was created.
   "displayName": "A String", # Optional. The display name of the session.
+  "expireTime": "A String", # Optional. Timestamp of when this session is considered expired. This is *always* provided on output, regardless of what was sent on input.
   "name": "A String", # Identifier. The resource name of the session. Format: 'projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}'.
   "sessionState": { # Optional. Session specific memory which stores key conversation points.
     "a_key": "", # Properties of the object.
   },
+  "ttl": "A String", # Optional. Input only. The TTL for this session.
   "updateTime": "A String", # Output only. Timestamp when the session was updated.
   "userId": "A String", # Required. Immutable. String id provided by the user
 }
diff --git a/googleapiclient/discovery_cache/documents/aiplatform.v1.json b/googleapiclient/discovery_cache/documents/aiplatform.v1.json index 67510eb028a..5215ba949b1 100644 --- a/googleapiclient/discovery_cache/documents/aiplatform.v1.json +++ b/googleapiclient/discovery_cache/documents/aiplatform.v1.json @@ -4543,6 +4543,11 @@ "location": "query", "type": "string" }, +"gdcZone": { +"description": "Optional. Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment.", +"location": "query", +"type": "string" +}, "orderBy": { "description": "A comma-separated list of fields to order by, sorted in ascending order. Use \"desc\" after a field name for descending. Supported fields: * `display_name` * `create_time` * `update_time` Example: `display_name, create_time desc`.", "location": "query", @@ -4582,7 +4587,7 @@ ] }, "mutateDeployedModel": { -"description": "Updates an existing deployed model. Updatable fields include `min_replica_count`, `max_replica_count`, `autoscaling_metric_specs`, `disable_container_logging` (v1 only), and `enable_container_logging` (v1beta1 only).", +"description": "Updates an existing deployed model. Updatable fields include `min_replica_count`, `max_replica_count`, `required_replica_count`, `autoscaling_metric_specs`, `disable_container_logging` (v1 only), and `enable_container_logging` (v1beta1 only).", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:mutateDeployedModel", "httpMethod": "POST", "id": "aiplatform.projects.locations.endpoints.mutateDeployedModel", @@ -20253,7 +20258,7 @@ } } }, -"revision": "20250711", +"revision": "20250715", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionGenerateVideoResponse": { @@ -24410,6 +24415,10 @@ "modelDisplayName": { "description": "Optional. The user-specified display name of the uploaded model. If not set, a default name will be used.", "type": "string" +}, +"modelUserId": { +"description": "Optional. The ID to use for the uploaded Model, which will become the final component of the model resource name. When not provided, Vertex AI will generate a value for this ID. When Model Registry model is provided, this field will be ignored. This value may be up to 63 characters, and valid characters are `[a-z0-9_-]`. The first character cannot be a number or hyphen.", +"type": "string" } }, "type": "object" @@ -24608,6 +24617,10 @@ "$ref": "GoogleCloudAiplatformV1FasterDeploymentConfig", "description": "Configuration for faster model deployment." }, +"gdcConnectedModel": { +"description": "GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002.", +"type": "string" +}, "id": { "description": "Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`.", "type": "string" @@ -24960,6 +24973,10 @@ "description": "Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens.", "type": "string" }, +"gdcConfig": { +"$ref": "GoogleCloudAiplatformV1GdcConfig", +"description": "Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment." +}, "genAiAdvancedFeaturesConfig": { "$ref": "GoogleCloudAiplatformV1GenAiAdvancedFeaturesConfig", "description": "Optional. Configuration for GenAiAdvancedFeatures. If the endpoint is serving GenAI models, advanced features like native RAG integration can be configured. Currently, only Model Garden models are supported." @@ -28374,6 +28391,17 @@ }, "type": "object" }, +"GoogleCloudAiplatformV1GdcConfig": { +"description": "Google Distributed Cloud (GDC) config.", +"id": "GoogleCloudAiplatformV1GdcConfig", +"properties": { +"zone": { +"description": "GDC zone. A cluster will be designated for the Vertex AI workload in this zone.", +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudAiplatformV1GenAiAdvancedFeaturesConfig": { "description": "Configuration for GenAiAdvancedFeatures.", "id": "GoogleCloudAiplatformV1GenAiAdvancedFeaturesConfig", @@ -33045,7 +33073,7 @@ false "properties": { "deployedModel": { "$ref": "GoogleCloudAiplatformV1DeployedModel", -"description": "Required. The DeployedModel to be mutated within the Endpoint. Only the following fields can be mutated: * `min_replica_count` in either DedicatedResources or AutomaticResources * `max_replica_count` in either DedicatedResources or AutomaticResources * autoscaling_metric_specs * `disable_container_logging` (v1 only) * `enable_container_logging` (v1beta1 only)" +"description": "Required. The DeployedModel to be mutated within the Endpoint. Only the following fields can be mutated: * `min_replica_count` in either DedicatedResources or AutomaticResources * `max_replica_count` in either DedicatedResources or AutomaticResources * `required_replica_count` in DedicatedResources * autoscaling_metric_specs * `disable_container_logging` (v1 only) * `enable_container_logging` (v1beta1 only)" }, "updateMask": { "description": "Required. The update mask applies to the resource. See google.protobuf.FieldMask.", @@ -44628,7 +44656,7 @@ false "type": "string" }, "learningRateMultiplier": { -"description": "Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`.", +"description": "Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`. This feature is only available for 1P models.", "format": "double", "type": "number" } diff --git a/googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json b/googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json index d4a07ec4856..7b5fcdabd3f 100644 --- a/googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/aiplatform.v1beta1.json @@ -1070,6 +1070,31 @@ }, "projects": { "methods": { +"fetchPublisherModelConfig": { +"description": "Fetches the configs of publisher models.", +"flatPath": "v1beta1/projects/{projectsId}:fetchPublisherModelConfig", +"httpMethod": "GET", +"id": "aiplatform.projects.fetchPublisherModelConfig", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The name of the publisher model, in the format of `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`.", +"location": "path", +"pattern": "^projects/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1beta1/{+name}:fetchPublisherModelConfig", +"response": { +"$ref": "GoogleCloudAiplatformV1beta1PublisherModelConfig" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, "getCacheConfig": { "description": "Gets a GenAI cache config.", "flatPath": "v1beta1/projects/{projectsId}/cacheConfig", @@ -1095,6 +1120,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, +"setPublisherModelConfig": { +"description": "Sets (creates or updates) configs of publisher models. For example, sets the request/response logging config.", +"flatPath": "v1beta1/projects/{projectsId}:setPublisherModelConfig", +"httpMethod": "POST", +"id": "aiplatform.projects.setPublisherModelConfig", +"parameterOrder": [ +"name" +], +"parameters": { +"name": { +"description": "Required. The name of the publisher model, in the format of `projects/{project}/locations/{location}/publishers/{publisher}/models/{model}`.", +"location": "path", +"pattern": "^projects/[^/]+$", +"required": true, +"type": "string" +} +}, +"path": "v1beta1/{+name}:setPublisherModelConfig", +"request": { +"$ref": "GoogleCloudAiplatformV1beta1SetPublisherModelConfigRequest" +}, +"response": { +"$ref": "GoogleLongrunningOperation" +}, +"scopes": [ +"https://www.googleapis.com/auth/cloud-platform" +] +}, "updateCacheConfig": { "description": "Updates a cache config.", "flatPath": "v1beta1/projects/{projectsId}/cacheConfig", @@ -5126,6 +5179,11 @@ "location": "query", "type": "string" }, +"gdcZone": { +"description": "Optional. Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment.", +"location": "query", +"type": "string" +}, "pageSize": { "description": "Optional. The standard list page size.", "format": "int32", @@ -5160,7 +5218,7 @@ ] }, "mutateDeployedModel": { -"description": "Updates an existing deployed model. Updatable fields include `min_replica_count`, `max_replica_count`, `autoscaling_metric_specs`, `disable_container_logging` (v1 only), and `enable_container_logging` (v1beta1 only).", +"description": "Updates an existing deployed model. Updatable fields include `min_replica_count`, `max_replica_count`, `required_replica_count`, `autoscaling_metric_specs`, `disable_container_logging` (v1 only), and `enable_container_logging` (v1beta1 only).", "flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/endpoints/{endpointsId}:mutateDeployedModel", "httpMethod": "POST", "id": "aiplatform.projects.locations.endpoints.mutateDeployedModel", @@ -25262,7 +25320,7 @@ } } }, -"revision": "20250711", +"revision": "20250715", "rootUrl": "https://aiplatform.googleapis.com/", "schemas": { "CloudAiLargeModelsVisionGenerateVideoResponse": { @@ -29768,6 +29826,10 @@ "description": "Request message for ModelGardenService.Deploy.", "id": "GoogleCloudAiplatformV1beta1DeployRequest", "properties": { +"customModel": { +"$ref": "GoogleCloudAiplatformV1beta1DeployRequestCustomModel", +"description": "The custom model to deploy from a Google Cloud Storage URI." +}, "deployConfig": { "$ref": "GoogleCloudAiplatformV1beta1DeployRequestDeployConfig", "description": "Optional. The deploy config to use for the deployment. If not specified, the default deploy config will be used." @@ -29791,6 +29853,22 @@ }, "type": "object" }, +"GoogleCloudAiplatformV1beta1DeployRequestCustomModel": { +"description": "The custom model to deploy from model weights in a Google Cloud Storage URI or Model Registry model.", +"id": "GoogleCloudAiplatformV1beta1DeployRequestCustomModel", +"properties": { +"gcsUri": { +"description": "Immutable. The Google Cloud Storage URI of the custom model, storing weights and config files (which can be used to infer the base model).", +"type": "string" +}, +"modelId": { +"deprecated": true, +"description": "Optional. Deprecated. Use ModelConfig.model_user_id instead.", +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudAiplatformV1beta1DeployRequestDeployConfig": { "description": "The deploy config to use for the deployment.", "id": "GoogleCloudAiplatformV1beta1DeployRequestDeployConfig", @@ -29851,6 +29929,10 @@ "modelDisplayName": { "description": "Optional. The user-specified display name of the uploaded model. If not set, a default name will be used.", "type": "string" +}, +"modelUserId": { +"description": "Optional. The ID to use for the uploaded Model, which will become the final component of the model resource name. When not provided, Vertex AI will generate a value for this ID. When Model Registry model is provided, this field will be ignored. This value may be up to 63 characters, and valid characters are `[a-z0-9_-]`. The first character cannot be a number or hyphen.", +"type": "string" } }, "type": "object" @@ -30038,6 +30120,10 @@ "$ref": "GoogleCloudAiplatformV1beta1FasterDeploymentConfig", "description": "Configuration for faster model deployment." }, +"gdcConnectedModel": { +"description": "GDC pretrained / Gemini model name. The model name is a plain model name, e.g. gemini-1.5-flash-002.", +"type": "string" +}, "id": { "description": "Immutable. The ID of the DeployedModel. If not provided upon deployment, Vertex AI will generate a value for this ID. This value should be 1-10 characters, and valid characters are `/[0-9]/`.", "type": "string" @@ -30483,6 +30569,10 @@ "description": "Used to perform consistent read-modify-write updates. If not set, a blind \"overwrite\" update happens.", "type": "string" }, +"gdcConfig": { +"$ref": "GoogleCloudAiplatformV1beta1GdcConfig", +"description": "Configures the Google Distributed Cloud (GDC) environment for online prediction. Only set this field when the Endpoint is to be deployed in a GDC environment." +}, "genAiAdvancedFeaturesConfig": { "$ref": "GoogleCloudAiplatformV1beta1GenAiAdvancedFeaturesConfig", "description": "Optional. Configuration for GenAiAdvancedFeatures. If the endpoint is serving GenAI models, advanced features like native RAG integration can be configured. Currently, only Model Garden models are supported." @@ -34787,6 +34877,17 @@ }, "type": "object" }, +"GoogleCloudAiplatformV1beta1GdcConfig": { +"description": "Google Distributed Cloud (GDC) config.", +"id": "GoogleCloudAiplatformV1beta1GdcConfig", +"properties": { +"zone": { +"description": "GDC zone. A cluster will be designated for the Vertex AI workload in this zone.", +"type": "string" +} +}, +"type": "object" +}, "GoogleCloudAiplatformV1beta1GeminiExample": { "description": "Format for Gemini examples used for Vertex Multimodal datasets.", "id": "GoogleCloudAiplatformV1beta1GeminiExample", @@ -40896,7 +40997,7 @@ false "properties": { "deployedModel": { "$ref": "GoogleCloudAiplatformV1beta1DeployedModel", -"description": "Required. The DeployedModel to be mutated within the Endpoint. Only the following fields can be mutated: * `min_replica_count` in either DedicatedResources or AutomaticResources * `max_replica_count` in either DedicatedResources or AutomaticResources * autoscaling_metric_specs * `disable_container_logging` (v1 only) * `enable_container_logging` (v1beta1 only)" +"description": "Required. The DeployedModel to be mutated within the Endpoint. Only the following fields can be mutated: * `min_replica_count` in either DedicatedResources or AutomaticResources * `max_replica_count` in either DedicatedResources or AutomaticResources * `required_replica_count` in DedicatedResources * autoscaling_metric_specs * `disable_container_logging` (v1 only) * `enable_container_logging` (v1beta1 only)" }, "updateMask": { "description": "Required. The update mask applies to the resource. See google.protobuf.FieldMask.", @@ -52408,6 +52509,11 @@ false "description": "Optional. The display name of the session.", "type": "string" }, +"expireTime": { +"description": "Optional. Timestamp of when this session is considered expired. This is *always* provided on output, regardless of what was sent on input.", +"format": "google-datetime", +"type": "string" +}, "name": { "description": "Identifier. The resource name of the session. Format: 'projects/{project}/locations/{location}/reasoningEngines/{reasoning_engine}/sessions/{session}'.", "type": "string" @@ -52420,6 +52526,11 @@ false "description": "Optional. Session specific memory which stores key conversation points.", "type": "object" }, +"ttl": { +"description": "Optional. Input only. The TTL for this session.", +"format": "google-duration", +"type": "string" +}, "updateTime": { "description": "Output only. Timestamp when the session was updated.", "format": "google-datetime", @@ -53946,7 +54057,7 @@ false "type": "string" }, "learningRateMultiplier": { -"description": "Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`.", +"description": "Optional. Multiplier for adjusting the default learning rate. Mutually exclusive with `learning_rate`. This feature is only available for 1P models.", "format": "double", "type": "number" } From 71f3631e33488930fdf9db546f648329eb8ebc4f Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 29 Jul 2025 07:12:11 +0000 Subject: [PATCH 02/36] feat(alloydb): update the api #### alloydb:v1 The following keys were added: - schemas.StageSchedule (Total Keys: 10) - schemas.StageStatus.properties.schedule (Total Keys: 2) - schemas.StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration (Total Keys: 3) - schemas.StorageDatabasecenterPartnerapiV1mainConfigBasedSignalData (Total Keys: 8) - schemas.StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed.properties.configBasedSignalData.$ref (Total Keys: 1) - schemas.StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata.properties.backupdrConfiguration.$ref (Total Keys: 1) - schemas.StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata.properties.gcbdrConfiguration.deprecated (Total Keys: 1) - schemas.StorageDatabasecenterProtoCommonProduct.properties.minorVersion.type (Total Keys: 1) #### alloydb:v1alpha The following keys were added: - schemas.StageSchedule (Total Keys: 10) - schemas.StageStatus.properties.schedule (Total Keys: 2) - schemas.StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration (Total Keys: 3) - schemas.StorageDatabasecenterPartnerapiV1mainConfigBasedSignalData (Total Keys: 8) - schemas.StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed.properties.configBasedSignalData.$ref (Total Keys: 1) - schemas.StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata.properties.backupdrConfiguration.$ref (Total Keys: 1) - schemas.StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata.properties.gcbdrConfiguration.deprecated (Total Keys: 1) - schemas.StorageDatabasecenterProtoCommonProduct.properties.minorVersion.type (Total Keys: 1) #### alloydb:v1beta The following keys were added: - schemas.StageSchedule (Total Keys: 10) - schemas.StageStatus.properties.schedule (Total Keys: 2) - schemas.StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration (Total Keys: 3) - schemas.StorageDatabasecenterPartnerapiV1mainConfigBasedSignalData (Total Keys: 8) - schemas.StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed.properties.configBasedSignalData.$ref (Total Keys: 1) - schemas.StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata.properties.backupdrConfiguration.$ref (Total Keys: 1) - schemas.StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata.properties.gcbdrConfiguration.deprecated (Total Keys: 1) - schemas.StorageDatabasecenterProtoCommonProduct.properties.minorVersion.type (Total Keys: 1) --- .../discovery_cache/documents/alloydb.v1.json | 153 ++++++++++++++++-- .../documents/alloydb.v1alpha.json | 153 ++++++++++++++++-- .../documents/alloydb.v1beta.json | 153 ++++++++++++++++-- 3 files changed, 432 insertions(+), 27 deletions(-) diff --git a/googleapiclient/discovery_cache/documents/alloydb.v1.json b/googleapiclient/discovery_cache/documents/alloydb.v1.json index bc904911a5f..4856e7a863c 100644 --- a/googleapiclient/discovery_cache/documents/alloydb.v1.json +++ b/googleapiclient/discovery_cache/documents/alloydb.v1.json @@ -1622,7 +1622,7 @@ } } }, -"revision": "20250612", +"revision": "20250723", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -3888,6 +3888,33 @@ false }, "type": "object" }, +"StageSchedule": { +"description": "Timing information for the stage execution.", +"id": "StageSchedule", +"properties": { +"actualEndTime": { +"description": "Actual end time of the stage. Set only if the stage has completed.", +"format": "google-datetime", +"type": "string" +}, +"actualStartTime": { +"description": "Actual start time of the stage. Set only if the stage has started.", +"format": "google-datetime", +"type": "string" +}, +"estimatedEndTime": { +"description": "When the stage is expected to end. Set only if the stage has not completed yet.", +"format": "google-datetime", +"type": "string" +}, +"estimatedStartTime": { +"description": "When the stage is expected to start. Set only if the stage has not started yet.", +"format": "google-datetime", +"type": "string" +} +}, +"type": "object" +}, "StageStatus": { "description": "Status of an upgrade stage.", "id": "StageStatus", @@ -3896,6 +3923,11 @@ false "$ref": "ReadPoolInstancesUpgradeStageStatus", "description": "Read pool instances upgrade metadata." }, +"schedule": { +"$ref": "StageSchedule", +"description": "Output only. Timing information for the stage execution.", +"readOnly": true +}, "stage": { "description": "Upgrade stage.", "enum": [ @@ -4059,6 +4091,17 @@ false }, "type": "object" }, +"StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration": { +"description": "BackupDRConfiguration to capture the backup and disaster recovery details of database resource.", +"id": "StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration", +"properties": { +"backupdrManaged": { +"description": "Indicates if the resource is managed by BackupDR.", +"type": "boolean" +} +}, +"type": "object" +}, "StorageDatabasecenterPartnerapiV1mainBackupRun": { "description": "A backup run.", "id": "StorageDatabasecenterPartnerapiV1mainBackupRun", @@ -4109,6 +4152,50 @@ false }, "type": "object" }, +"StorageDatabasecenterPartnerapiV1mainConfigBasedSignalData": { +"description": "Config based signal data. This is used to send signals to Condor which are based on the DB level configurations. These will be used to send signals for self managed databases.", +"id": "StorageDatabasecenterPartnerapiV1mainConfigBasedSignalData", +"properties": { +"fullResourceName": { +"description": "Required. Full Resource name of the source resource.", +"type": "string" +}, +"lastRefreshTime": { +"description": "Required. Last time signal was refreshed", +"format": "google-datetime", +"type": "string" +}, +"resourceId": { +"$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceId", +"description": "Database resource id." +}, +"signalBoolValue": { +"description": "Signal data for boolean signals.", +"type": "boolean" +}, +"signalType": { +"description": "Required. Signal type of the signal", +"enum": [ +"SIGNAL_TYPE_UNSPECIFIED", +"SIGNAL_TYPE_OUTDATED_MINOR_VERSION", +"SIGNAL_TYPE_DATABASE_AUDITING_DISABLED", +"SIGNAL_TYPE_NO_ROOT_PASSWORD", +"SIGNAL_TYPE_EXPOSED_TO_PUBLIC_ACCESS", +"SIGNAL_TYPE_UNENCRYPTED_CONNECTIONS" +], +"enumDescriptions": [ +"Unspecified signal type.", +"Outdated Minor Version", +"Represents database auditing is disabled.", +"Represents if a database has a password configured for the root account or not.", +"Represents if a resource is exposed to public access.", +"Represents if a resources requires all incoming connections to use SSL or not." +], +"type": "string" +} +}, +"type": "object" +}, "StorageDatabasecenterPartnerapiV1mainCustomMetadataData": { "description": "Any custom metadata associated with the resource. e.g. A spanner instance can have multiple databases with its own unique metadata. Information for these individual databases can be captured in custom metadata data", "id": "StorageDatabasecenterPartnerapiV1mainCustomMetadataData", @@ -4124,9 +4211,13 @@ false "type": "object" }, "StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed": { -"description": "DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform. Next ID: 8", +"description": "DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform. Next ID: 9", "id": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed", "properties": { +"configBasedSignalData": { +"$ref": "StorageDatabasecenterPartnerapiV1mainConfigBasedSignalData", +"description": "Config based signal data is used to ingest signals that are generated based on the configuration of the database resource." +}, "feedTimestamp": { "description": "Required. Timestamp when feed is generated.", "format": "google-datetime", @@ -4139,14 +4230,16 @@ false "RESOURCE_METADATA", "OBSERVABILITY_DATA", "SECURITY_FINDING_DATA", -"RECOMMENDATION_SIGNAL_DATA" +"RECOMMENDATION_SIGNAL_DATA", +"CONFIG_BASED_SIGNAL_DATA" ], "enumDescriptions": [ "", "Database resource metadata feed from control plane", "Database resource monitoring data", "Database resource security health signal data", -"Database resource recommendation signal data" +"Database resource recommendation signal data", +"Database config based signal data" ], "type": "string" }, @@ -4380,7 +4473,12 @@ false "SIGNAL_TYPE_HIGH_WRITE_PRESSURE", "SIGNAL_TYPE_HIGH_READ_PRESSURE", "SIGNAL_TYPE_ENCRYPTION_ORG_POLICY_NOT_SATISFIED", -"SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED" +"SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED", +"SIGNAL_TYPE_OUTDATED_MINOR_VERSION", +"SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED", +"SIGNAL_TYPE_MANY_IDLE_CONNECTIONS", +"SIGNAL_TYPE_REPLICATION_LAG", +"SIGNAL_TYPE_OUTDATED_VERSION" ], "enumDeprecated": [ false, @@ -4478,6 +4576,11 @@ false, false, false, false, +false, +false, +false, +false, +false, false ], "enumDescriptions": [ @@ -4576,7 +4679,12 @@ false "Heavy write pressure on the database rows.", "Heavy read pressure on the database rows.", "Encryption org policy not satisfied.", -"Location org policy not satisfied." +"Location org policy not satisfied.", +"Outdated DB minor version.", +"Schema not optimized.", +"High number of idle connections.", +"Replication delay.", +"Outdated version." ], "type": "string" }, @@ -4640,7 +4748,7 @@ false "type": "object" }, "StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata": { -"description": "Common model for database resource instance metadata. Next ID: 25", +"description": "Common model for database resource instance metadata. Next ID: 26", "id": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata", "properties": { "availabilityConfiguration": { @@ -4655,6 +4763,10 @@ false "$ref": "StorageDatabasecenterPartnerapiV1mainBackupRun", "description": "Latest backup run information for this instance" }, +"backupdrConfiguration": { +"$ref": "StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration", +"description": "Optional. BackupDR Configuration for the resource." +}, "creationTime": { "description": "The creation time of the resource, i.e. the time when resource is created and recorded in partner service.", "format": "google-datetime", @@ -4727,6 +4839,7 @@ false }, "gcbdrConfiguration": { "$ref": "StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration", +"deprecated": true, "description": "GCBDR configuration for the resource." }, "id": { @@ -4993,7 +5106,12 @@ false "SIGNAL_TYPE_HIGH_WRITE_PRESSURE", "SIGNAL_TYPE_HIGH_READ_PRESSURE", "SIGNAL_TYPE_ENCRYPTION_ORG_POLICY_NOT_SATISFIED", -"SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED" +"SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED", +"SIGNAL_TYPE_OUTDATED_MINOR_VERSION", +"SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED", +"SIGNAL_TYPE_MANY_IDLE_CONNECTIONS", +"SIGNAL_TYPE_REPLICATION_LAG", +"SIGNAL_TYPE_OUTDATED_VERSION" ], "enumDeprecated": [ false, @@ -5091,6 +5209,11 @@ false, false, false, false, +false, +false, +false, +false, +false, false ], "enumDescriptions": [ @@ -5189,7 +5312,12 @@ false "Heavy write pressure on the database rows.", "Heavy read pressure on the database rows.", "Encryption org policy not satisfied.", -"Location org policy not satisfied." +"Location org policy not satisfied.", +"Outdated DB minor version.", +"Schema not optimized.", +"High number of idle connections.", +"Replication delay.", +"Outdated version." ], "type": "string" } @@ -5500,6 +5628,7 @@ false "ENGINE_OTHER", "ENGINE_FIRESTORE_WITH_NATIVE_MODE", "ENGINE_FIRESTORE_WITH_DATASTORE_MODE", +"ENGINE_FIRESTORE_WITH_MONGODB_COMPATIBILITY_MODE", "ENGINE_EXADATA_ORACLE", "ENGINE_ADB_SERVERLESS_ORACLE" ], @@ -5521,6 +5650,7 @@ false, false, false, false, +false, false ], "enumDescriptions": [ @@ -5540,11 +5670,16 @@ false "Other refers to rest of other database engine. This is to be when engine is known, but it is not present in this enum.", "Firestore with native mode.", "Firestore with datastore mode.", +"Firestore with MongoDB compatibility mode.", "Oracle Exadata engine.", "Oracle Autonomous DB Serverless engine." ], "type": "string" }, +"minorVersion": { +"description": "Minor version of the underlying database engine. Example values: For MySQL, it could be \"8.0.32\", \"5.7.32\" etc.. For Postgres, it could be \"14.3\", \"15.3\" etc..", +"type": "string" +}, "type": { "description": "Type of specific database product. It could be CloudSQL, AlloyDB etc..", "enum": [ diff --git a/googleapiclient/discovery_cache/documents/alloydb.v1alpha.json b/googleapiclient/discovery_cache/documents/alloydb.v1alpha.json index a80b8edd74d..ab8f5b15579 100644 --- a/googleapiclient/discovery_cache/documents/alloydb.v1alpha.json +++ b/googleapiclient/discovery_cache/documents/alloydb.v1alpha.json @@ -1622,7 +1622,7 @@ } } }, -"revision": "20250612", +"revision": "20250723", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -4065,6 +4065,33 @@ false }, "type": "object" }, +"StageSchedule": { +"description": "Timing information for the stage execution.", +"id": "StageSchedule", +"properties": { +"actualEndTime": { +"description": "Actual end time of the stage. Set only if the stage has completed.", +"format": "google-datetime", +"type": "string" +}, +"actualStartTime": { +"description": "Actual start time of the stage. Set only if the stage has started.", +"format": "google-datetime", +"type": "string" +}, +"estimatedEndTime": { +"description": "When the stage is expected to end. Set only if the stage has not completed yet.", +"format": "google-datetime", +"type": "string" +}, +"estimatedStartTime": { +"description": "When the stage is expected to start. Set only if the stage has not started yet.", +"format": "google-datetime", +"type": "string" +} +}, +"type": "object" +}, "StageStatus": { "description": "Status of an upgrade stage.", "id": "StageStatus", @@ -4073,6 +4100,11 @@ false "$ref": "ReadPoolInstancesUpgradeStageStatus", "description": "Read pool instances upgrade metadata." }, +"schedule": { +"$ref": "StageSchedule", +"description": "Output only. Timing information for the stage execution.", +"readOnly": true +}, "stage": { "description": "Upgrade stage.", "enum": [ @@ -4236,6 +4268,17 @@ false }, "type": "object" }, +"StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration": { +"description": "BackupDRConfiguration to capture the backup and disaster recovery details of database resource.", +"id": "StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration", +"properties": { +"backupdrManaged": { +"description": "Indicates if the resource is managed by BackupDR.", +"type": "boolean" +} +}, +"type": "object" +}, "StorageDatabasecenterPartnerapiV1mainBackupRun": { "description": "A backup run.", "id": "StorageDatabasecenterPartnerapiV1mainBackupRun", @@ -4286,6 +4329,50 @@ false }, "type": "object" }, +"StorageDatabasecenterPartnerapiV1mainConfigBasedSignalData": { +"description": "Config based signal data. This is used to send signals to Condor which are based on the DB level configurations. These will be used to send signals for self managed databases.", +"id": "StorageDatabasecenterPartnerapiV1mainConfigBasedSignalData", +"properties": { +"fullResourceName": { +"description": "Required. Full Resource name of the source resource.", +"type": "string" +}, +"lastRefreshTime": { +"description": "Required. Last time signal was refreshed", +"format": "google-datetime", +"type": "string" +}, +"resourceId": { +"$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceId", +"description": "Database resource id." +}, +"signalBoolValue": { +"description": "Signal data for boolean signals.", +"type": "boolean" +}, +"signalType": { +"description": "Required. Signal type of the signal", +"enum": [ +"SIGNAL_TYPE_UNSPECIFIED", +"SIGNAL_TYPE_OUTDATED_MINOR_VERSION", +"SIGNAL_TYPE_DATABASE_AUDITING_DISABLED", +"SIGNAL_TYPE_NO_ROOT_PASSWORD", +"SIGNAL_TYPE_EXPOSED_TO_PUBLIC_ACCESS", +"SIGNAL_TYPE_UNENCRYPTED_CONNECTIONS" +], +"enumDescriptions": [ +"Unspecified signal type.", +"Outdated Minor Version", +"Represents database auditing is disabled.", +"Represents if a database has a password configured for the root account or not.", +"Represents if a resource is exposed to public access.", +"Represents if a resources requires all incoming connections to use SSL or not." +], +"type": "string" +} +}, +"type": "object" +}, "StorageDatabasecenterPartnerapiV1mainCustomMetadataData": { "description": "Any custom metadata associated with the resource. e.g. A spanner instance can have multiple databases with its own unique metadata. Information for these individual databases can be captured in custom metadata data", "id": "StorageDatabasecenterPartnerapiV1mainCustomMetadataData", @@ -4301,9 +4388,13 @@ false "type": "object" }, "StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed": { -"description": "DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform. Next ID: 8", +"description": "DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform. Next ID: 9", "id": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed", "properties": { +"configBasedSignalData": { +"$ref": "StorageDatabasecenterPartnerapiV1mainConfigBasedSignalData", +"description": "Config based signal data is used to ingest signals that are generated based on the configuration of the database resource." +}, "feedTimestamp": { "description": "Required. Timestamp when feed is generated.", "format": "google-datetime", @@ -4316,14 +4407,16 @@ false "RESOURCE_METADATA", "OBSERVABILITY_DATA", "SECURITY_FINDING_DATA", -"RECOMMENDATION_SIGNAL_DATA" +"RECOMMENDATION_SIGNAL_DATA", +"CONFIG_BASED_SIGNAL_DATA" ], "enumDescriptions": [ "", "Database resource metadata feed from control plane", "Database resource monitoring data", "Database resource security health signal data", -"Database resource recommendation signal data" +"Database resource recommendation signal data", +"Database config based signal data" ], "type": "string" }, @@ -4557,7 +4650,12 @@ false "SIGNAL_TYPE_HIGH_WRITE_PRESSURE", "SIGNAL_TYPE_HIGH_READ_PRESSURE", "SIGNAL_TYPE_ENCRYPTION_ORG_POLICY_NOT_SATISFIED", -"SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED" +"SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED", +"SIGNAL_TYPE_OUTDATED_MINOR_VERSION", +"SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED", +"SIGNAL_TYPE_MANY_IDLE_CONNECTIONS", +"SIGNAL_TYPE_REPLICATION_LAG", +"SIGNAL_TYPE_OUTDATED_VERSION" ], "enumDeprecated": [ false, @@ -4655,6 +4753,11 @@ false, false, false, false, +false, +false, +false, +false, +false, false ], "enumDescriptions": [ @@ -4753,7 +4856,12 @@ false "Heavy write pressure on the database rows.", "Heavy read pressure on the database rows.", "Encryption org policy not satisfied.", -"Location org policy not satisfied." +"Location org policy not satisfied.", +"Outdated DB minor version.", +"Schema not optimized.", +"High number of idle connections.", +"Replication delay.", +"Outdated version." ], "type": "string" }, @@ -4817,7 +4925,7 @@ false "type": "object" }, "StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata": { -"description": "Common model for database resource instance metadata. Next ID: 25", +"description": "Common model for database resource instance metadata. Next ID: 26", "id": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata", "properties": { "availabilityConfiguration": { @@ -4832,6 +4940,10 @@ false "$ref": "StorageDatabasecenterPartnerapiV1mainBackupRun", "description": "Latest backup run information for this instance" }, +"backupdrConfiguration": { +"$ref": "StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration", +"description": "Optional. BackupDR Configuration for the resource." +}, "creationTime": { "description": "The creation time of the resource, i.e. the time when resource is created and recorded in partner service.", "format": "google-datetime", @@ -4904,6 +5016,7 @@ false }, "gcbdrConfiguration": { "$ref": "StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration", +"deprecated": true, "description": "GCBDR configuration for the resource." }, "id": { @@ -5170,7 +5283,12 @@ false "SIGNAL_TYPE_HIGH_WRITE_PRESSURE", "SIGNAL_TYPE_HIGH_READ_PRESSURE", "SIGNAL_TYPE_ENCRYPTION_ORG_POLICY_NOT_SATISFIED", -"SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED" +"SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED", +"SIGNAL_TYPE_OUTDATED_MINOR_VERSION", +"SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED", +"SIGNAL_TYPE_MANY_IDLE_CONNECTIONS", +"SIGNAL_TYPE_REPLICATION_LAG", +"SIGNAL_TYPE_OUTDATED_VERSION" ], "enumDeprecated": [ false, @@ -5268,6 +5386,11 @@ false, false, false, false, +false, +false, +false, +false, +false, false ], "enumDescriptions": [ @@ -5366,7 +5489,12 @@ false "Heavy write pressure on the database rows.", "Heavy read pressure on the database rows.", "Encryption org policy not satisfied.", -"Location org policy not satisfied." +"Location org policy not satisfied.", +"Outdated DB minor version.", +"Schema not optimized.", +"High number of idle connections.", +"Replication delay.", +"Outdated version." ], "type": "string" } @@ -5677,6 +5805,7 @@ false "ENGINE_OTHER", "ENGINE_FIRESTORE_WITH_NATIVE_MODE", "ENGINE_FIRESTORE_WITH_DATASTORE_MODE", +"ENGINE_FIRESTORE_WITH_MONGODB_COMPATIBILITY_MODE", "ENGINE_EXADATA_ORACLE", "ENGINE_ADB_SERVERLESS_ORACLE" ], @@ -5698,6 +5827,7 @@ false, false, false, false, +false, false ], "enumDescriptions": [ @@ -5717,11 +5847,16 @@ false "Other refers to rest of other database engine. This is to be when engine is known, but it is not present in this enum.", "Firestore with native mode.", "Firestore with datastore mode.", +"Firestore with MongoDB compatibility mode.", "Oracle Exadata engine.", "Oracle Autonomous DB Serverless engine." ], "type": "string" }, +"minorVersion": { +"description": "Minor version of the underlying database engine. Example values: For MySQL, it could be \"8.0.32\", \"5.7.32\" etc.. For Postgres, it could be \"14.3\", \"15.3\" etc..", +"type": "string" +}, "type": { "description": "Type of specific database product. It could be CloudSQL, AlloyDB etc..", "enum": [ diff --git a/googleapiclient/discovery_cache/documents/alloydb.v1beta.json b/googleapiclient/discovery_cache/documents/alloydb.v1beta.json index 9aff2c4de3e..1b01da82dfe 100644 --- a/googleapiclient/discovery_cache/documents/alloydb.v1beta.json +++ b/googleapiclient/discovery_cache/documents/alloydb.v1beta.json @@ -1619,7 +1619,7 @@ } } }, -"revision": "20250612", +"revision": "20250723", "rootUrl": "https://alloydb.googleapis.com/", "schemas": { "AuthorizedNetwork": { @@ -4041,6 +4041,33 @@ false }, "type": "object" }, +"StageSchedule": { +"description": "Timing information for the stage execution.", +"id": "StageSchedule", +"properties": { +"actualEndTime": { +"description": "Actual end time of the stage. Set only if the stage has completed.", +"format": "google-datetime", +"type": "string" +}, +"actualStartTime": { +"description": "Actual start time of the stage. Set only if the stage has started.", +"format": "google-datetime", +"type": "string" +}, +"estimatedEndTime": { +"description": "When the stage is expected to end. Set only if the stage has not completed yet.", +"format": "google-datetime", +"type": "string" +}, +"estimatedStartTime": { +"description": "When the stage is expected to start. Set only if the stage has not started yet.", +"format": "google-datetime", +"type": "string" +} +}, +"type": "object" +}, "StageStatus": { "description": "Status of an upgrade stage.", "id": "StageStatus", @@ -4049,6 +4076,11 @@ false "$ref": "ReadPoolInstancesUpgradeStageStatus", "description": "Read pool instances upgrade metadata." }, +"schedule": { +"$ref": "StageSchedule", +"description": "Output only. Timing information for the stage execution.", +"readOnly": true +}, "stage": { "description": "Upgrade stage.", "enum": [ @@ -4212,6 +4244,17 @@ false }, "type": "object" }, +"StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration": { +"description": "BackupDRConfiguration to capture the backup and disaster recovery details of database resource.", +"id": "StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration", +"properties": { +"backupdrManaged": { +"description": "Indicates if the resource is managed by BackupDR.", +"type": "boolean" +} +}, +"type": "object" +}, "StorageDatabasecenterPartnerapiV1mainBackupRun": { "description": "A backup run.", "id": "StorageDatabasecenterPartnerapiV1mainBackupRun", @@ -4262,6 +4305,50 @@ false }, "type": "object" }, +"StorageDatabasecenterPartnerapiV1mainConfigBasedSignalData": { +"description": "Config based signal data. This is used to send signals to Condor which are based on the DB level configurations. These will be used to send signals for self managed databases.", +"id": "StorageDatabasecenterPartnerapiV1mainConfigBasedSignalData", +"properties": { +"fullResourceName": { +"description": "Required. Full Resource name of the source resource.", +"type": "string" +}, +"lastRefreshTime": { +"description": "Required. Last time signal was refreshed", +"format": "google-datetime", +"type": "string" +}, +"resourceId": { +"$ref": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceId", +"description": "Database resource id." +}, +"signalBoolValue": { +"description": "Signal data for boolean signals.", +"type": "boolean" +}, +"signalType": { +"description": "Required. Signal type of the signal", +"enum": [ +"SIGNAL_TYPE_UNSPECIFIED", +"SIGNAL_TYPE_OUTDATED_MINOR_VERSION", +"SIGNAL_TYPE_DATABASE_AUDITING_DISABLED", +"SIGNAL_TYPE_NO_ROOT_PASSWORD", +"SIGNAL_TYPE_EXPOSED_TO_PUBLIC_ACCESS", +"SIGNAL_TYPE_UNENCRYPTED_CONNECTIONS" +], +"enumDescriptions": [ +"Unspecified signal type.", +"Outdated Minor Version", +"Represents database auditing is disabled.", +"Represents if a database has a password configured for the root account or not.", +"Represents if a resource is exposed to public access.", +"Represents if a resources requires all incoming connections to use SSL or not." +], +"type": "string" +} +}, +"type": "object" +}, "StorageDatabasecenterPartnerapiV1mainCustomMetadataData": { "description": "Any custom metadata associated with the resource. e.g. A spanner instance can have multiple databases with its own unique metadata. Information for these individual databases can be captured in custom metadata data", "id": "StorageDatabasecenterPartnerapiV1mainCustomMetadataData", @@ -4277,9 +4364,13 @@ false "type": "object" }, "StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed": { -"description": "DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform. Next ID: 8", +"description": "DatabaseResourceFeed is the top level proto to be used to ingest different database resource level events into Condor platform. Next ID: 9", "id": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceFeed", "properties": { +"configBasedSignalData": { +"$ref": "StorageDatabasecenterPartnerapiV1mainConfigBasedSignalData", +"description": "Config based signal data is used to ingest signals that are generated based on the configuration of the database resource." +}, "feedTimestamp": { "description": "Required. Timestamp when feed is generated.", "format": "google-datetime", @@ -4292,14 +4383,16 @@ false "RESOURCE_METADATA", "OBSERVABILITY_DATA", "SECURITY_FINDING_DATA", -"RECOMMENDATION_SIGNAL_DATA" +"RECOMMENDATION_SIGNAL_DATA", +"CONFIG_BASED_SIGNAL_DATA" ], "enumDescriptions": [ "", "Database resource metadata feed from control plane", "Database resource monitoring data", "Database resource security health signal data", -"Database resource recommendation signal data" +"Database resource recommendation signal data", +"Database config based signal data" ], "type": "string" }, @@ -4533,7 +4626,12 @@ false "SIGNAL_TYPE_HIGH_WRITE_PRESSURE", "SIGNAL_TYPE_HIGH_READ_PRESSURE", "SIGNAL_TYPE_ENCRYPTION_ORG_POLICY_NOT_SATISFIED", -"SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED" +"SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED", +"SIGNAL_TYPE_OUTDATED_MINOR_VERSION", +"SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED", +"SIGNAL_TYPE_MANY_IDLE_CONNECTIONS", +"SIGNAL_TYPE_REPLICATION_LAG", +"SIGNAL_TYPE_OUTDATED_VERSION" ], "enumDeprecated": [ false, @@ -4631,6 +4729,11 @@ false, false, false, false, +false, +false, +false, +false, +false, false ], "enumDescriptions": [ @@ -4729,7 +4832,12 @@ false "Heavy write pressure on the database rows.", "Heavy read pressure on the database rows.", "Encryption org policy not satisfied.", -"Location org policy not satisfied." +"Location org policy not satisfied.", +"Outdated DB minor version.", +"Schema not optimized.", +"High number of idle connections.", +"Replication delay.", +"Outdated version." ], "type": "string" }, @@ -4793,7 +4901,7 @@ false "type": "object" }, "StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata": { -"description": "Common model for database resource instance metadata. Next ID: 25", +"description": "Common model for database resource instance metadata. Next ID: 26", "id": "StorageDatabasecenterPartnerapiV1mainDatabaseResourceMetadata", "properties": { "availabilityConfiguration": { @@ -4808,6 +4916,10 @@ false "$ref": "StorageDatabasecenterPartnerapiV1mainBackupRun", "description": "Latest backup run information for this instance" }, +"backupdrConfiguration": { +"$ref": "StorageDatabasecenterPartnerapiV1mainBackupDRConfiguration", +"description": "Optional. BackupDR Configuration for the resource." +}, "creationTime": { "description": "The creation time of the resource, i.e. the time when resource is created and recorded in partner service.", "format": "google-datetime", @@ -4880,6 +4992,7 @@ false }, "gcbdrConfiguration": { "$ref": "StorageDatabasecenterPartnerapiV1mainGCBDRConfiguration", +"deprecated": true, "description": "GCBDR configuration for the resource." }, "id": { @@ -5146,7 +5259,12 @@ false "SIGNAL_TYPE_HIGH_WRITE_PRESSURE", "SIGNAL_TYPE_HIGH_READ_PRESSURE", "SIGNAL_TYPE_ENCRYPTION_ORG_POLICY_NOT_SATISFIED", -"SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED" +"SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED", +"SIGNAL_TYPE_OUTDATED_MINOR_VERSION", +"SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED", +"SIGNAL_TYPE_MANY_IDLE_CONNECTIONS", +"SIGNAL_TYPE_REPLICATION_LAG", +"SIGNAL_TYPE_OUTDATED_VERSION" ], "enumDeprecated": [ false, @@ -5244,6 +5362,11 @@ false, false, false, false, +false, +false, +false, +false, +false, false ], "enumDescriptions": [ @@ -5342,7 +5465,12 @@ false "Heavy write pressure on the database rows.", "Heavy read pressure on the database rows.", "Encryption org policy not satisfied.", -"Location org policy not satisfied." +"Location org policy not satisfied.", +"Outdated DB minor version.", +"Schema not optimized.", +"High number of idle connections.", +"Replication delay.", +"Outdated version." ], "type": "string" } @@ -5653,6 +5781,7 @@ false "ENGINE_OTHER", "ENGINE_FIRESTORE_WITH_NATIVE_MODE", "ENGINE_FIRESTORE_WITH_DATASTORE_MODE", +"ENGINE_FIRESTORE_WITH_MONGODB_COMPATIBILITY_MODE", "ENGINE_EXADATA_ORACLE", "ENGINE_ADB_SERVERLESS_ORACLE" ], @@ -5674,6 +5803,7 @@ false, false, false, false, +false, false ], "enumDescriptions": [ @@ -5693,11 +5823,16 @@ false "Other refers to rest of other database engine. This is to be when engine is known, but it is not present in this enum.", "Firestore with native mode.", "Firestore with datastore mode.", +"Firestore with MongoDB compatibility mode.", "Oracle Exadata engine.", "Oracle Autonomous DB Serverless engine." ], "type": "string" }, +"minorVersion": { +"description": "Minor version of the underlying database engine. Example values: For MySQL, it could be \"8.0.32\", \"5.7.32\" etc.. For Postgres, it could be \"14.3\", \"15.3\" etc..", +"type": "string" +}, "type": { "description": "Type of specific database product. It could be CloudSQL, AlloyDB etc..", "enum": [ From 663eed695a396138040f50d709ddba9bac242707 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 29 Jul 2025 07:12:11 +0000 Subject: [PATCH 03/36] feat(analyticsadmin): update the api #### analyticsadmin:v1alpha The following keys were added: - resources.properties.methods.submitUserDeletion (Total Keys: 12) - schemas.GoogleAnalyticsAdminV1alphaSubmitUserDeletionRequest (Total Keys: 6) - schemas.GoogleAnalyticsAdminV1alphaSubmitUserDeletionResponse (Total Keys: 4) --- .../analyticsadmin_v1alpha.properties.html | 32 +++++++++ .../documents/analyticsadmin.v1alpha.json | 65 ++++++++++++++++++- 2 files changed, 96 insertions(+), 1 deletion(-) diff --git a/docs/dyn/analyticsadmin_v1alpha.properties.html b/docs/dyn/analyticsadmin_v1alpha.properties.html index 4f41509a8ea..f95b60cdf5d 100644 --- a/docs/dyn/analyticsadmin_v1alpha.properties.html +++ b/docs/dyn/analyticsadmin_v1alpha.properties.html @@ -224,6 +224,9 @@

Instance Methods

runAccessReport(entity, body=None, x__xgafv=None)

Returns a customized report of data access records. The report provides records of each time a user reads Google Analytics reporting data. Access records are retained for up to 2 years. Data Access Reports can be requested for a property. Reports may be requested for any property, but dimensions that aren't related to quota can only be requested on Google Analytics 360 properties. This method is only available to Administrators. These data access records include GA UI Reporting, GA UI Explorations, GA Data API, and other products like Firebase & Admob that can retrieve data from Google Analytics through a linkage. These records don't include property configuration changes like adding a stream or changing a property's time zone. For configuration change history, see [searchChangeHistoryEvents](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1alpha/accounts/searchChangeHistoryEvents). To give your feedback on this API, complete the [Google Analytics Access Reports feedback](https://docs.google.com/forms/d/e/1FAIpQLSdmEBUrMzAEdiEKk5TV5dEHvDUZDRlgWYdQdAeSdtR4hVjEhw/viewform) form.

+

+ submitUserDeletion(name, body=None, x__xgafv=None)

+

Submits a request for user deletion for a property.

updateAttributionSettings(name, body=None, updateMask=None, x__xgafv=None)

Updates attribution settings on a property.

@@ -926,6 +929,35 @@

Method Details

}
+
+ submitUserDeletion(name, body=None, x__xgafv=None) + 
Submits a request for user deletion for a property.
+
+Args:
+  name: string, Required. The name of the property to submit user deletion for. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for SubmitUserDeletion RPC.
+  "appInstanceId": "A String", # Firebase [application instance ID](https://firebase.google.com/docs/reference/android/com/google/firebase/analytics/FirebaseAnalytics.html#getAppInstanceId).
+  "clientId": "A String", # Google Analytics [client ID](https://support.google.com/analytics/answer/11593727).
+  "userId": "A String", # Google Analytics [user ID](https://firebase.google.com/docs/analytics/userid).
+  "userProvidedData": "A String", # [User-provided data](https://support.google.com/analytics/answer/14077171). May contain either one email address or one phone number. Email addresses should be normalized as such: * lowercase * remove periods before @ for gmail.com/googlemail.com addresses * remove all spaces Phone numbers should be normalized as such: * remove all non digit characters * add + prefix
+}
+
+  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 SubmitUserDeletion RPC.
+  "deletionRequestTime": "A String", # Marks the moment for which all visitor data before this point should be deleted. This is set to the time at which the deletion request was received.
+}
+
+
updateAttributionSettings(name, body=None, updateMask=None, x__xgafv=None) 
Updates attribution settings on a property.
diff --git a/googleapiclient/discovery_cache/documents/analyticsadmin.v1alpha.json b/googleapiclient/discovery_cache/documents/analyticsadmin.v1alpha.json
index 4cb8f1a0d81..83141a4231b 100644
--- a/googleapiclient/discovery_cache/documents/analyticsadmin.v1alpha.json
+++ b/googleapiclient/discovery_cache/documents/analyticsadmin.v1alpha.json
@@ -975,6 +975,34 @@
 "https://www.googleapis.com/auth/analytics.readonly"
 ]
 },
+"submitUserDeletion": {
+"description": "Submits a request for user deletion for a property.",
+"flatPath": "v1alpha/properties/{propertiesId}:submitUserDeletion",
+"httpMethod": "POST",
+"id": "analyticsadmin.properties.submitUserDeletion",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the property to submit user deletion for.",
+"location": "path",
+"pattern": "^properties/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+name}:submitUserDeletion",
+"request": {
+"$ref": "GoogleAnalyticsAdminV1alphaSubmitUserDeletionRequest"
+},
+"response": {
+"$ref": "GoogleAnalyticsAdminV1alphaSubmitUserDeletionResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/analytics.edit"
+]
+},
 "updateAttributionSettings": {
 "description": "Updates attribution settings on a property.",
 "flatPath": "v1alpha/properties/{propertiesId}/attributionSettings",
@@ -5058,7 +5086,7 @@
 }
 }
 },
-"revision": "20250713",
+"revision": "20250723",
 "rootUrl": "https://analyticsadmin.googleapis.com/",
 "schemas": {
 "GoogleAnalyticsAdminV1alphaAccessBetweenFilter": {
@@ -9127,6 +9155,41 @@
 },
 "type": "object"
 },
+"GoogleAnalyticsAdminV1alphaSubmitUserDeletionRequest": {
+"description": "Request message for SubmitUserDeletion RPC.",
+"id": "GoogleAnalyticsAdminV1alphaSubmitUserDeletionRequest",
+"properties": {
+"appInstanceId": {
+"description": "Firebase [application instance ID](https://firebase.google.com/docs/reference/android/com/google/firebase/analytics/FirebaseAnalytics.html#getAppInstanceId).",
+"type": "string"
+},
+"clientId": {
+"description": "Google Analytics [client ID](https://support.google.com/analytics/answer/11593727).",
+"type": "string"
+},
+"userId": {
+"description": "Google Analytics [user ID](https://firebase.google.com/docs/analytics/userid).",
+"type": "string"
+},
+"userProvidedData": {
+"description": "[User-provided data](https://support.google.com/analytics/answer/14077171). May contain either one email address or one phone number. Email addresses should be normalized as such: * lowercase * remove periods before @ for gmail.com/googlemail.com addresses * remove all spaces Phone numbers should be normalized as such: * remove all non digit characters * add + prefix",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleAnalyticsAdminV1alphaSubmitUserDeletionResponse": {
+"description": "Response message for SubmitUserDeletion RPC.",
+"id": "GoogleAnalyticsAdminV1alphaSubmitUserDeletionResponse",
+"properties": {
+"deletionRequestTime": {
+"description": "Marks the moment for which all visitor data before this point should be deleted. This is set to the time at which the deletion request was received.",
+"format": "google-datetime",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleAnalyticsAdminV1alphaSubpropertyEventFilter": {
 "description": "A resource message representing a Google Analytics subproperty event filter.",
 "id": "GoogleAnalyticsAdminV1alphaSubpropertyEventFilter",

From 2bc9b279b28937cf85d62a2cd25e5814361fb661 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:11 +0000
Subject: [PATCH 04/36] feat(androidenterprise): update the api

#### androidenterprise:v1

The following keys were added:
- schemas.EnrollmentToken.properties.googleAuthenticationOptions.$ref (Total Keys: 1)
- schemas.EnrollmentTokenGoogleAuthenticationOptions (Total Keys: 4)
---
 ...androidenterprise_v1.enrollmentTokens.html |  8 +++++
 .../documents/androidenterprise.v1.json       | 31 ++++++++++++++++++-
 2 files changed, 38 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/androidenterprise_v1.enrollmentTokens.html b/docs/dyn/androidenterprise_v1.enrollmentTokens.html
index 71d025fe8f2..08abd7037c0 100644
--- a/docs/dyn/androidenterprise_v1.enrollmentTokens.html
+++ b/docs/dyn/androidenterprise_v1.enrollmentTokens.html
@@ -98,6 +98,10 @@ 
Method Details

 { # A token used to enroll a device.
   "duration": "A String", # [Optional] The length of time the enrollment token is valid, ranging from 1 minute to [`Durations.MAX_VALUE`](https://developers.google.com/protocol-buffers/docs/reference/java/com/google/protobuf/util/Durations.html#MAX_VALUE), approximately 10,000 years. If not specified, the default duration is 1 hour.
   "enrollmentTokenType": "A String", # [Required] The type of the enrollment token.
+  "googleAuthenticationOptions": { # Options for Google authentication during the enrollment. # [Optional] Provides options related to Google authentication during the enrollment.
+    "authenticationRequirement": "A String", # [Optional] Specifies whether user should authenticate with Google during enrollment. This setting, if specified,`GoogleAuthenticationSettings` specified for the enterprise resource is ignored for devices enrolled with this token.
+    "requiredAccountEmail": "A String", # [Optional] Specifies the managed Google account that the user must use during enrollment.`AuthenticationRequirement` must be set to`REQUIRED` if this field is set.
+  },
   "token": "A String", # The token value that's passed to the device and authorizes the device to enroll. This is a read-only field generated by the server.
 }
 
@@ -112,6 +116,10 @@ 
Method Details

     { # A token used to enroll a device.
   "duration": "A String", # [Optional] The length of time the enrollment token is valid, ranging from 1 minute to [`Durations.MAX_VALUE`](https://developers.google.com/protocol-buffers/docs/reference/java/com/google/protobuf/util/Durations.html#MAX_VALUE), approximately 10,000 years. If not specified, the default duration is 1 hour.
   "enrollmentTokenType": "A String", # [Required] The type of the enrollment token.
+  "googleAuthenticationOptions": { # Options for Google authentication during the enrollment. # [Optional] Provides options related to Google authentication during the enrollment.
+    "authenticationRequirement": "A String", # [Optional] Specifies whether user should authenticate with Google during enrollment. This setting, if specified,`GoogleAuthenticationSettings` specified for the enterprise resource is ignored for devices enrolled with this token.
+    "requiredAccountEmail": "A String", # [Optional] Specifies the managed Google account that the user must use during enrollment.`AuthenticationRequirement` must be set to`REQUIRED` if this field is set.
+  },
   "token": "A String", # The token value that's passed to the device and authorizes the device to enroll. This is a read-only field generated by the server.
 }
diff --git a/googleapiclient/discovery_cache/documents/androidenterprise.v1.json b/googleapiclient/discovery_cache/documents/androidenterprise.v1.json index 1404f6767f3..a76299db081 100644 --- a/googleapiclient/discovery_cache/documents/androidenterprise.v1.json +++ b/googleapiclient/discovery_cache/documents/androidenterprise.v1.json @@ -2691,7 +2691,7 @@ } } }, -"revision": "20250610", +"revision": "20250720", "rootUrl": "https://androidenterprise.googleapis.com/", "schemas": { "Administrator": { @@ -3342,6 +3342,10 @@ ], "type": "string" }, +"googleAuthenticationOptions": { +"$ref": "EnrollmentTokenGoogleAuthenticationOptions", +"description": "[Optional] Provides options related to Google authentication during the enrollment." +}, "token": { "description": "The token value that's passed to the device and authorizes the device to enroll. This is a read-only field generated by the server.", "type": "string" @@ -3349,6 +3353,31 @@ }, "type": "object" }, +"EnrollmentTokenGoogleAuthenticationOptions": { +"description": "Options for Google authentication during the enrollment.", +"id": "EnrollmentTokenGoogleAuthenticationOptions", +"properties": { +"authenticationRequirement": { +"description": "[Optional] Specifies whether user should authenticate with Google during enrollment. This setting, if specified,`GoogleAuthenticationSettings` specified for the enterprise resource is ignored for devices enrolled with this token.", +"enum": [ +"authenticationRequirementUnspecified", +"optional", +"required" +], +"enumDescriptions": [ +"The value is unused.", +"Google authentication is optional for the user. This means the user can choose to skip Google authentication during enrollment.", +"Google authentication is required for the user. This means the user must authenticate with a Google account to proceed." +], +"type": "string" +}, +"requiredAccountEmail": { +"description": "[Optional] Specifies the managed Google account that the user must use during enrollment.`AuthenticationRequirement` must be set to`REQUIRED` if this field is set.", +"type": "string" +} +}, +"type": "object" +}, "Enterprise": { "description": "An Enterprises resource represents the binding between an EMM and a specific organization. That binding can be instantiated in one of two different ways using this API as follows: - For Google managed domain customers, the process involves using Enterprises.enroll and Enterprises.setAccount (in conjunction with artifacts obtained from the Admin console and the Google API Console) and submitted to the EMM through a more-or-less manual process. - For managed Google Play Accounts customers, the process involves using Enterprises.generateSignupUrl and Enterprises.completeSignup in conjunction with the managed Google Play sign-up UI (Google-provided mechanism) to create the binding without manual steps. As an EMM, you can support either or both approaches in your EMM console. See Create an Enterprise for details.", "id": "Enterprise", From 45e3c01443176fbef0d4647d7cae88d7789b469e Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 29 Jul 2025 07:12:11 +0000 Subject: [PATCH 05/36] feat(androidpublisher): update the api #### androidpublisher:v3 The following keys were added: - resources.monetization.resources.onetimeproducts.methods.batchDelete (Total Keys: 10) - resources.monetization.resources.onetimeproducts.methods.batchGet (Total Keys: 13) - resources.monetization.resources.onetimeproducts.methods.batchUpdate (Total Keys: 11) - resources.monetization.resources.onetimeproducts.methods.delete (Total Keys: 14) - resources.monetization.resources.onetimeproducts.methods.get (Total Keys: 13) - resources.monetization.resources.onetimeproducts.methods.list (Total Keys: 15) - resources.monetization.resources.onetimeproducts.methods.patch (Total Keys: 23) - resources.monetization.resources.onetimeproducts.resources.purchaseOptions.methods.batchDelete (Total Keys: 13) - resources.monetization.resources.onetimeproducts.resources.purchaseOptions.methods.batchUpdateStates (Total Keys: 14) - resources.monetization.resources.onetimeproducts.resources.purchaseOptions.resources.offers.methods.activate (Total Keys: 20) - resources.monetization.resources.onetimeproducts.resources.purchaseOptions.resources.offers.methods.batchDelete (Total Keys: 16) - resources.monetization.resources.onetimeproducts.resources.purchaseOptions.resources.offers.methods.batchGet (Total Keys: 17) - resources.monetization.resources.onetimeproducts.resources.purchaseOptions.resources.offers.methods.batchUpdate (Total Keys: 34) - resources.monetization.resources.onetimeproducts.resources.purchaseOptions.resources.offers.methods.cancel (Total Keys: 20) - resources.monetization.resources.onetimeproducts.resources.purchaseOptions.resources.offers.methods.deactivate (Total Keys: 20) - resources.monetization.resources.onetimeproducts.resources.purchaseOptions.resources.offers.methods.list (Total Keys: 21) - schemas.ActivateOneTimeProductOfferRequest (Total Keys: 7) - schemas.ActivatePurchaseOptionRequest (Total Keys: 6) - schemas.BatchDeleteOneTimeProductOffersRequest (Total Keys: 4) - schemas.BatchDeleteOneTimeProductsRequest (Total Keys: 4) - schemas.BatchDeletePurchaseOptionsRequest (Total Keys: 4) - schemas.BatchGetOneTimeProductOffersRequest (Total Keys: 4) - schemas.BatchGetOneTimeProductOffersResponse (Total Keys: 4) - schemas.BatchGetOneTimeProductsResponse (Total Keys: 4) - schemas.BatchUpdateOneTimeProductOfferStatesRequest (Total Keys: 4) - schemas.BatchUpdateOneTimeProductOfferStatesResponse (Total Keys: 4) - schemas.BatchUpdateOneTimeProductOffersRequest (Total Keys: 4) - schemas.BatchUpdateOneTimeProductOffersResponse (Total Keys: 4) - schemas.BatchUpdateOneTimeProductsRequest (Total Keys: 4) - schemas.BatchUpdateOneTimeProductsResponse (Total Keys: 4) - schemas.BatchUpdatePurchaseOptionStatesRequest (Total Keys: 4) - schemas.BatchUpdatePurchaseOptionStatesResponse (Total Keys: 4) - schemas.CancelOneTimeProductOfferRequest (Total Keys: 7) - schemas.DeactivateOneTimeProductOfferRequest (Total Keys: 7) - schemas.DeactivatePurchaseOptionRequest (Total Keys: 6) - schemas.DeleteOneTimeProductOfferRequest (Total Keys: 7) - schemas.DeleteOneTimeProductRequest (Total Keys: 5) - schemas.DeletePurchaseOptionRequest (Total Keys: 7) - schemas.GetOneTimeProductOfferRequest (Total Keys: 6) - schemas.ListOneTimeProductOffersResponse (Total Keys: 5) - schemas.ListOneTimeProductsResponse (Total Keys: 5) - schemas.OneTimeProduct (Total Keys: 96) - schemas.PurchaseOptionTaxAndComplianceSettings (Total Keys: 3) - schemas.RegionalTaxConfig (Total Keys: 6) - schemas.UpdateOneTimeProductOfferRequest (Total Keys: 8) - schemas.UpdateOneTimeProductOfferStateRequest (Total Keys: 5) - schemas.UpdateOneTimeProductRequest (Total Keys: 8) - schemas.UpdatePurchaseOptionStateRequest (Total Keys: 4) --- .../dyn/androidpublisher_v3.monetization.html | 5 + ...isher_v3.monetization.onetimeproducts.html | 867 ++++++ ...ation.onetimeproducts.purchaseOptions.html | 250 ++ ...netimeproducts.purchaseOptions.offers.html | 719 +++++ .../documents/androidpublisher.v3.json | 2428 +++++++++++++++-- 5 files changed, 3966 insertions(+), 303 deletions(-) create mode 100644 docs/dyn/androidpublisher_v3.monetization.onetimeproducts.html create mode 100644 docs/dyn/androidpublisher_v3.monetization.onetimeproducts.purchaseOptions.html create mode 100644 docs/dyn/androidpublisher_v3.monetization.onetimeproducts.purchaseOptions.offers.html diff --git a/docs/dyn/androidpublisher_v3.monetization.html b/docs/dyn/androidpublisher_v3.monetization.html index af7589352ca..0f686455423 100644 --- a/docs/dyn/androidpublisher_v3.monetization.html +++ b/docs/dyn/androidpublisher_v3.monetization.html @@ -74,6 +74,11 @@

Google Play Android Developer API . monetization

Instance Methods

+

+ onetimeproducts() +

+

Returns the onetimeproducts Resource.

+

subscriptions()

diff --git a/docs/dyn/androidpublisher_v3.monetization.onetimeproducts.html b/docs/dyn/androidpublisher_v3.monetization.onetimeproducts.html new file mode 100644 index 00000000000..2b5e910430b --- /dev/null +++ b/docs/dyn/androidpublisher_v3.monetization.onetimeproducts.html @@ -0,0 +1,867 @@ + + + +

Google Play Android Developer API . monetization . onetimeproducts

+

Instance Methods

+

+ purchaseOptions() +

+

Returns the purchaseOptions Resource.

+ +

+ batchDelete(packageName, body=None, x__xgafv=None)

+

Deletes one or more one-time products.

+

+ batchGet(packageName, productIds=None, x__xgafv=None)

+

Reads one or more one-time products.

+

+ batchUpdate(packageName, body=None, x__xgafv=None)

+

Creates or updates one or more one-time products.

+

+ close()

+

Close httplib2 connections.

+

+ delete(packageName, productId, latencyTolerance=None, x__xgafv=None)

+

Deletes a one-time product.

+

+ get(packageName, productId, x__xgafv=None)

+

Reads a single one-time product.

+

+ list(packageName, pageSize=None, pageToken=None, x__xgafv=None)

+

Lists all one-time products under a given app.

+

+ list_next()

+

Retrieves the next page of results.

+

+ patch(packageName, productId, allowMissing=None, body=None, latencyTolerance=None, regionsVersion_version=None, updateMask=None, x__xgafv=None)

+

Creates or updates a one-time product.

+

Method Details

+
+ batchDelete(packageName, body=None, x__xgafv=None) + 
Deletes one or more one-time products.
+
+Args:
+  packageName: string, Required. The parent app (package name) for which the one-time products should be deleted. Must be equal to the package_name field on all the OneTimeProduct resources. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for BatchDeleteOneTimeProduct.
+  "requests": [ # Required. A list of delete requests of up to 100 elements. All requests must delete different one-time products.
+    { # Request message for deleting a one-time product.
+      "latencyTolerance": "A String", # Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.
+      "packageName": "A String", # Required. The parent app (package name) of the one-time product to delete.
+      "productId": "A String", # Required. The one-time product ID of the one-time product to delete.
+    },
+  ],
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+
+ +
+ batchGet(packageName, productIds=None, x__xgafv=None) + 
Reads one or more one-time products.
+
+Args:
+  packageName: string, Required. The parent app (package name) for which the products should be retrieved. Must be equal to the package_name field on all requests. (required)
+  productIds: string, Required. A list of up to 100 product IDs to retrieve. All IDs must be different. (repeated)
+  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 the BatchGetOneTimeProducts endpoint.
+  "oneTimeProducts": [ # The list of requested one-time products, in the same order as the request.
+    { # A single one-time product for an app.
+      "listings": [ # Required. Set of localized title and description data. Must not have duplicate entries with the same language_code.
+        { # Regional store listing for a one-time product.
+          "description": "A String", # Required. The description of this product in the language of this listing. The maximum length is 200 characters.
+          "languageCode": "A String", # Required. The language of this listing, as defined by BCP-47, e.g., "en-US".
+          "title": "A String", # Required. The title of this product in the language of this listing. The maximum length is 55 characters.
+        },
+      ],
+      "offerTags": [ # Optional. List of up to 20 custom tags specified for this one-time product, and returned to the app through the billing library. Purchase options and offers for this product will also receive these tags in the billing library.
+        { # Represents a custom tag specified for a product offer.
+          "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+        },
+      ],
+      "packageName": "A String", # Required. Immutable. Package name of the parent app.
+      "productId": "A String", # Required. Immutable. Unique product ID of the product. Unique within the parent app. Product IDs must start with a number or lowercase letter, and can contain numbers (0-9), lowercase letters (a-z), underscores (_), and periods (.).
+      "purchaseOptions": [ # Required. The set of purchase options for this one-time product.
+        { # A single purchase option for a one-time product.
+          "buyOption": { # A purchase option that can be bought. # A purchase option that can be bought.
+            "legacyCompatible": True or False, # Optional. Whether this purchase option will be available in legacy PBL flows that do not support one-time products model. Up to one "buy" purchase option can be marked as backwards compatible.
+            "multiQuantityEnabled": True or False, # Optional. Whether this purchase option allows multi-quantity. Multi-quantity allows buyer to purchase more than one item in a single checkout.
+          },
+          "newRegionsConfig": { # Pricing information for any new regions Play may launch in the future. # Pricing information for any new locations Play may launch in the future. If omitted, the purchase option will not be automatically available in any new locations Play may launch in the future.
+            "availability": "A String", # Required. The regional availability for the new regions config. When set to AVAILABLE, the pricing information will be used for any new regions Play may launch in the future.
+            "eurPrice": { # Represents an amount of money with its currency type. # Required. Price in EUR to use for any new regions Play may launch in.
+              "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+              "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+              "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+            },
+            "usdPrice": { # Represents an amount of money with its currency type. # Required. Price in USD to use for any new regions Play may launch in.
+              "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+              "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+              "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+            },
+          },
+          "offerTags": [ # Optional. List of up to 20 custom tags specified for this purchase option, and returned to the app through the billing library. Offers for this purchase option will also receive these tags in the billing library.
+            { # Represents a custom tag specified for a product offer.
+              "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+            },
+          ],
+          "purchaseOptionId": "A String", # Required. Immutable. The unique identifier of this purchase option. Must be unique within the one-time product. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.
+          "regionalPricingAndAvailabilityConfigs": [ # Regional pricing and availability information for this purchase option.
+            { # Regional pricing and availability configuration for a purchase option.
+              "availability": "A String", # The availability of the purchase option.
+              "price": { # Represents an amount of money with its currency type. # The price of the purchase option in the specified region. Must be set in the currency that is linked to the specified region.
+                "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+                "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+                "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+              },
+              "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., "US".
+            },
+          ],
+          "rentOption": { # A purchase option that can be rented. # A purchase option that can be rented.
+            "expirationPeriod": "A String", # Optional. The amount of time the user has after starting consuming the entitlement before it is revoked. Specified in ISO 8601 format.
+            "rentalPeriod": "A String", # Required. The amount of time a user has the entitlement for. Starts at purchase flow completion. Specified in ISO 8601 format.
+          },
+          "state": "A String", # Output only. The state of the purchase option, i.e., whether it's active. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.
+          "taxAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for one-time product purchase options. # Optional. Details about taxes and legal compliance.
+            "withdrawalRightType": "A String", # Optional. Digital content or service classification for products distributed to users in eligible regions. If unset, it defaults to `WITHDRAWAL_RIGHT_DIGITAL_CONTENT`. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information.
+          },
+        },
+      ],
+      "regionsVersion": { # The version of the available regions being used for the specified resource. # Output only. The version of the regions configuration that was used to generate the one-time product.
+        "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+      },
+      "restrictedPaymentCountries": { # Countries where the purchase of this product is restricted to payment methods registered in the same country. If empty, no payment location restrictions are imposed. # Optional. Countries where the purchase of this one-time product is restricted to payment methods registered in the same country. If empty, no payment location restrictions are imposed.
+        "regionCodes": [ # Required. Region codes to impose payment restrictions on, as defined by ISO 3166-2, e.g. "US".
+          "A String",
+        ],
+      },
+      "taxAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for one-time products. # Details about taxes and legal compliance.
+        "isTokenizedDigitalAsset": True or False, # Whether this one-time product is declared as a product representing a tokenized digital asset.
+        "regionalTaxConfigs": [ # Regional tax configuration.
+          { # Details about taxation in a given geographical region.
+            "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in the United States.
+            "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g. "US".
+            "streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
+            "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498).
+          },
+        ],
+      },
+    },
+  ],
+}
+
+ +
+ batchUpdate(packageName, body=None, x__xgafv=None) + 
Creates or updates one or more one-time products.
+
+Args:
+  packageName: string, Required. The parent app (package name) for which the one-time products should be updated. Must be equal to the package_name field on all the OneTimeProduct resources. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for BatchUpdateOneTimeProduct.
+  "requests": [ # Required. A list of update requests of up to 100 elements. All requests must update different one-time products.
+    { # Request message for UpdateOneTimeProduct.
+      "allowMissing": True or False, # Optional. If set to true, and the one-time product with the given package_name and product_id doesn't exist, the one-time product will be created. If a new one-time product is created, update_mask is ignored.
+      "latencyTolerance": "A String", # Optional. The latency tolerance for the propagation of this product upsert. Defaults to latency-sensitive.
+      "oneTimeProduct": { # A single one-time product for an app. # Required. The one-time product to upsert.
+        "listings": [ # Required. Set of localized title and description data. Must not have duplicate entries with the same language_code.
+          { # Regional store listing for a one-time product.
+            "description": "A String", # Required. The description of this product in the language of this listing. The maximum length is 200 characters.
+            "languageCode": "A String", # Required. The language of this listing, as defined by BCP-47, e.g., "en-US".
+            "title": "A String", # Required. The title of this product in the language of this listing. The maximum length is 55 characters.
+          },
+        ],
+        "offerTags": [ # Optional. List of up to 20 custom tags specified for this one-time product, and returned to the app through the billing library. Purchase options and offers for this product will also receive these tags in the billing library.
+          { # Represents a custom tag specified for a product offer.
+            "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+          },
+        ],
+        "packageName": "A String", # Required. Immutable. Package name of the parent app.
+        "productId": "A String", # Required. Immutable. Unique product ID of the product. Unique within the parent app. Product IDs must start with a number or lowercase letter, and can contain numbers (0-9), lowercase letters (a-z), underscores (_), and periods (.).
+        "purchaseOptions": [ # Required. The set of purchase options for this one-time product.
+          { # A single purchase option for a one-time product.
+            "buyOption": { # A purchase option that can be bought. # A purchase option that can be bought.
+              "legacyCompatible": True or False, # Optional. Whether this purchase option will be available in legacy PBL flows that do not support one-time products model. Up to one "buy" purchase option can be marked as backwards compatible.
+              "multiQuantityEnabled": True or False, # Optional. Whether this purchase option allows multi-quantity. Multi-quantity allows buyer to purchase more than one item in a single checkout.
+            },
+            "newRegionsConfig": { # Pricing information for any new regions Play may launch in the future. # Pricing information for any new locations Play may launch in the future. If omitted, the purchase option will not be automatically available in any new locations Play may launch in the future.
+              "availability": "A String", # Required. The regional availability for the new regions config. When set to AVAILABLE, the pricing information will be used for any new regions Play may launch in the future.
+              "eurPrice": { # Represents an amount of money with its currency type. # Required. Price in EUR to use for any new regions Play may launch in.
+                "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+                "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+                "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+              },
+              "usdPrice": { # Represents an amount of money with its currency type. # Required. Price in USD to use for any new regions Play may launch in.
+                "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+                "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+                "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+              },
+            },
+            "offerTags": [ # Optional. List of up to 20 custom tags specified for this purchase option, and returned to the app through the billing library. Offers for this purchase option will also receive these tags in the billing library.
+              { # Represents a custom tag specified for a product offer.
+                "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+              },
+            ],
+            "purchaseOptionId": "A String", # Required. Immutable. The unique identifier of this purchase option. Must be unique within the one-time product. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.
+            "regionalPricingAndAvailabilityConfigs": [ # Regional pricing and availability information for this purchase option.
+              { # Regional pricing and availability configuration for a purchase option.
+                "availability": "A String", # The availability of the purchase option.
+                "price": { # Represents an amount of money with its currency type. # The price of the purchase option in the specified region. Must be set in the currency that is linked to the specified region.
+                  "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+                  "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+                  "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+                },
+                "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., "US".
+              },
+            ],
+            "rentOption": { # A purchase option that can be rented. # A purchase option that can be rented.
+              "expirationPeriod": "A String", # Optional. The amount of time the user has after starting consuming the entitlement before it is revoked. Specified in ISO 8601 format.
+              "rentalPeriod": "A String", # Required. The amount of time a user has the entitlement for. Starts at purchase flow completion. Specified in ISO 8601 format.
+            },
+            "state": "A String", # Output only. The state of the purchase option, i.e., whether it's active. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.
+            "taxAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for one-time product purchase options. # Optional. Details about taxes and legal compliance.
+              "withdrawalRightType": "A String", # Optional. Digital content or service classification for products distributed to users in eligible regions. If unset, it defaults to `WITHDRAWAL_RIGHT_DIGITAL_CONTENT`. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information.
+            },
+          },
+        ],
+        "regionsVersion": { # The version of the available regions being used for the specified resource. # Output only. The version of the regions configuration that was used to generate the one-time product.
+          "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+        },
+        "restrictedPaymentCountries": { # Countries where the purchase of this product is restricted to payment methods registered in the same country. If empty, no payment location restrictions are imposed. # Optional. Countries where the purchase of this one-time product is restricted to payment methods registered in the same country. If empty, no payment location restrictions are imposed.
+          "regionCodes": [ # Required. Region codes to impose payment restrictions on, as defined by ISO 3166-2, e.g. "US".
+            "A String",
+          ],
+        },
+        "taxAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for one-time products. # Details about taxes and legal compliance.
+          "isTokenizedDigitalAsset": True or False, # Whether this one-time product is declared as a product representing a tokenized digital asset.
+          "regionalTaxConfigs": [ # Regional tax configuration.
+            { # Details about taxation in a given geographical region.
+              "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in the United States.
+              "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g. "US".
+              "streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
+              "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498).
+            },
+          ],
+        },
+      },
+      "regionsVersion": { # The version of the available regions being used for the specified resource. # Required. The version of the available regions being used for the one-time product.
+        "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+      },
+      "updateMask": "A String", # Required. The list of fields to be updated.
+    },
+  ],
+}
+
+  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 BatchUpdateOneTimeProduct.
+  "oneTimeProducts": [ # The list of updated one-time products list, in the same order as the request.
+    { # A single one-time product for an app.
+      "listings": [ # Required. Set of localized title and description data. Must not have duplicate entries with the same language_code.
+        { # Regional store listing for a one-time product.
+          "description": "A String", # Required. The description of this product in the language of this listing. The maximum length is 200 characters.
+          "languageCode": "A String", # Required. The language of this listing, as defined by BCP-47, e.g., "en-US".
+          "title": "A String", # Required. The title of this product in the language of this listing. The maximum length is 55 characters.
+        },
+      ],
+      "offerTags": [ # Optional. List of up to 20 custom tags specified for this one-time product, and returned to the app through the billing library. Purchase options and offers for this product will also receive these tags in the billing library.
+        { # Represents a custom tag specified for a product offer.
+          "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+        },
+      ],
+      "packageName": "A String", # Required. Immutable. Package name of the parent app.
+      "productId": "A String", # Required. Immutable. Unique product ID of the product. Unique within the parent app. Product IDs must start with a number or lowercase letter, and can contain numbers (0-9), lowercase letters (a-z), underscores (_), and periods (.).
+      "purchaseOptions": [ # Required. The set of purchase options for this one-time product.
+        { # A single purchase option for a one-time product.
+          "buyOption": { # A purchase option that can be bought. # A purchase option that can be bought.
+            "legacyCompatible": True or False, # Optional. Whether this purchase option will be available in legacy PBL flows that do not support one-time products model. Up to one "buy" purchase option can be marked as backwards compatible.
+            "multiQuantityEnabled": True or False, # Optional. Whether this purchase option allows multi-quantity. Multi-quantity allows buyer to purchase more than one item in a single checkout.
+          },
+          "newRegionsConfig": { # Pricing information for any new regions Play may launch in the future. # Pricing information for any new locations Play may launch in the future. If omitted, the purchase option will not be automatically available in any new locations Play may launch in the future.
+            "availability": "A String", # Required. The regional availability for the new regions config. When set to AVAILABLE, the pricing information will be used for any new regions Play may launch in the future.
+            "eurPrice": { # Represents an amount of money with its currency type. # Required. Price in EUR to use for any new regions Play may launch in.
+              "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+              "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+              "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+            },
+            "usdPrice": { # Represents an amount of money with its currency type. # Required. Price in USD to use for any new regions Play may launch in.
+              "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+              "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+              "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+            },
+          },
+          "offerTags": [ # Optional. List of up to 20 custom tags specified for this purchase option, and returned to the app through the billing library. Offers for this purchase option will also receive these tags in the billing library.
+            { # Represents a custom tag specified for a product offer.
+              "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+            },
+          ],
+          "purchaseOptionId": "A String", # Required. Immutable. The unique identifier of this purchase option. Must be unique within the one-time product. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.
+          "regionalPricingAndAvailabilityConfigs": [ # Regional pricing and availability information for this purchase option.
+            { # Regional pricing and availability configuration for a purchase option.
+              "availability": "A String", # The availability of the purchase option.
+              "price": { # Represents an amount of money with its currency type. # The price of the purchase option in the specified region. Must be set in the currency that is linked to the specified region.
+                "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+                "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+                "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+              },
+              "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., "US".
+            },
+          ],
+          "rentOption": { # A purchase option that can be rented. # A purchase option that can be rented.
+            "expirationPeriod": "A String", # Optional. The amount of time the user has after starting consuming the entitlement before it is revoked. Specified in ISO 8601 format.
+            "rentalPeriod": "A String", # Required. The amount of time a user has the entitlement for. Starts at purchase flow completion. Specified in ISO 8601 format.
+          },
+          "state": "A String", # Output only. The state of the purchase option, i.e., whether it's active. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.
+          "taxAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for one-time product purchase options. # Optional. Details about taxes and legal compliance.
+            "withdrawalRightType": "A String", # Optional. Digital content or service classification for products distributed to users in eligible regions. If unset, it defaults to `WITHDRAWAL_RIGHT_DIGITAL_CONTENT`. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information.
+          },
+        },
+      ],
+      "regionsVersion": { # The version of the available regions being used for the specified resource. # Output only. The version of the regions configuration that was used to generate the one-time product.
+        "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+      },
+      "restrictedPaymentCountries": { # Countries where the purchase of this product is restricted to payment methods registered in the same country. If empty, no payment location restrictions are imposed. # Optional. Countries where the purchase of this one-time product is restricted to payment methods registered in the same country. If empty, no payment location restrictions are imposed.
+        "regionCodes": [ # Required. Region codes to impose payment restrictions on, as defined by ISO 3166-2, e.g. "US".
+          "A String",
+        ],
+      },
+      "taxAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for one-time products. # Details about taxes and legal compliance.
+        "isTokenizedDigitalAsset": True or False, # Whether this one-time product is declared as a product representing a tokenized digital asset.
+        "regionalTaxConfigs": [ # Regional tax configuration.
+          { # Details about taxation in a given geographical region.
+            "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in the United States.
+            "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g. "US".
+            "streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
+            "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498).
+          },
+        ],
+      },
+    },
+  ],
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ delete(packageName, productId, latencyTolerance=None, x__xgafv=None) + 
Deletes a one-time product.
+
+Args:
+  packageName: string, Required. The parent app (package name) of the one-time product to delete. (required)
+  productId: string, Required. The one-time product ID of the one-time product to delete. (required)
+  latencyTolerance: string, Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.
+    Allowed values
+      PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED - Defaults to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE.
+      PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE - The update will propagate to clients within several minutes on average and up to a few hours in rare cases. Throughput is limited to 7,200 updates per app per hour.
+      PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT - The update will propagate to clients within 24 hours. Supports high throughput of up to 720,000 updates per app per hour using batch modification methods.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+
+ +
+ get(packageName, productId, x__xgafv=None) + 
Reads a single one-time product.
+
+Args:
+  packageName: string, Required. The parent app (package name) of the product to retrieve. (required)
+  productId: string, Required. The product ID of the product to retrieve. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A single one-time product for an app.
+  "listings": [ # Required. Set of localized title and description data. Must not have duplicate entries with the same language_code.
+    { # Regional store listing for a one-time product.
+      "description": "A String", # Required. The description of this product in the language of this listing. The maximum length is 200 characters.
+      "languageCode": "A String", # Required. The language of this listing, as defined by BCP-47, e.g., "en-US".
+      "title": "A String", # Required. The title of this product in the language of this listing. The maximum length is 55 characters.
+    },
+  ],
+  "offerTags": [ # Optional. List of up to 20 custom tags specified for this one-time product, and returned to the app through the billing library. Purchase options and offers for this product will also receive these tags in the billing library.
+    { # Represents a custom tag specified for a product offer.
+      "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+    },
+  ],
+  "packageName": "A String", # Required. Immutable. Package name of the parent app.
+  "productId": "A String", # Required. Immutable. Unique product ID of the product. Unique within the parent app. Product IDs must start with a number or lowercase letter, and can contain numbers (0-9), lowercase letters (a-z), underscores (_), and periods (.).
+  "purchaseOptions": [ # Required. The set of purchase options for this one-time product.
+    { # A single purchase option for a one-time product.
+      "buyOption": { # A purchase option that can be bought. # A purchase option that can be bought.
+        "legacyCompatible": True or False, # Optional. Whether this purchase option will be available in legacy PBL flows that do not support one-time products model. Up to one "buy" purchase option can be marked as backwards compatible.
+        "multiQuantityEnabled": True or False, # Optional. Whether this purchase option allows multi-quantity. Multi-quantity allows buyer to purchase more than one item in a single checkout.
+      },
+      "newRegionsConfig": { # Pricing information for any new regions Play may launch in the future. # Pricing information for any new locations Play may launch in the future. If omitted, the purchase option will not be automatically available in any new locations Play may launch in the future.
+        "availability": "A String", # Required. The regional availability for the new regions config. When set to AVAILABLE, the pricing information will be used for any new regions Play may launch in the future.
+        "eurPrice": { # Represents an amount of money with its currency type. # Required. Price in EUR to use for any new regions Play may launch in.
+          "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+          "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+          "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+        },
+        "usdPrice": { # Represents an amount of money with its currency type. # Required. Price in USD to use for any new regions Play may launch in.
+          "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+          "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+          "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+        },
+      },
+      "offerTags": [ # Optional. List of up to 20 custom tags specified for this purchase option, and returned to the app through the billing library. Offers for this purchase option will also receive these tags in the billing library.
+        { # Represents a custom tag specified for a product offer.
+          "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+        },
+      ],
+      "purchaseOptionId": "A String", # Required. Immutable. The unique identifier of this purchase option. Must be unique within the one-time product. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.
+      "regionalPricingAndAvailabilityConfigs": [ # Regional pricing and availability information for this purchase option.
+        { # Regional pricing and availability configuration for a purchase option.
+          "availability": "A String", # The availability of the purchase option.
+          "price": { # Represents an amount of money with its currency type. # The price of the purchase option in the specified region. Must be set in the currency that is linked to the specified region.
+            "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+            "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+            "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+          },
+          "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., "US".
+        },
+      ],
+      "rentOption": { # A purchase option that can be rented. # A purchase option that can be rented.
+        "expirationPeriod": "A String", # Optional. The amount of time the user has after starting consuming the entitlement before it is revoked. Specified in ISO 8601 format.
+        "rentalPeriod": "A String", # Required. The amount of time a user has the entitlement for. Starts at purchase flow completion. Specified in ISO 8601 format.
+      },
+      "state": "A String", # Output only. The state of the purchase option, i.e., whether it's active. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.
+      "taxAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for one-time product purchase options. # Optional. Details about taxes and legal compliance.
+        "withdrawalRightType": "A String", # Optional. Digital content or service classification for products distributed to users in eligible regions. If unset, it defaults to `WITHDRAWAL_RIGHT_DIGITAL_CONTENT`. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information.
+      },
+    },
+  ],
+  "regionsVersion": { # The version of the available regions being used for the specified resource. # Output only. The version of the regions configuration that was used to generate the one-time product.
+    "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+  },
+  "restrictedPaymentCountries": { # Countries where the purchase of this product is restricted to payment methods registered in the same country. If empty, no payment location restrictions are imposed. # Optional. Countries where the purchase of this one-time product is restricted to payment methods registered in the same country. If empty, no payment location restrictions are imposed.
+    "regionCodes": [ # Required. Region codes to impose payment restrictions on, as defined by ISO 3166-2, e.g. "US".
+      "A String",
+    ],
+  },
+  "taxAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for one-time products. # Details about taxes and legal compliance.
+    "isTokenizedDigitalAsset": True or False, # Whether this one-time product is declared as a product representing a tokenized digital asset.
+    "regionalTaxConfigs": [ # Regional tax configuration.
+      { # Details about taxation in a given geographical region.
+        "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in the United States.
+        "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g. "US".
+        "streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
+        "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498).
+      },
+    ],
+  },
+}
+
+ +
+ list(packageName, pageSize=None, pageToken=None, x__xgafv=None) + 
Lists all one-time products under a given app.
+
+Args:
+  packageName: string, Required. The parent app (package name) for which the one-time product should be read. (required)
+  pageSize: integer, Optional. The maximum number of one-time product to return. The service may return fewer than this value. If unspecified, at most 50 one-time products will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
+  pageToken: string, Optional. A page token, received from a previous `ListOneTimeProducts` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListOneTimeProducts` must match the call that provided the page token.
+  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 ListOneTimeProducts.
+  "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+  "oneTimeProducts": [ # The one-time products from the specified app.
+    { # A single one-time product for an app.
+      "listings": [ # Required. Set of localized title and description data. Must not have duplicate entries with the same language_code.
+        { # Regional store listing for a one-time product.
+          "description": "A String", # Required. The description of this product in the language of this listing. The maximum length is 200 characters.
+          "languageCode": "A String", # Required. The language of this listing, as defined by BCP-47, e.g., "en-US".
+          "title": "A String", # Required. The title of this product in the language of this listing. The maximum length is 55 characters.
+        },
+      ],
+      "offerTags": [ # Optional. List of up to 20 custom tags specified for this one-time product, and returned to the app through the billing library. Purchase options and offers for this product will also receive these tags in the billing library.
+        { # Represents a custom tag specified for a product offer.
+          "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+        },
+      ],
+      "packageName": "A String", # Required. Immutable. Package name of the parent app.
+      "productId": "A String", # Required. Immutable. Unique product ID of the product. Unique within the parent app. Product IDs must start with a number or lowercase letter, and can contain numbers (0-9), lowercase letters (a-z), underscores (_), and periods (.).
+      "purchaseOptions": [ # Required. The set of purchase options for this one-time product.
+        { # A single purchase option for a one-time product.
+          "buyOption": { # A purchase option that can be bought. # A purchase option that can be bought.
+            "legacyCompatible": True or False, # Optional. Whether this purchase option will be available in legacy PBL flows that do not support one-time products model. Up to one "buy" purchase option can be marked as backwards compatible.
+            "multiQuantityEnabled": True or False, # Optional. Whether this purchase option allows multi-quantity. Multi-quantity allows buyer to purchase more than one item in a single checkout.
+          },
+          "newRegionsConfig": { # Pricing information for any new regions Play may launch in the future. # Pricing information for any new locations Play may launch in the future. If omitted, the purchase option will not be automatically available in any new locations Play may launch in the future.
+            "availability": "A String", # Required. The regional availability for the new regions config. When set to AVAILABLE, the pricing information will be used for any new regions Play may launch in the future.
+            "eurPrice": { # Represents an amount of money with its currency type. # Required. Price in EUR to use for any new regions Play may launch in.
+              "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+              "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+              "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+            },
+            "usdPrice": { # Represents an amount of money with its currency type. # Required. Price in USD to use for any new regions Play may launch in.
+              "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+              "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+              "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+            },
+          },
+          "offerTags": [ # Optional. List of up to 20 custom tags specified for this purchase option, and returned to the app through the billing library. Offers for this purchase option will also receive these tags in the billing library.
+            { # Represents a custom tag specified for a product offer.
+              "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+            },
+          ],
+          "purchaseOptionId": "A String", # Required. Immutable. The unique identifier of this purchase option. Must be unique within the one-time product. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.
+          "regionalPricingAndAvailabilityConfigs": [ # Regional pricing and availability information for this purchase option.
+            { # Regional pricing and availability configuration for a purchase option.
+              "availability": "A String", # The availability of the purchase option.
+              "price": { # Represents an amount of money with its currency type. # The price of the purchase option in the specified region. Must be set in the currency that is linked to the specified region.
+                "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+                "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+                "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+              },
+              "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., "US".
+            },
+          ],
+          "rentOption": { # A purchase option that can be rented. # A purchase option that can be rented.
+            "expirationPeriod": "A String", # Optional. The amount of time the user has after starting consuming the entitlement before it is revoked. Specified in ISO 8601 format.
+            "rentalPeriod": "A String", # Required. The amount of time a user has the entitlement for. Starts at purchase flow completion. Specified in ISO 8601 format.
+          },
+          "state": "A String", # Output only. The state of the purchase option, i.e., whether it's active. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.
+          "taxAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for one-time product purchase options. # Optional. Details about taxes and legal compliance.
+            "withdrawalRightType": "A String", # Optional. Digital content or service classification for products distributed to users in eligible regions. If unset, it defaults to `WITHDRAWAL_RIGHT_DIGITAL_CONTENT`. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information.
+          },
+        },
+      ],
+      "regionsVersion": { # The version of the available regions being used for the specified resource. # Output only. The version of the regions configuration that was used to generate the one-time product.
+        "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+      },
+      "restrictedPaymentCountries": { # Countries where the purchase of this product is restricted to payment methods registered in the same country. If empty, no payment location restrictions are imposed. # Optional. Countries where the purchase of this one-time product is restricted to payment methods registered in the same country. If empty, no payment location restrictions are imposed.
+        "regionCodes": [ # Required. Region codes to impose payment restrictions on, as defined by ISO 3166-2, e.g. "US".
+          "A String",
+        ],
+      },
+      "taxAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for one-time products. # Details about taxes and legal compliance.
+        "isTokenizedDigitalAsset": True or False, # Whether this one-time product is declared as a product representing a tokenized digital asset.
+        "regionalTaxConfigs": [ # Regional tax configuration.
+          { # Details about taxation in a given geographical region.
+            "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in the United States.
+            "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g. "US".
+            "streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
+            "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498).
+          },
+        ],
+      },
+    },
+  ],
+}
+
+ +
+ 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(packageName, productId, allowMissing=None, body=None, latencyTolerance=None, regionsVersion_version=None, updateMask=None, x__xgafv=None) + 
Creates or updates a one-time product.
+
+Args:
+  packageName: string, Required. Immutable. Package name of the parent app. (required)
+  productId: string, Required. Immutable. Unique product ID of the product. Unique within the parent app. Product IDs must start with a number or lowercase letter, and can contain numbers (0-9), lowercase letters (a-z), underscores (_), and periods (.). (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # A single one-time product for an app.
+  "listings": [ # Required. Set of localized title and description data. Must not have duplicate entries with the same language_code.
+    { # Regional store listing for a one-time product.
+      "description": "A String", # Required. The description of this product in the language of this listing. The maximum length is 200 characters.
+      "languageCode": "A String", # Required. The language of this listing, as defined by BCP-47, e.g., "en-US".
+      "title": "A String", # Required. The title of this product in the language of this listing. The maximum length is 55 characters.
+    },
+  ],
+  "offerTags": [ # Optional. List of up to 20 custom tags specified for this one-time product, and returned to the app through the billing library. Purchase options and offers for this product will also receive these tags in the billing library.
+    { # Represents a custom tag specified for a product offer.
+      "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+    },
+  ],
+  "packageName": "A String", # Required. Immutable. Package name of the parent app.
+  "productId": "A String", # Required. Immutable. Unique product ID of the product. Unique within the parent app. Product IDs must start with a number or lowercase letter, and can contain numbers (0-9), lowercase letters (a-z), underscores (_), and periods (.).
+  "purchaseOptions": [ # Required. The set of purchase options for this one-time product.
+    { # A single purchase option for a one-time product.
+      "buyOption": { # A purchase option that can be bought. # A purchase option that can be bought.
+        "legacyCompatible": True or False, # Optional. Whether this purchase option will be available in legacy PBL flows that do not support one-time products model. Up to one "buy" purchase option can be marked as backwards compatible.
+        "multiQuantityEnabled": True or False, # Optional. Whether this purchase option allows multi-quantity. Multi-quantity allows buyer to purchase more than one item in a single checkout.
+      },
+      "newRegionsConfig": { # Pricing information for any new regions Play may launch in the future. # Pricing information for any new locations Play may launch in the future. If omitted, the purchase option will not be automatically available in any new locations Play may launch in the future.
+        "availability": "A String", # Required. The regional availability for the new regions config. When set to AVAILABLE, the pricing information will be used for any new regions Play may launch in the future.
+        "eurPrice": { # Represents an amount of money with its currency type. # Required. Price in EUR to use for any new regions Play may launch in.
+          "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+          "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+          "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+        },
+        "usdPrice": { # Represents an amount of money with its currency type. # Required. Price in USD to use for any new regions Play may launch in.
+          "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+          "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+          "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+        },
+      },
+      "offerTags": [ # Optional. List of up to 20 custom tags specified for this purchase option, and returned to the app through the billing library. Offers for this purchase option will also receive these tags in the billing library.
+        { # Represents a custom tag specified for a product offer.
+          "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+        },
+      ],
+      "purchaseOptionId": "A String", # Required. Immutable. The unique identifier of this purchase option. Must be unique within the one-time product. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.
+      "regionalPricingAndAvailabilityConfigs": [ # Regional pricing and availability information for this purchase option.
+        { # Regional pricing and availability configuration for a purchase option.
+          "availability": "A String", # The availability of the purchase option.
+          "price": { # Represents an amount of money with its currency type. # The price of the purchase option in the specified region. Must be set in the currency that is linked to the specified region.
+            "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+            "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+            "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+          },
+          "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., "US".
+        },
+      ],
+      "rentOption": { # A purchase option that can be rented. # A purchase option that can be rented.
+        "expirationPeriod": "A String", # Optional. The amount of time the user has after starting consuming the entitlement before it is revoked. Specified in ISO 8601 format.
+        "rentalPeriod": "A String", # Required. The amount of time a user has the entitlement for. Starts at purchase flow completion. Specified in ISO 8601 format.
+      },
+      "state": "A String", # Output only. The state of the purchase option, i.e., whether it's active. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.
+      "taxAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for one-time product purchase options. # Optional. Details about taxes and legal compliance.
+        "withdrawalRightType": "A String", # Optional. Digital content or service classification for products distributed to users in eligible regions. If unset, it defaults to `WITHDRAWAL_RIGHT_DIGITAL_CONTENT`. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information.
+      },
+    },
+  ],
+  "regionsVersion": { # The version of the available regions being used for the specified resource. # Output only. The version of the regions configuration that was used to generate the one-time product.
+    "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+  },
+  "restrictedPaymentCountries": { # Countries where the purchase of this product is restricted to payment methods registered in the same country. If empty, no payment location restrictions are imposed. # Optional. Countries where the purchase of this one-time product is restricted to payment methods registered in the same country. If empty, no payment location restrictions are imposed.
+    "regionCodes": [ # Required. Region codes to impose payment restrictions on, as defined by ISO 3166-2, e.g. "US".
+      "A String",
+    ],
+  },
+  "taxAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for one-time products. # Details about taxes and legal compliance.
+    "isTokenizedDigitalAsset": True or False, # Whether this one-time product is declared as a product representing a tokenized digital asset.
+    "regionalTaxConfigs": [ # Regional tax configuration.
+      { # Details about taxation in a given geographical region.
+        "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in the United States.
+        "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g. "US".
+        "streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
+        "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498).
+      },
+    ],
+  },
+}
+
+  allowMissing: boolean, Optional. If set to true, and the one-time product with the given package_name and product_id doesn't exist, the one-time product will be created. If a new one-time product is created, update_mask is ignored.
+  latencyTolerance: string, Optional. The latency tolerance for the propagation of this product upsert. Defaults to latency-sensitive.
+    Allowed values
+      PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED - Defaults to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE.
+      PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE - The update will propagate to clients within several minutes on average and up to a few hours in rare cases. Throughput is limited to 7,200 updates per app per hour.
+      PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT - The update will propagate to clients within 24 hours. Supports high throughput of up to 720,000 updates per app per hour using batch modification methods.
+  regionsVersion_version: string, Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+  updateMask: string, Required. The list of fields to be updated.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A single one-time product for an app.
+  "listings": [ # Required. Set of localized title and description data. Must not have duplicate entries with the same language_code.
+    { # Regional store listing for a one-time product.
+      "description": "A String", # Required. The description of this product in the language of this listing. The maximum length is 200 characters.
+      "languageCode": "A String", # Required. The language of this listing, as defined by BCP-47, e.g., "en-US".
+      "title": "A String", # Required. The title of this product in the language of this listing. The maximum length is 55 characters.
+    },
+  ],
+  "offerTags": [ # Optional. List of up to 20 custom tags specified for this one-time product, and returned to the app through the billing library. Purchase options and offers for this product will also receive these tags in the billing library.
+    { # Represents a custom tag specified for a product offer.
+      "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+    },
+  ],
+  "packageName": "A String", # Required. Immutable. Package name of the parent app.
+  "productId": "A String", # Required. Immutable. Unique product ID of the product. Unique within the parent app. Product IDs must start with a number or lowercase letter, and can contain numbers (0-9), lowercase letters (a-z), underscores (_), and periods (.).
+  "purchaseOptions": [ # Required. The set of purchase options for this one-time product.
+    { # A single purchase option for a one-time product.
+      "buyOption": { # A purchase option that can be bought. # A purchase option that can be bought.
+        "legacyCompatible": True or False, # Optional. Whether this purchase option will be available in legacy PBL flows that do not support one-time products model. Up to one "buy" purchase option can be marked as backwards compatible.
+        "multiQuantityEnabled": True or False, # Optional. Whether this purchase option allows multi-quantity. Multi-quantity allows buyer to purchase more than one item in a single checkout.
+      },
+      "newRegionsConfig": { # Pricing information for any new regions Play may launch in the future. # Pricing information for any new locations Play may launch in the future. If omitted, the purchase option will not be automatically available in any new locations Play may launch in the future.
+        "availability": "A String", # Required. The regional availability for the new regions config. When set to AVAILABLE, the pricing information will be used for any new regions Play may launch in the future.
+        "eurPrice": { # Represents an amount of money with its currency type. # Required. Price in EUR to use for any new regions Play may launch in.
+          "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+          "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+          "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+        },
+        "usdPrice": { # Represents an amount of money with its currency type. # Required. Price in USD to use for any new regions Play may launch in.
+          "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+          "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+          "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+        },
+      },
+      "offerTags": [ # Optional. List of up to 20 custom tags specified for this purchase option, and returned to the app through the billing library. Offers for this purchase option will also receive these tags in the billing library.
+        { # Represents a custom tag specified for a product offer.
+          "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+        },
+      ],
+      "purchaseOptionId": "A String", # Required. Immutable. The unique identifier of this purchase option. Must be unique within the one-time product. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.
+      "regionalPricingAndAvailabilityConfigs": [ # Regional pricing and availability information for this purchase option.
+        { # Regional pricing and availability configuration for a purchase option.
+          "availability": "A String", # The availability of the purchase option.
+          "price": { # Represents an amount of money with its currency type. # The price of the purchase option in the specified region. Must be set in the currency that is linked to the specified region.
+            "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+            "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+            "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+          },
+          "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., "US".
+        },
+      ],
+      "rentOption": { # A purchase option that can be rented. # A purchase option that can be rented.
+        "expirationPeriod": "A String", # Optional. The amount of time the user has after starting consuming the entitlement before it is revoked. Specified in ISO 8601 format.
+        "rentalPeriod": "A String", # Required. The amount of time a user has the entitlement for. Starts at purchase flow completion. Specified in ISO 8601 format.
+      },
+      "state": "A String", # Output only. The state of the purchase option, i.e., whether it's active. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.
+      "taxAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for one-time product purchase options. # Optional. Details about taxes and legal compliance.
+        "withdrawalRightType": "A String", # Optional. Digital content or service classification for products distributed to users in eligible regions. If unset, it defaults to `WITHDRAWAL_RIGHT_DIGITAL_CONTENT`. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information.
+      },
+    },
+  ],
+  "regionsVersion": { # The version of the available regions being used for the specified resource. # Output only. The version of the regions configuration that was used to generate the one-time product.
+    "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+  },
+  "restrictedPaymentCountries": { # Countries where the purchase of this product is restricted to payment methods registered in the same country. If empty, no payment location restrictions are imposed. # Optional. Countries where the purchase of this one-time product is restricted to payment methods registered in the same country. If empty, no payment location restrictions are imposed.
+    "regionCodes": [ # Required. Region codes to impose payment restrictions on, as defined by ISO 3166-2, e.g. "US".
+      "A String",
+    ],
+  },
+  "taxAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for one-time products. # Details about taxes and legal compliance.
+    "isTokenizedDigitalAsset": True or False, # Whether this one-time product is declared as a product representing a tokenized digital asset.
+    "regionalTaxConfigs": [ # Regional tax configuration.
+      { # Details about taxation in a given geographical region.
+        "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in the United States.
+        "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g. "US".
+        "streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
+        "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498).
+      },
+    ],
+  },
+}
+
+ + \ No newline at end of file diff --git a/docs/dyn/androidpublisher_v3.monetization.onetimeproducts.purchaseOptions.html b/docs/dyn/androidpublisher_v3.monetization.onetimeproducts.purchaseOptions.html new file mode 100644 index 00000000000..bd97044c474 --- /dev/null +++ b/docs/dyn/androidpublisher_v3.monetization.onetimeproducts.purchaseOptions.html @@ -0,0 +1,250 @@ + + + +

Google Play Android Developer API . monetization . onetimeproducts . purchaseOptions

+

Instance Methods

+

+ offers() +

+

Returns the offers Resource.

+ +

+ batchDelete(packageName, productId, body=None, x__xgafv=None)

+

Deletes purchase options across one or multiple one-time products. By default this operation will fail if there are any existing offers under the deleted purchase options. Use the force parameter to override the default behavior.

+

+ batchUpdateStates(packageName, productId, body=None, x__xgafv=None)

+

Activates or deactivates purchase options across one or multiple one-time products.

+

+ close()

+

Close httplib2 connections.

+

Method Details

+
+ batchDelete(packageName, productId, body=None, x__xgafv=None) + 
Deletes purchase options across one or multiple one-time products. By default this operation will fail if there are any existing offers under the deleted purchase options. Use the force parameter to override the default behavior.
+
+Args:
+  packageName: string, Required. The parent app (package name) of the purchase options to delete. (required)
+  productId: string, Required. The product ID of the parent one-time product, if all purchase options to delete belong to the same one-time product. If this batch delete spans multiple one-time products, set this field to "-". (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for BatchDeletePurchaseOption.
+  "requests": [ # Required. A list of delete requests of up to 100 elements. All requests must delete purchase options from different one-time products.
+    { # Request message for deleting a purchase option.
+      "force": True or False, # Optional. This field has no effect for purchase options with no offers under them. For purchase options with associated offers: * If `force` is set to false (default), an error will be returned. * If `force` is set to true, any associated offers under the purchase option will be deleted.
+      "latencyTolerance": "A String", # Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.
+      "packageName": "A String", # Required. The parent app (package name) of the purchase option to delete.
+      "productId": "A String", # Required. The parent one-time product (ID) of the purchase option to delete.
+      "purchaseOptionId": "A String", # Required. The purchase option ID of the purchase option to delete.
+    },
+  ],
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+
+ +
+ batchUpdateStates(packageName, productId, body=None, x__xgafv=None) + 
Activates or deactivates purchase options across one or multiple one-time products.
+
+Args:
+  packageName: string, Required. The parent app (package name) of the updated purchase options. (required)
+  productId: string, Required. The product ID of the parent one-time product, if all updated purchase options belong to the same one-time product. If this batch update spans multiple one-time products, set this field to "-". (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for BatchUpdatePurchaseOptionStates.
+  "requests": [ # Required. The update request list of up to 100 elements. All requests must update different purchase options.
+    { # Request message to update the state of a one-time product purchase option.
+      "activatePurchaseOptionRequest": { # Request message for UpdatePurchaseOptionState. # Activates a purchase option. Once activated, the purchase option will be available.
+        "latencyTolerance": "A String", # Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.
+        "packageName": "A String", # Required. The parent app (package name) of the purchase option to activate.
+        "productId": "A String", # Required. The parent one-time product (ID) of the purchase option to activate.
+        "purchaseOptionId": "A String", # Required. The purchase option ID of the purchase option to activate.
+      },
+      "deactivatePurchaseOptionRequest": { # Request message for UpdatePurchaseOptionState. # Deactivates a purchase option. Once deactivated, the purchase option will become unavailable.
+        "latencyTolerance": "A String", # Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.
+        "packageName": "A String", # Required. The parent app (package name) of the purchase option to deactivate.
+        "productId": "A String", # Required. The parent one-time product (ID) of the purchase option to deactivate.
+        "purchaseOptionId": "A String", # Required. The purchase option ID of the purchase option to deactivate.
+      },
+    },
+  ],
+}
+
+  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 BatchUpdatePurchaseOptionStates.
+  "oneTimeProducts": [ # The list of updated one-time products. This list will match the requests one to one, in the same order.
+    { # A single one-time product for an app.
+      "listings": [ # Required. Set of localized title and description data. Must not have duplicate entries with the same language_code.
+        { # Regional store listing for a one-time product.
+          "description": "A String", # Required. The description of this product in the language of this listing. The maximum length is 200 characters.
+          "languageCode": "A String", # Required. The language of this listing, as defined by BCP-47, e.g., "en-US".
+          "title": "A String", # Required. The title of this product in the language of this listing. The maximum length is 55 characters.
+        },
+      ],
+      "offerTags": [ # Optional. List of up to 20 custom tags specified for this one-time product, and returned to the app through the billing library. Purchase options and offers for this product will also receive these tags in the billing library.
+        { # Represents a custom tag specified for a product offer.
+          "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+        },
+      ],
+      "packageName": "A String", # Required. Immutable. Package name of the parent app.
+      "productId": "A String", # Required. Immutable. Unique product ID of the product. Unique within the parent app. Product IDs must start with a number or lowercase letter, and can contain numbers (0-9), lowercase letters (a-z), underscores (_), and periods (.).
+      "purchaseOptions": [ # Required. The set of purchase options for this one-time product.
+        { # A single purchase option for a one-time product.
+          "buyOption": { # A purchase option that can be bought. # A purchase option that can be bought.
+            "legacyCompatible": True or False, # Optional. Whether this purchase option will be available in legacy PBL flows that do not support one-time products model. Up to one "buy" purchase option can be marked as backwards compatible.
+            "multiQuantityEnabled": True or False, # Optional. Whether this purchase option allows multi-quantity. Multi-quantity allows buyer to purchase more than one item in a single checkout.
+          },
+          "newRegionsConfig": { # Pricing information for any new regions Play may launch in the future. # Pricing information for any new locations Play may launch in the future. If omitted, the purchase option will not be automatically available in any new locations Play may launch in the future.
+            "availability": "A String", # Required. The regional availability for the new regions config. When set to AVAILABLE, the pricing information will be used for any new regions Play may launch in the future.
+            "eurPrice": { # Represents an amount of money with its currency type. # Required. Price in EUR to use for any new regions Play may launch in.
+              "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+              "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+              "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+            },
+            "usdPrice": { # Represents an amount of money with its currency type. # Required. Price in USD to use for any new regions Play may launch in.
+              "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+              "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+              "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+            },
+          },
+          "offerTags": [ # Optional. List of up to 20 custom tags specified for this purchase option, and returned to the app through the billing library. Offers for this purchase option will also receive these tags in the billing library.
+            { # Represents a custom tag specified for a product offer.
+              "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+            },
+          ],
+          "purchaseOptionId": "A String", # Required. Immutable. The unique identifier of this purchase option. Must be unique within the one-time product. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.
+          "regionalPricingAndAvailabilityConfigs": [ # Regional pricing and availability information for this purchase option.
+            { # Regional pricing and availability configuration for a purchase option.
+              "availability": "A String", # The availability of the purchase option.
+              "price": { # Represents an amount of money with its currency type. # The price of the purchase option in the specified region. Must be set in the currency that is linked to the specified region.
+                "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+                "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+                "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+              },
+              "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., "US".
+            },
+          ],
+          "rentOption": { # A purchase option that can be rented. # A purchase option that can be rented.
+            "expirationPeriod": "A String", # Optional. The amount of time the user has after starting consuming the entitlement before it is revoked. Specified in ISO 8601 format.
+            "rentalPeriod": "A String", # Required. The amount of time a user has the entitlement for. Starts at purchase flow completion. Specified in ISO 8601 format.
+          },
+          "state": "A String", # Output only. The state of the purchase option, i.e., whether it's active. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.
+          "taxAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for one-time product purchase options. # Optional. Details about taxes and legal compliance.
+            "withdrawalRightType": "A String", # Optional. Digital content or service classification for products distributed to users in eligible regions. If unset, it defaults to `WITHDRAWAL_RIGHT_DIGITAL_CONTENT`. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information.
+          },
+        },
+      ],
+      "regionsVersion": { # The version of the available regions being used for the specified resource. # Output only. The version of the regions configuration that was used to generate the one-time product.
+        "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+      },
+      "restrictedPaymentCountries": { # Countries where the purchase of this product is restricted to payment methods registered in the same country. If empty, no payment location restrictions are imposed. # Optional. Countries where the purchase of this one-time product is restricted to payment methods registered in the same country. If empty, no payment location restrictions are imposed.
+        "regionCodes": [ # Required. Region codes to impose payment restrictions on, as defined by ISO 3166-2, e.g. "US".
+          "A String",
+        ],
+      },
+      "taxAndComplianceSettings": { # Details about taxation, Google Play policy and legal compliance for one-time products. # Details about taxes and legal compliance.
+        "isTokenizedDigitalAsset": True or False, # Whether this one-time product is declared as a product representing a tokenized digital asset.
+        "regionalTaxConfigs": [ # Regional tax configuration.
+          { # Details about taxation in a given geographical region.
+            "eligibleForStreamingServiceTaxRate": True or False, # You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in the United States.
+            "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g. "US".
+            "streamingTaxType": "A String", # To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).
+            "taxTier": "A String", # Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498).
+          },
+        ],
+      },
+    },
+  ],
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ + \ No newline at end of file diff --git a/docs/dyn/androidpublisher_v3.monetization.onetimeproducts.purchaseOptions.offers.html b/docs/dyn/androidpublisher_v3.monetization.onetimeproducts.purchaseOptions.offers.html new file mode 100644 index 00000000000..5eaf7a952bb --- /dev/null +++ b/docs/dyn/androidpublisher_v3.monetization.onetimeproducts.purchaseOptions.offers.html @@ -0,0 +1,719 @@ + + + +

Google Play Android Developer API . monetization . onetimeproducts . purchaseOptions . offers

+

Instance Methods

+

+ activate(packageName, productId, purchaseOptionId, offerId, body=None, x__xgafv=None)

+

Activates a one-time product offer.

+

+ batchDelete(packageName, productId, purchaseOptionId, body=None, x__xgafv=None)

+

Deletes one or more one-time product offers.

+

+ batchGet(packageName, productId, purchaseOptionId, body=None, x__xgafv=None)

+

Reads one or more one-time product offers.

+

+ batchUpdate(packageName, productId, purchaseOptionId, body=None, x__xgafv=None)

+

Creates or updates one or more one-time product offers.

+

+ batchUpdateStates(packageName, productId, purchaseOptionId, body=None, x__xgafv=None)

+

Updates a batch of one-time product offer states.

+

+ cancel(packageName, productId, purchaseOptionId, offerId, body=None, x__xgafv=None)

+

Cancels a one-time product offer.

+

+ close()

+

Close httplib2 connections.

+

+ deactivate(packageName, productId, purchaseOptionId, offerId, body=None, x__xgafv=None)

+

Deactivates a one-time product offer.

+

+ list(packageName, productId, purchaseOptionId, pageSize=None, pageToken=None, x__xgafv=None)

+

Lists all offers under a given app, product, or purchase option.

+

+ list_next()

+

Retrieves the next page of results.

+

Method Details

+
+ activate(packageName, productId, purchaseOptionId, offerId, body=None, x__xgafv=None) + 
Activates a one-time product offer.
+
+Args:
+  packageName: string, Required. The parent app (package name) of the offer to activate. (required)
+  productId: string, Required. The parent one-time product (ID) of the offer to activate. (required)
+  purchaseOptionId: string, Required. The parent purchase option (ID) of the offer to activate. (required)
+  offerId: string, Required. The offer ID of the offer to activate. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for ActivateOneTimeProductOffer.
+  "latencyTolerance": "A String", # Optional. The latency tolerance for the propagation of this update. Defaults to latency-sensitive.
+  "offerId": "A String", # Required. The offer ID of the offer to activate.
+  "packageName": "A String", # Required. The parent app (package name) of the offer to activate.
+  "productId": "A String", # Required. The parent one-time product (ID) of the offer to activate.
+  "purchaseOptionId": "A String", # Required. The parent purchase option (ID) of the offer to activate.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A single offer for a one-time product.
+  "discountedOffer": { # Configuration specific to discounted offers. # A discounted offer.
+    "endTime": "A String", # Time when the offer will stop being available.
+    "redemptionLimit": "A String", # Optional. The number of times this offer can be redeemed. If unset or set to 0, allows for unlimited offer redemptions. Otherwise must be a number between 1 and 50 inclusive.
+    "startTime": "A String", # Time when the offer will start being available.
+  },
+  "offerId": "A String", # Required. Immutable. The ID of this product offer. Must be unique within the purchase option. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.
+  "offerTags": [ # Optional. List of up to 20 custom tags specified for this offer, and returned to the app through the billing library.
+    { # Represents a custom tag specified for a product offer.
+      "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+    },
+  ],
+  "packageName": "A String", # Required. Immutable. The package name of the app the parent product belongs to.
+  "preOrderOffer": { # Configuration specific to pre-order offers. # A pre-order offer.
+    "endTime": "A String", # Required. Time when the pre-order will stop being available.
+    "priceChangeBehavior": "A String", # Required. Immutable. Specifies how price changes affect pre-existing pre-orders.
+    "releaseTime": "A String", # Required. Time on which the product associated with the pre-order will be released and the pre-order orders fulfilled.
+    "startTime": "A String", # Required. Time when the pre-order will start being available.
+  },
+  "productId": "A String", # Required. Immutable. The ID of the parent product this offer belongs to.
+  "purchaseOptionId": "A String", # Required. Immutable. The ID of the purchase option to which this offer is an extension.
+  "regionalPricingAndAvailabilityConfigs": [ # Set of regional pricing and availability information for this offer. Must not have duplicate entries with the same region_code.
+    { # Regional pricing and availability configuration for a one-time product offer.
+      "absoluteDiscount": { # Represents an amount of money with its currency type. # The absolute value of the discount that is subtracted from the purchase option price. It should be between 0 and the purchase option price.
+        "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+        "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+        "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+      },
+      "availability": "A String", # Required. The availability for this region.
+      "noOverride": { # Options for one-time product offers without a regional price override. # The price defined in the purchase option for this region will be used.
+      },
+      "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., "US".
+      "relativeDiscount": 3.14, # The fraction of the purchase option price that the user pays for this offer. For example, if the purchase option price for this region is $12, then a 50% discount would correspond to a price of $6. The discount must be specified as a fraction strictly larger than 0 and strictly smaller than 1. The resulting price will be rounded to the nearest billable unit (e.g. cents for USD). The relative discount is considered invalid if the discounted price ends up being smaller than the minimum price allowed in this region.
+    },
+  ],
+  "regionsVersion": { # The version of the available regions being used for the specified resource. # Output only. The version of the regions configuration that was used to generate the one-time product offer.
+    "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+  },
+  "state": "A String", # Output only. The current state of this offer. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.
+}
+
+ +
+ batchDelete(packageName, productId, purchaseOptionId, body=None, x__xgafv=None) + 
Deletes one or more one-time product offers.
+
+Args:
+  packageName: string, Required. The parent app (package name) of the offers to delete. Must be equal to the package_name field on all the OneTimeProductOffer resources. (required)
+  productId: string, Required. The product ID of the parent one-time product, if all offers to delete belong to the same product. If this request spans multiple one-time products, set this field to "-". (required)
+  purchaseOptionId: string, Required. The parent purchase option (ID) for which the offers should be deleted. May be specified as '-' to update offers from multiple purchase options. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for BatchDeleteOneTimeProductOffers.
+  "requests": [ # Required. A list of update requests of up to 100 elements. All requests must correspond to different offers.
+    { # Request message for deleting an one-time product offer.
+      "latencyTolerance": "A String", # Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.
+      "offerId": "A String", # Required. The unique offer ID of the offer to delete.
+      "packageName": "A String", # Required. The parent app (package name) of the offer to delete.
+      "productId": "A String", # Required. The parent one-time product (ID) of the offer to delete.
+      "purchaseOptionId": "A String", # Required. The parent purchase option (ID) of the offer to delete.
+    },
+  ],
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+
+ +
+ batchGet(packageName, productId, purchaseOptionId, body=None, x__xgafv=None) + 
Reads one or more one-time product offers.
+
+Args:
+  packageName: string, Required. The parent app (package name) of the updated offers. Must be equal to the package_name field on all the updated OneTimeProductOffer resources. (required)
+  productId: string, Required. The product ID of the parent one-time product, if all updated offers belong to the same product. If this request spans multiple one-time products, set this field to "-". (required)
+  purchaseOptionId: string, Required. The parent purchase option (ID) for which the offers should be updated. May be specified as '-' to update offers from multiple purchase options. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for the BatchGetOneTimeProductOffers endpoint.
+  "requests": [ # Required. A list of get requests of up to 100 elements. All requests must retrieve different offers.
+    { # Request message for GetOneTimeProductOffers.
+      "offerId": "A String", # Required. The unique offer ID of the offer to get.
+      "packageName": "A String", # Required. The parent app (package name) of the offer to get.
+      "productId": "A String", # Required. The parent one-time product (ID) of the offer to get.
+      "purchaseOptionId": "A String", # Required. The parent purchase option (ID) of the offer to get.
+    },
+  ],
+}
+
+  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 the BatchGetOneTimeProductOffers endpoint.
+  "oneTimeProductOffers": [ # The list of updated one-time product offers, in the same order as the request.
+    { # A single offer for a one-time product.
+      "discountedOffer": { # Configuration specific to discounted offers. # A discounted offer.
+        "endTime": "A String", # Time when the offer will stop being available.
+        "redemptionLimit": "A String", # Optional. The number of times this offer can be redeemed. If unset or set to 0, allows for unlimited offer redemptions. Otherwise must be a number between 1 and 50 inclusive.
+        "startTime": "A String", # Time when the offer will start being available.
+      },
+      "offerId": "A String", # Required. Immutable. The ID of this product offer. Must be unique within the purchase option. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.
+      "offerTags": [ # Optional. List of up to 20 custom tags specified for this offer, and returned to the app through the billing library.
+        { # Represents a custom tag specified for a product offer.
+          "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+        },
+      ],
+      "packageName": "A String", # Required. Immutable. The package name of the app the parent product belongs to.
+      "preOrderOffer": { # Configuration specific to pre-order offers. # A pre-order offer.
+        "endTime": "A String", # Required. Time when the pre-order will stop being available.
+        "priceChangeBehavior": "A String", # Required. Immutable. Specifies how price changes affect pre-existing pre-orders.
+        "releaseTime": "A String", # Required. Time on which the product associated with the pre-order will be released and the pre-order orders fulfilled.
+        "startTime": "A String", # Required. Time when the pre-order will start being available.
+      },
+      "productId": "A String", # Required. Immutable. The ID of the parent product this offer belongs to.
+      "purchaseOptionId": "A String", # Required. Immutable. The ID of the purchase option to which this offer is an extension.
+      "regionalPricingAndAvailabilityConfigs": [ # Set of regional pricing and availability information for this offer. Must not have duplicate entries with the same region_code.
+        { # Regional pricing and availability configuration for a one-time product offer.
+          "absoluteDiscount": { # Represents an amount of money with its currency type. # The absolute value of the discount that is subtracted from the purchase option price. It should be between 0 and the purchase option price.
+            "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+            "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+            "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+          },
+          "availability": "A String", # Required. The availability for this region.
+          "noOverride": { # Options for one-time product offers without a regional price override. # The price defined in the purchase option for this region will be used.
+          },
+          "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., "US".
+          "relativeDiscount": 3.14, # The fraction of the purchase option price that the user pays for this offer. For example, if the purchase option price for this region is $12, then a 50% discount would correspond to a price of $6. The discount must be specified as a fraction strictly larger than 0 and strictly smaller than 1. The resulting price will be rounded to the nearest billable unit (e.g. cents for USD). The relative discount is considered invalid if the discounted price ends up being smaller than the minimum price allowed in this region.
+        },
+      ],
+      "regionsVersion": { # The version of the available regions being used for the specified resource. # Output only. The version of the regions configuration that was used to generate the one-time product offer.
+        "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+      },
+      "state": "A String", # Output only. The current state of this offer. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.
+    },
+  ],
+}
+
+ +
+ batchUpdate(packageName, productId, purchaseOptionId, body=None, x__xgafv=None) + 
Creates or updates one or more one-time product offers.
+
+Args:
+  packageName: string, Required. The parent app (package name) of the updated offers. Must be equal to the package_name field on all the updated OneTimeProductOffer resources. (required)
+  productId: string, Required. The product ID of the parent one-time product, if all updated offers belong to the same product. If this request spans multiple one-time products, set this field to "-". (required)
+  purchaseOptionId: string, Required. The parent purchase option (ID) for which the offers should be updated. May be specified as '-' to update offers from multiple purchase options. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for BatchUpdateOneTimeProductOffers.
+  "requests": [ # Required. A list of update requests of up to 100 elements. All requests must update different offers.
+    { # Request message for UpdateOneTimeProductOffer.
+      "allowMissing": True or False, # Optional. If set to true, and the offer with the given package_name, product_id, purchase_option_id and offer_id doesn't exist, an offer will be created. If a new offer is created, the update_mask is ignored.
+      "latencyTolerance": "A String", # Optional. The latency tolerance for the propagation of this offer update. Defaults to latency-sensitive.
+      "oneTimeProductOffer": { # A single offer for a one-time product. # Required. The one-time product offer to update.
+        "discountedOffer": { # Configuration specific to discounted offers. # A discounted offer.
+          "endTime": "A String", # Time when the offer will stop being available.
+          "redemptionLimit": "A String", # Optional. The number of times this offer can be redeemed. If unset or set to 0, allows for unlimited offer redemptions. Otherwise must be a number between 1 and 50 inclusive.
+          "startTime": "A String", # Time when the offer will start being available.
+        },
+        "offerId": "A String", # Required. Immutable. The ID of this product offer. Must be unique within the purchase option. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.
+        "offerTags": [ # Optional. List of up to 20 custom tags specified for this offer, and returned to the app through the billing library.
+          { # Represents a custom tag specified for a product offer.
+            "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+          },
+        ],
+        "packageName": "A String", # Required. Immutable. The package name of the app the parent product belongs to.
+        "preOrderOffer": { # Configuration specific to pre-order offers. # A pre-order offer.
+          "endTime": "A String", # Required. Time when the pre-order will stop being available.
+          "priceChangeBehavior": "A String", # Required. Immutable. Specifies how price changes affect pre-existing pre-orders.
+          "releaseTime": "A String", # Required. Time on which the product associated with the pre-order will be released and the pre-order orders fulfilled.
+          "startTime": "A String", # Required. Time when the pre-order will start being available.
+        },
+        "productId": "A String", # Required. Immutable. The ID of the parent product this offer belongs to.
+        "purchaseOptionId": "A String", # Required. Immutable. The ID of the purchase option to which this offer is an extension.
+        "regionalPricingAndAvailabilityConfigs": [ # Set of regional pricing and availability information for this offer. Must not have duplicate entries with the same region_code.
+          { # Regional pricing and availability configuration for a one-time product offer.
+            "absoluteDiscount": { # Represents an amount of money with its currency type. # The absolute value of the discount that is subtracted from the purchase option price. It should be between 0 and the purchase option price.
+              "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+              "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+              "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+            },
+            "availability": "A String", # Required. The availability for this region.
+            "noOverride": { # Options for one-time product offers without a regional price override. # The price defined in the purchase option for this region will be used.
+            },
+            "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., "US".
+            "relativeDiscount": 3.14, # The fraction of the purchase option price that the user pays for this offer. For example, if the purchase option price for this region is $12, then a 50% discount would correspond to a price of $6. The discount must be specified as a fraction strictly larger than 0 and strictly smaller than 1. The resulting price will be rounded to the nearest billable unit (e.g. cents for USD). The relative discount is considered invalid if the discounted price ends up being smaller than the minimum price allowed in this region.
+          },
+        ],
+        "regionsVersion": { # The version of the available regions being used for the specified resource. # Output only. The version of the regions configuration that was used to generate the one-time product offer.
+          "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+        },
+        "state": "A String", # Output only. The current state of this offer. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.
+      },
+      "regionsVersion": { # The version of the available regions being used for the specified resource. # Required. The version of the available regions being used for the offer.
+        "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+      },
+      "updateMask": "A String", # Required. The list of fields to be updated.
+    },
+  ],
+}
+
+  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 BatchUpdateOneTimeProductOffers.
+  "oneTimeProductOffers": [ # The list of updated one-time product offers, in the same order as the request.
+    { # A single offer for a one-time product.
+      "discountedOffer": { # Configuration specific to discounted offers. # A discounted offer.
+        "endTime": "A String", # Time when the offer will stop being available.
+        "redemptionLimit": "A String", # Optional. The number of times this offer can be redeemed. If unset or set to 0, allows for unlimited offer redemptions. Otherwise must be a number between 1 and 50 inclusive.
+        "startTime": "A String", # Time when the offer will start being available.
+      },
+      "offerId": "A String", # Required. Immutable. The ID of this product offer. Must be unique within the purchase option. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.
+      "offerTags": [ # Optional. List of up to 20 custom tags specified for this offer, and returned to the app through the billing library.
+        { # Represents a custom tag specified for a product offer.
+          "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+        },
+      ],
+      "packageName": "A String", # Required. Immutable. The package name of the app the parent product belongs to.
+      "preOrderOffer": { # Configuration specific to pre-order offers. # A pre-order offer.
+        "endTime": "A String", # Required. Time when the pre-order will stop being available.
+        "priceChangeBehavior": "A String", # Required. Immutable. Specifies how price changes affect pre-existing pre-orders.
+        "releaseTime": "A String", # Required. Time on which the product associated with the pre-order will be released and the pre-order orders fulfilled.
+        "startTime": "A String", # Required. Time when the pre-order will start being available.
+      },
+      "productId": "A String", # Required. Immutable. The ID of the parent product this offer belongs to.
+      "purchaseOptionId": "A String", # Required. Immutable. The ID of the purchase option to which this offer is an extension.
+      "regionalPricingAndAvailabilityConfigs": [ # Set of regional pricing and availability information for this offer. Must not have duplicate entries with the same region_code.
+        { # Regional pricing and availability configuration for a one-time product offer.
+          "absoluteDiscount": { # Represents an amount of money with its currency type. # The absolute value of the discount that is subtracted from the purchase option price. It should be between 0 and the purchase option price.
+            "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+            "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+            "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+          },
+          "availability": "A String", # Required. The availability for this region.
+          "noOverride": { # Options for one-time product offers without a regional price override. # The price defined in the purchase option for this region will be used.
+          },
+          "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., "US".
+          "relativeDiscount": 3.14, # The fraction of the purchase option price that the user pays for this offer. For example, if the purchase option price for this region is $12, then a 50% discount would correspond to a price of $6. The discount must be specified as a fraction strictly larger than 0 and strictly smaller than 1. The resulting price will be rounded to the nearest billable unit (e.g. cents for USD). The relative discount is considered invalid if the discounted price ends up being smaller than the minimum price allowed in this region.
+        },
+      ],
+      "regionsVersion": { # The version of the available regions being used for the specified resource. # Output only. The version of the regions configuration that was used to generate the one-time product offer.
+        "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+      },
+      "state": "A String", # Output only. The current state of this offer. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.
+    },
+  ],
+}
+
+ +
+ batchUpdateStates(packageName, productId, purchaseOptionId, body=None, x__xgafv=None) + 
Updates a batch of one-time product offer states.
+
+Args:
+  packageName: string, Required. The parent app (package name) of the updated one-time product offers. (required)
+  productId: string, Required. The product ID of the parent one-time product, if all updated offers belong to the same one-time product. If this batch update spans multiple one-time products, set this field to "-". (required)
+  purchaseOptionId: string, Required. The purchase option ID of the parent purchase option, if all updated offers belong to the same purchase option. If this batch update spans multiple purchase options, set this field to "-". (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for BatchUpdateOneTimeProductOfferStates.
+  "requests": [ # Required. The update request list of up to 100 elements. All requests must update different offers.
+    { # Request message to update the state of a one-time product offer.
+      "activateOneTimeProductOfferRequest": { # Request message for ActivateOneTimeProductOffer. # Activates an offer. Once activated, the offer is available to users, as long as its conditions are met.
+        "latencyTolerance": "A String", # Optional. The latency tolerance for the propagation of this update. Defaults to latency-sensitive.
+        "offerId": "A String", # Required. The offer ID of the offer to activate.
+        "packageName": "A String", # Required. The parent app (package name) of the offer to activate.
+        "productId": "A String", # Required. The parent one-time product (ID) of the offer to activate.
+        "purchaseOptionId": "A String", # Required. The parent purchase option (ID) of the offer to activate.
+      },
+      "cancelOneTimeProductOfferRequest": { # Request message for CancelOneTimeProductOffer. # Cancels an offer. Once cancelled, the offer is not available to users. Any pending orders related to this offer will be cancelled. This state transition is specific to pre-orders.
+        "latencyTolerance": "A String", # Optional. The latency tolerance for the propagation of this update. Defaults to latency-sensitive.
+        "offerId": "A String", # Required. The offer ID of the offer to cancel.
+        "packageName": "A String", # Required. The parent app (package name) of the offer to cancel.
+        "productId": "A String", # Required. The parent one-time product (ID) of the offer to cancel.
+        "purchaseOptionId": "A String", # Required. The parent purchase option (ID) of the offer to cancel.
+      },
+      "deactivateOneTimeProductOfferRequest": { # Request message for DeactivateOneTimeProductOffer. # Deactivates an offer. Once deactivated, the offer is no longer available to users. This state transition is specific to discounted offers.
+        "latencyTolerance": "A String", # Optional. The latency tolerance for the propagation of this update. Defaults to latency-sensitive.
+        "offerId": "A String", # Required. The offer ID of the offer to deactivate.
+        "packageName": "A String", # Required. The parent app (package name) of the offer to deactivate.
+        "productId": "A String", # Required. The parent one-time product (ID) of the offer to deactivate.
+        "purchaseOptionId": "A String", # Required. The parent purchase option (ID) of the offer to deactivate.
+      },
+    },
+  ],
+}
+
+  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 BatchUpdateOneTimeProductOfferStates.
+  "oneTimeProductOffers": [ # The updated one-time product offers list, in the same order as the request.
+    { # A single offer for a one-time product.
+      "discountedOffer": { # Configuration specific to discounted offers. # A discounted offer.
+        "endTime": "A String", # Time when the offer will stop being available.
+        "redemptionLimit": "A String", # Optional. The number of times this offer can be redeemed. If unset or set to 0, allows for unlimited offer redemptions. Otherwise must be a number between 1 and 50 inclusive.
+        "startTime": "A String", # Time when the offer will start being available.
+      },
+      "offerId": "A String", # Required. Immutable. The ID of this product offer. Must be unique within the purchase option. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.
+      "offerTags": [ # Optional. List of up to 20 custom tags specified for this offer, and returned to the app through the billing library.
+        { # Represents a custom tag specified for a product offer.
+          "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+        },
+      ],
+      "packageName": "A String", # Required. Immutable. The package name of the app the parent product belongs to.
+      "preOrderOffer": { # Configuration specific to pre-order offers. # A pre-order offer.
+        "endTime": "A String", # Required. Time when the pre-order will stop being available.
+        "priceChangeBehavior": "A String", # Required. Immutable. Specifies how price changes affect pre-existing pre-orders.
+        "releaseTime": "A String", # Required. Time on which the product associated with the pre-order will be released and the pre-order orders fulfilled.
+        "startTime": "A String", # Required. Time when the pre-order will start being available.
+      },
+      "productId": "A String", # Required. Immutable. The ID of the parent product this offer belongs to.
+      "purchaseOptionId": "A String", # Required. Immutable. The ID of the purchase option to which this offer is an extension.
+      "regionalPricingAndAvailabilityConfigs": [ # Set of regional pricing and availability information for this offer. Must not have duplicate entries with the same region_code.
+        { # Regional pricing and availability configuration for a one-time product offer.
+          "absoluteDiscount": { # Represents an amount of money with its currency type. # The absolute value of the discount that is subtracted from the purchase option price. It should be between 0 and the purchase option price.
+            "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+            "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+            "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+          },
+          "availability": "A String", # Required. The availability for this region.
+          "noOverride": { # Options for one-time product offers without a regional price override. # The price defined in the purchase option for this region will be used.
+          },
+          "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., "US".
+          "relativeDiscount": 3.14, # The fraction of the purchase option price that the user pays for this offer. For example, if the purchase option price for this region is $12, then a 50% discount would correspond to a price of $6. The discount must be specified as a fraction strictly larger than 0 and strictly smaller than 1. The resulting price will be rounded to the nearest billable unit (e.g. cents for USD). The relative discount is considered invalid if the discounted price ends up being smaller than the minimum price allowed in this region.
+        },
+      ],
+      "regionsVersion": { # The version of the available regions being used for the specified resource. # Output only. The version of the regions configuration that was used to generate the one-time product offer.
+        "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+      },
+      "state": "A String", # Output only. The current state of this offer. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.
+    },
+  ],
+}
+
+ +
+ cancel(packageName, productId, purchaseOptionId, offerId, body=None, x__xgafv=None) + 
Cancels a one-time product offer.
+
+Args:
+  packageName: string, Required. The parent app (package name) of the offer to cancel. (required)
+  productId: string, Required. The parent one-time product (ID) of the offer to cancel. (required)
+  purchaseOptionId: string, Required. The parent purchase option (ID) of the offer to cancel. (required)
+  offerId: string, Required. The offer ID of the offer to cancel. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for CancelOneTimeProductOffer.
+  "latencyTolerance": "A String", # Optional. The latency tolerance for the propagation of this update. Defaults to latency-sensitive.
+  "offerId": "A String", # Required. The offer ID of the offer to cancel.
+  "packageName": "A String", # Required. The parent app (package name) of the offer to cancel.
+  "productId": "A String", # Required. The parent one-time product (ID) of the offer to cancel.
+  "purchaseOptionId": "A String", # Required. The parent purchase option (ID) of the offer to cancel.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A single offer for a one-time product.
+  "discountedOffer": { # Configuration specific to discounted offers. # A discounted offer.
+    "endTime": "A String", # Time when the offer will stop being available.
+    "redemptionLimit": "A String", # Optional. The number of times this offer can be redeemed. If unset or set to 0, allows for unlimited offer redemptions. Otherwise must be a number between 1 and 50 inclusive.
+    "startTime": "A String", # Time when the offer will start being available.
+  },
+  "offerId": "A String", # Required. Immutable. The ID of this product offer. Must be unique within the purchase option. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.
+  "offerTags": [ # Optional. List of up to 20 custom tags specified for this offer, and returned to the app through the billing library.
+    { # Represents a custom tag specified for a product offer.
+      "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+    },
+  ],
+  "packageName": "A String", # Required. Immutable. The package name of the app the parent product belongs to.
+  "preOrderOffer": { # Configuration specific to pre-order offers. # A pre-order offer.
+    "endTime": "A String", # Required. Time when the pre-order will stop being available.
+    "priceChangeBehavior": "A String", # Required. Immutable. Specifies how price changes affect pre-existing pre-orders.
+    "releaseTime": "A String", # Required. Time on which the product associated with the pre-order will be released and the pre-order orders fulfilled.
+    "startTime": "A String", # Required. Time when the pre-order will start being available.
+  },
+  "productId": "A String", # Required. Immutable. The ID of the parent product this offer belongs to.
+  "purchaseOptionId": "A String", # Required. Immutable. The ID of the purchase option to which this offer is an extension.
+  "regionalPricingAndAvailabilityConfigs": [ # Set of regional pricing and availability information for this offer. Must not have duplicate entries with the same region_code.
+    { # Regional pricing and availability configuration for a one-time product offer.
+      "absoluteDiscount": { # Represents an amount of money with its currency type. # The absolute value of the discount that is subtracted from the purchase option price. It should be between 0 and the purchase option price.
+        "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+        "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+        "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+      },
+      "availability": "A String", # Required. The availability for this region.
+      "noOverride": { # Options for one-time product offers without a regional price override. # The price defined in the purchase option for this region will be used.
+      },
+      "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., "US".
+      "relativeDiscount": 3.14, # The fraction of the purchase option price that the user pays for this offer. For example, if the purchase option price for this region is $12, then a 50% discount would correspond to a price of $6. The discount must be specified as a fraction strictly larger than 0 and strictly smaller than 1. The resulting price will be rounded to the nearest billable unit (e.g. cents for USD). The relative discount is considered invalid if the discounted price ends up being smaller than the minimum price allowed in this region.
+    },
+  ],
+  "regionsVersion": { # The version of the available regions being used for the specified resource. # Output only. The version of the regions configuration that was used to generate the one-time product offer.
+    "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+  },
+  "state": "A String", # Output only. The current state of this offer. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.
+}
+
+ +
+ close() + 
Close httplib2 connections.
+
+ +
+ deactivate(packageName, productId, purchaseOptionId, offerId, body=None, x__xgafv=None) + 
Deactivates a one-time product offer.
+
+Args:
+  packageName: string, Required. The parent app (package name) of the offer to deactivate. (required)
+  productId: string, Required. The parent one-time product (ID) of the offer to deactivate. (required)
+  purchaseOptionId: string, Required. The parent purchase option (ID) of the offer to deactivate. (required)
+  offerId: string, Required. The offer ID of the offer to deactivate. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for DeactivateOneTimeProductOffer.
+  "latencyTolerance": "A String", # Optional. The latency tolerance for the propagation of this update. Defaults to latency-sensitive.
+  "offerId": "A String", # Required. The offer ID of the offer to deactivate.
+  "packageName": "A String", # Required. The parent app (package name) of the offer to deactivate.
+  "productId": "A String", # Required. The parent one-time product (ID) of the offer to deactivate.
+  "purchaseOptionId": "A String", # Required. The parent purchase option (ID) of the offer to deactivate.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # A single offer for a one-time product.
+  "discountedOffer": { # Configuration specific to discounted offers. # A discounted offer.
+    "endTime": "A String", # Time when the offer will stop being available.
+    "redemptionLimit": "A String", # Optional. The number of times this offer can be redeemed. If unset or set to 0, allows for unlimited offer redemptions. Otherwise must be a number between 1 and 50 inclusive.
+    "startTime": "A String", # Time when the offer will start being available.
+  },
+  "offerId": "A String", # Required. Immutable. The ID of this product offer. Must be unique within the purchase option. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.
+  "offerTags": [ # Optional. List of up to 20 custom tags specified for this offer, and returned to the app through the billing library.
+    { # Represents a custom tag specified for a product offer.
+      "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+    },
+  ],
+  "packageName": "A String", # Required. Immutable. The package name of the app the parent product belongs to.
+  "preOrderOffer": { # Configuration specific to pre-order offers. # A pre-order offer.
+    "endTime": "A String", # Required. Time when the pre-order will stop being available.
+    "priceChangeBehavior": "A String", # Required. Immutable. Specifies how price changes affect pre-existing pre-orders.
+    "releaseTime": "A String", # Required. Time on which the product associated with the pre-order will be released and the pre-order orders fulfilled.
+    "startTime": "A String", # Required. Time when the pre-order will start being available.
+  },
+  "productId": "A String", # Required. Immutable. The ID of the parent product this offer belongs to.
+  "purchaseOptionId": "A String", # Required. Immutable. The ID of the purchase option to which this offer is an extension.
+  "regionalPricingAndAvailabilityConfigs": [ # Set of regional pricing and availability information for this offer. Must not have duplicate entries with the same region_code.
+    { # Regional pricing and availability configuration for a one-time product offer.
+      "absoluteDiscount": { # Represents an amount of money with its currency type. # The absolute value of the discount that is subtracted from the purchase option price. It should be between 0 and the purchase option price.
+        "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+        "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+        "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+      },
+      "availability": "A String", # Required. The availability for this region.
+      "noOverride": { # Options for one-time product offers without a regional price override. # The price defined in the purchase option for this region will be used.
+      },
+      "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., "US".
+      "relativeDiscount": 3.14, # The fraction of the purchase option price that the user pays for this offer. For example, if the purchase option price for this region is $12, then a 50% discount would correspond to a price of $6. The discount must be specified as a fraction strictly larger than 0 and strictly smaller than 1. The resulting price will be rounded to the nearest billable unit (e.g. cents for USD). The relative discount is considered invalid if the discounted price ends up being smaller than the minimum price allowed in this region.
+    },
+  ],
+  "regionsVersion": { # The version of the available regions being used for the specified resource. # Output only. The version of the regions configuration that was used to generate the one-time product offer.
+    "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+  },
+  "state": "A String", # Output only. The current state of this offer. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.
+}
+
+ +
+ list(packageName, productId, purchaseOptionId, pageSize=None, pageToken=None, x__xgafv=None) + 
Lists all offers under a given app, product, or purchase option.
+
+Args:
+  packageName: string, Required. The parent app (package name) for which the offers should be read. (required)
+  productId: string, Required. The parent one-time product (ID) for which the offers should be read. May be specified as '-' to read all offers under an app. (required)
+  purchaseOptionId: string, Required. The parent purchase option (ID) for which the offers should be read. May be specified as '-' to read all offers under a one-time product or an app. Must be specified as '-' if product_id is specified as '-'. (required)
+  pageSize: integer, Optional. The maximum number of offers to return. The service may return fewer than this value. If unspecified, at most 50 offers will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
+  pageToken: string, Optional. A page token, received from a previous `ListOneTimeProductsOffers` call. Provide this to retrieve the subsequent page. When paginating, product_id, package_name and purchase_option_id provided to `ListOneTimeProductsOffersRequest` must match the call that provided the page token.
+  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 ListOneTimeProductOffers.
+  "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+  "oneTimeProductOffers": [ # The one_time_product offers from the specified request.
+    { # A single offer for a one-time product.
+      "discountedOffer": { # Configuration specific to discounted offers. # A discounted offer.
+        "endTime": "A String", # Time when the offer will stop being available.
+        "redemptionLimit": "A String", # Optional. The number of times this offer can be redeemed. If unset or set to 0, allows for unlimited offer redemptions. Otherwise must be a number between 1 and 50 inclusive.
+        "startTime": "A String", # Time when the offer will start being available.
+      },
+      "offerId": "A String", # Required. Immutable. The ID of this product offer. Must be unique within the purchase option. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.
+      "offerTags": [ # Optional. List of up to 20 custom tags specified for this offer, and returned to the app through the billing library.
+        { # Represents a custom tag specified for a product offer.
+          "tag": "A String", # Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.
+        },
+      ],
+      "packageName": "A String", # Required. Immutable. The package name of the app the parent product belongs to.
+      "preOrderOffer": { # Configuration specific to pre-order offers. # A pre-order offer.
+        "endTime": "A String", # Required. Time when the pre-order will stop being available.
+        "priceChangeBehavior": "A String", # Required. Immutable. Specifies how price changes affect pre-existing pre-orders.
+        "releaseTime": "A String", # Required. Time on which the product associated with the pre-order will be released and the pre-order orders fulfilled.
+        "startTime": "A String", # Required. Time when the pre-order will start being available.
+      },
+      "productId": "A String", # Required. Immutable. The ID of the parent product this offer belongs to.
+      "purchaseOptionId": "A String", # Required. Immutable. The ID of the purchase option to which this offer is an extension.
+      "regionalPricingAndAvailabilityConfigs": [ # Set of regional pricing and availability information for this offer. Must not have duplicate entries with the same region_code.
+        { # Regional pricing and availability configuration for a one-time product offer.
+          "absoluteDiscount": { # Represents an amount of money with its currency type. # The absolute value of the discount that is subtracted from the purchase option price. It should be between 0 and the purchase option price.
+            "currencyCode": "A String", # The three-letter currency code defined in ISO 4217.
+            "nanos": 42, # Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
+            "units": "A String", # The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
+          },
+          "availability": "A String", # Required. The availability for this region.
+          "noOverride": { # Options for one-time product offers without a regional price override. # The price defined in the purchase option for this region will be used.
+          },
+          "regionCode": "A String", # Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., "US".
+          "relativeDiscount": 3.14, # The fraction of the purchase option price that the user pays for this offer. For example, if the purchase option price for this region is $12, then a 50% discount would correspond to a price of $6. The discount must be specified as a fraction strictly larger than 0 and strictly smaller than 1. The resulting price will be rounded to the nearest billable unit (e.g. cents for USD). The relative discount is considered invalid if the discounted price ends up being smaller than the minimum price allowed in this region.
+        },
+      ],
+      "regionsVersion": { # The version of the available regions being used for the specified resource. # Output only. The version of the regions configuration that was used to generate the one-time product offer.
+        "version": "A String", # Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.
+      },
+      "state": "A String", # Output only. The current state of this offer. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.
+    },
+  ],
+}
+
+ +
+ 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.
+
+
+ + \ No newline at end of file diff --git a/googleapiclient/discovery_cache/documents/androidpublisher.v3.json b/googleapiclient/discovery_cache/documents/androidpublisher.v3.json index 9e0c8c47149..9e728fb04d8 100644 --- a/googleapiclient/discovery_cache/documents/androidpublisher.v3.json +++ b/googleapiclient/discovery_cache/documents/androidpublisher.v3.json @@ -2791,254 +2791,215 @@ } }, "resources": { -"subscriptions": { +"onetimeproducts": { "methods": { -"archive": { -"deprecated": true, -"description": "Deprecated: subscription archiving is not supported.", -"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}:archive", +"batchDelete": { +"description": "Deletes one or more one-time products.", +"flatPath": "androidpublisher/v3/applications/{packageName}/oneTimeProducts:batchDelete", "httpMethod": "POST", -"id": "androidpublisher.monetization.subscriptions.archive", +"id": "androidpublisher.monetization.onetimeproducts.batchDelete", "parameterOrder": [ -"packageName", -"productId" +"packageName" ], "parameters": { "packageName": { -"description": "Required. The parent app (package name) of the app of the subscription to delete.", -"location": "path", -"required": true, -"type": "string" -}, -"productId": { -"description": "Required. The unique product ID of the subscription to delete.", +"description": "Required. The parent app (package name) for which the one-time products should be deleted. Must be equal to the package_name field on all the OneTimeProduct resources.", "location": "path", "required": true, "type": "string" } }, -"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}:archive", +"path": "androidpublisher/v3/applications/{packageName}/oneTimeProducts:batchDelete", "request": { -"$ref": "ArchiveSubscriptionRequest" -}, -"response": { -"$ref": "Subscription" +"$ref": "BatchDeleteOneTimeProductsRequest" }, "scopes": [ "https://www.googleapis.com/auth/androidpublisher" ] }, "batchGet": { -"description": "Reads one or more subscriptions.", -"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions:batchGet", +"description": "Reads one or more one-time products.", +"flatPath": "androidpublisher/v3/applications/{packageName}/oneTimeProducts:batchGet", "httpMethod": "GET", -"id": "androidpublisher.monetization.subscriptions.batchGet", +"id": "androidpublisher.monetization.onetimeproducts.batchGet", "parameterOrder": [ "packageName" ], "parameters": { "packageName": { -"description": "Required. The parent app (package name) for which the subscriptions should be retrieved. Must be equal to the package_name field on all the requests.", +"description": "Required. The parent app (package name) for which the products should be retrieved. Must be equal to the package_name field on all requests.", "location": "path", "required": true, "type": "string" }, "productIds": { -"description": "Required. A list of up to 100 subscription product IDs to retrieve. All the IDs must be different.", +"description": "Required. A list of up to 100 product IDs to retrieve. All IDs must be different.", "location": "query", "repeated": true, "type": "string" } }, -"path": "androidpublisher/v3/applications/{packageName}/subscriptions:batchGet", +"path": "androidpublisher/v3/applications/{packageName}/oneTimeProducts:batchGet", "response": { -"$ref": "BatchGetSubscriptionsResponse" +"$ref": "BatchGetOneTimeProductsResponse" }, "scopes": [ "https://www.googleapis.com/auth/androidpublisher" ] }, "batchUpdate": { -"description": "Updates a batch of subscriptions. Set the latencyTolerance field on nested requests to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT to achieve maximum update throughput.", -"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions:batchUpdate", -"httpMethod": "POST", -"id": "androidpublisher.monetization.subscriptions.batchUpdate", -"parameterOrder": [ -"packageName" -], -"parameters": { -"packageName": { -"description": "Required. The parent app (package name) for which the subscriptions should be updated. Must be equal to the package_name field on all the Subscription resources.", -"location": "path", -"required": true, -"type": "string" -} -}, -"path": "androidpublisher/v3/applications/{packageName}/subscriptions:batchUpdate", -"request": { -"$ref": "BatchUpdateSubscriptionsRequest" -}, -"response": { -"$ref": "BatchUpdateSubscriptionsResponse" -}, -"scopes": [ -"https://www.googleapis.com/auth/androidpublisher" -] -}, -"create": { -"description": "Creates a new subscription. Newly added base plans will remain in draft state until activated.", -"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions", +"description": "Creates or updates one or more one-time products.", +"flatPath": "androidpublisher/v3/applications/{packageName}/oneTimeProducts:batchUpdate", "httpMethod": "POST", -"id": "androidpublisher.monetization.subscriptions.create", +"id": "androidpublisher.monetization.onetimeproducts.batchUpdate", "parameterOrder": [ "packageName" ], "parameters": { "packageName": { -"description": "Required. The parent app (package name) for which the subscription should be created. Must be equal to the package_name field on the Subscription resource.", +"description": "Required. The parent app (package name) for which the one-time products should be updated. Must be equal to the package_name field on all the OneTimeProduct resources.", "location": "path", "required": true, "type": "string" -}, -"productId": { -"description": "Required. The ID to use for the subscription. For the requirements on this format, see the documentation of the product_id field on the Subscription resource.", -"location": "query", -"type": "string" -}, -"regionsVersion.version": { -"description": "Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.", -"location": "query", -"type": "string" } }, -"path": "androidpublisher/v3/applications/{packageName}/subscriptions", +"path": "androidpublisher/v3/applications/{packageName}/oneTimeProducts:batchUpdate", "request": { -"$ref": "Subscription" +"$ref": "BatchUpdateOneTimeProductsRequest" }, "response": { -"$ref": "Subscription" +"$ref": "BatchUpdateOneTimeProductsResponse" }, "scopes": [ "https://www.googleapis.com/auth/androidpublisher" ] }, "delete": { -"description": "Deletes a subscription. A subscription can only be deleted if it has never had a base plan published.", -"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}", +"description": "Deletes a one-time product.", +"flatPath": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}", "httpMethod": "DELETE", -"id": "androidpublisher.monetization.subscriptions.delete", +"id": "androidpublisher.monetization.onetimeproducts.delete", "parameterOrder": [ "packageName", "productId" ], "parameters": { +"latencyTolerance": { +"description": "Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.", +"enum": [ +"PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT" +], +"enumDescriptions": [ +"Defaults to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE.", +"The update will propagate to clients within several minutes on average and up to a few hours in rare cases. Throughput is limited to 7,200 updates per app per hour.", +"The update will propagate to clients within 24 hours. Supports high throughput of up to 720,000 updates per app per hour using batch modification methods." +], +"location": "query", +"type": "string" +}, "packageName": { -"description": "Required. The parent app (package name) of the app of the subscription to delete.", +"description": "Required. The parent app (package name) of the one-time product to delete.", "location": "path", "required": true, "type": "string" }, "productId": { -"description": "Required. The unique product ID of the subscription to delete.", +"description": "Required. The one-time product ID of the one-time product to delete.", "location": "path", "required": true, "type": "string" } }, -"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}", +"path": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}", "scopes": [ "https://www.googleapis.com/auth/androidpublisher" ] }, "get": { -"description": "Reads a single subscription.", -"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}", +"description": "Reads a single one-time product.", +"flatPath": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}", "httpMethod": "GET", -"id": "androidpublisher.monetization.subscriptions.get", +"id": "androidpublisher.monetization.onetimeproducts.get", "parameterOrder": [ "packageName", "productId" ], "parameters": { "packageName": { -"description": "Required. The parent app (package name) of the subscription to get.", +"description": "Required. The parent app (package name) of the product to retrieve.", "location": "path", "required": true, "type": "string" }, "productId": { -"description": "Required. The unique product ID of the subscription to get.", +"description": "Required. The product ID of the product to retrieve.", "location": "path", "required": true, "type": "string" } }, -"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}", +"path": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}", "response": { -"$ref": "Subscription" +"$ref": "OneTimeProduct" }, "scopes": [ "https://www.googleapis.com/auth/androidpublisher" ] }, "list": { -"description": "Lists all subscriptions under a given app.", -"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions", +"description": "Lists all one-time products under a given app.", +"flatPath": "androidpublisher/v3/applications/{packageName}/oneTimeProducts", "httpMethod": "GET", -"id": "androidpublisher.monetization.subscriptions.list", +"id": "androidpublisher.monetization.onetimeproducts.list", "parameterOrder": [ "packageName" ], "parameters": { "packageName": { -"description": "Required. The parent app (package name) for which the subscriptions should be read.", +"description": "Required. The parent app (package name) for which the one-time product should be read.", "location": "path", "required": true, "type": "string" }, "pageSize": { -"description": "The maximum number of subscriptions to return. The service may return fewer than this value. If unspecified, at most 50 subscriptions will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", +"description": "Optional. The maximum number of one-time product to return. The service may return fewer than this value. If unspecified, at most 50 one-time products will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", "format": "int32", "location": "query", "type": "integer" }, "pageToken": { -"description": "A page token, received from a previous `ListSubscriptions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListSubscriptions` must match the call that provided the page token.", +"description": "Optional. A page token, received from a previous `ListOneTimeProducts` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListOneTimeProducts` must match the call that provided the page token.", "location": "query", "type": "string" -}, -"showArchived": { -"deprecated": true, -"description": "Deprecated: subscription archiving is not supported.", -"location": "query", -"type": "boolean" } }, -"path": "androidpublisher/v3/applications/{packageName}/subscriptions", +"path": "androidpublisher/v3/applications/{packageName}/oneTimeProducts", "response": { -"$ref": "ListSubscriptionsResponse" +"$ref": "ListOneTimeProductsResponse" }, "scopes": [ "https://www.googleapis.com/auth/androidpublisher" ] }, "patch": { -"description": "Updates an existing subscription.", -"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}", +"description": "Creates or updates a one-time product.", +"flatPath": "androidpublisher/v3/applications/{packageName}/onetimeproducts/{productId}", "httpMethod": "PATCH", -"id": "androidpublisher.monetization.subscriptions.patch", +"id": "androidpublisher.monetization.onetimeproducts.patch", "parameterOrder": [ "packageName", "productId" ], "parameters": { "allowMissing": { -"description": "Optional. If set to true, and the subscription with the given package_name and product_id doesn't exist, the subscription will be created. If a new subscription is created, update_mask is ignored.", +"description": "Optional. If set to true, and the one-time product with the given package_name and product_id doesn't exist, the one-time product will be created. If a new one-time product is created, update_mask is ignored.", "location": "query", "type": "boolean" }, "latencyTolerance": { -"description": "Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.", +"description": "Optional. The latency tolerance for the propagation of this product upsert. Defaults to latency-sensitive.", "enum": [ "PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED", "PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE", @@ -3053,13 +3014,13 @@ "type": "string" }, "packageName": { -"description": "Immutable. Package name of the parent app.", +"description": "Required. Immutable. Package name of the parent app.", "location": "path", "required": true, "type": "string" }, "productId": { -"description": "Immutable. Unique product ID of the product. Unique within the parent app. Product IDs must be composed of lower-case letters (a-z), numbers (0-9), underscores (_) and dots (.). It must start with a lower-case letter or number, and be between 1 and 40 (inclusive) characters in length.", +"description": "Required. Immutable. Unique product ID of the product. Unique within the parent app. Product IDs must start with a number or lowercase letter, and can contain numbers (0-9), lowercase letters (a-z), underscores (_), and periods (.).", "location": "path", "required": true, "type": "string" @@ -3076,12 +3037,12 @@ "type": "string" } }, -"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}", +"path": "androidpublisher/v3/applications/{packageName}/onetimeproducts/{productId}", "request": { -"$ref": "Subscription" +"$ref": "OneTimeProduct" }, "response": { -"$ref": "Subscription" +"$ref": "OneTimeProduct" }, "scopes": [ "https://www.googleapis.com/auth/androidpublisher" @@ -3089,248 +3050,977 @@ } }, "resources": { -"basePlans": { +"purchaseOptions": { "methods": { -"activate": { -"description": "Activates a base plan. Once activated, base plans will be available to new subscribers.", -"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:activate", +"batchDelete": { +"description": "Deletes purchase options across one or multiple one-time products. By default this operation will fail if there are any existing offers under the deleted purchase options. Use the force parameter to override the default behavior.", +"flatPath": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions:batchDelete", "httpMethod": "POST", -"id": "androidpublisher.monetization.subscriptions.basePlans.activate", +"id": "androidpublisher.monetization.onetimeproducts.purchaseOptions.batchDelete", "parameterOrder": [ "packageName", -"productId", -"basePlanId" +"productId" ], "parameters": { -"basePlanId": { -"description": "Required. The unique base plan ID of the base plan to activate.", -"location": "path", -"required": true, -"type": "string" -}, "packageName": { -"description": "Required. The parent app (package name) of the base plan to activate.", +"description": "Required. The parent app (package name) of the purchase options to delete.", "location": "path", "required": true, "type": "string" }, "productId": { -"description": "Required. The parent subscription (ID) of the base plan to activate.", +"description": "Required. The product ID of the parent one-time product, if all purchase options to delete belong to the same one-time product. If this batch delete spans multiple one-time products, set this field to \"-\".", "location": "path", "required": true, "type": "string" } }, -"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:activate", +"path": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions:batchDelete", "request": { -"$ref": "ActivateBasePlanRequest" -}, -"response": { -"$ref": "Subscription" +"$ref": "BatchDeletePurchaseOptionsRequest" }, "scopes": [ "https://www.googleapis.com/auth/androidpublisher" ] }, -"batchMigratePrices": { -"description": "Batch variant of the MigrateBasePlanPrices endpoint. Set the latencyTolerance field on nested requests to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT to achieve maximum update throughput.", -"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchMigratePrices", +"batchUpdateStates": { +"description": "Activates or deactivates purchase options across one or multiple one-time products.", +"flatPath": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions:batchUpdateStates", "httpMethod": "POST", -"id": "androidpublisher.monetization.subscriptions.basePlans.batchMigratePrices", +"id": "androidpublisher.monetization.onetimeproducts.purchaseOptions.batchUpdateStates", "parameterOrder": [ "packageName", "productId" ], "parameters": { "packageName": { -"description": "Required. The parent app (package name) for which the subscriptions should be created or updated. Must be equal to the package_name field on all the Subscription resources.", +"description": "Required. The parent app (package name) of the updated purchase options.", "location": "path", "required": true, "type": "string" }, "productId": { -"description": "Required. The product ID of the parent subscription, if all updated offers belong to the same subscription. If this batch update spans multiple subscriptions, set this field to \"-\". Must be set.", +"description": "Required. The product ID of the parent one-time product, if all updated purchase options belong to the same one-time product. If this batch update spans multiple one-time products, set this field to \"-\".", "location": "path", "required": true, "type": "string" } }, -"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchMigratePrices", +"path": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions:batchUpdateStates", "request": { -"$ref": "BatchMigrateBasePlanPricesRequest" +"$ref": "BatchUpdatePurchaseOptionStatesRequest" }, "response": { -"$ref": "BatchMigrateBasePlanPricesResponse" +"$ref": "BatchUpdatePurchaseOptionStatesResponse" }, "scopes": [ "https://www.googleapis.com/auth/androidpublisher" ] +} }, -"batchUpdateStates": { -"description": "Activates or deactivates base plans across one or multiple subscriptions. Set the latencyTolerance field on nested requests to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT to achieve maximum update throughput.", -"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchUpdateStates", +"resources": { +"offers": { +"methods": { +"activate": { +"description": "Activates a one-time product offer.", +"flatPath": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers/{offerId}:activate", "httpMethod": "POST", -"id": "androidpublisher.monetization.subscriptions.basePlans.batchUpdateStates", +"id": "androidpublisher.monetization.onetimeproducts.purchaseOptions.offers.activate", "parameterOrder": [ "packageName", -"productId" +"productId", +"purchaseOptionId", +"offerId" ], "parameters": { +"offerId": { +"description": "Required. The offer ID of the offer to activate.", +"location": "path", +"required": true, +"type": "string" +}, "packageName": { -"description": "Required. The parent app (package name) of the updated base plans.", +"description": "Required. The parent app (package name) of the offer to activate.", "location": "path", "required": true, "type": "string" }, "productId": { -"description": "Required. The product ID of the parent subscription, if all updated base plans belong to the same subscription. If this batch update spans multiple subscriptions, set this field to \"-\". Must be set.", +"description": "Required. The parent one-time product (ID) of the offer to activate.", +"location": "path", +"required": true, +"type": "string" +}, +"purchaseOptionId": { +"description": "Required. The parent purchase option (ID) of the offer to activate.", "location": "path", "required": true, "type": "string" } }, -"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchUpdateStates", +"path": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers/{offerId}:activate", "request": { -"$ref": "BatchUpdateBasePlanStatesRequest" +"$ref": "ActivateOneTimeProductOfferRequest" }, "response": { -"$ref": "BatchUpdateBasePlanStatesResponse" +"$ref": "OneTimeProductOffer" }, "scopes": [ "https://www.googleapis.com/auth/androidpublisher" ] }, -"deactivate": { -"description": "Deactivates a base plan. Once deactivated, the base plan will become unavailable to new subscribers, but existing subscribers will maintain their subscription", -"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:deactivate", +"batchDelete": { +"description": "Deletes one or more one-time product offers.", +"flatPath": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchDelete", "httpMethod": "POST", -"id": "androidpublisher.monetization.subscriptions.basePlans.deactivate", +"id": "androidpublisher.monetization.onetimeproducts.purchaseOptions.offers.batchDelete", "parameterOrder": [ "packageName", "productId", -"basePlanId" +"purchaseOptionId" ], "parameters": { -"basePlanId": { -"description": "Required. The unique base plan ID of the base plan to deactivate.", +"packageName": { +"description": "Required. The parent app (package name) of the offers to delete. Must be equal to the package_name field on all the OneTimeProductOffer resources.", "location": "path", "required": true, "type": "string" }, -"packageName": { -"description": "Required. The parent app (package name) of the base plan to deactivate.", +"productId": { +"description": "Required. The product ID of the parent one-time product, if all offers to delete belong to the same product. If this request spans multiple one-time products, set this field to \"-\".", "location": "path", "required": true, "type": "string" }, -"productId": { -"description": "Required. The parent subscription (ID) of the base plan to deactivate.", +"purchaseOptionId": { +"description": "Required. The parent purchase option (ID) for which the offers should be deleted. May be specified as '-' to update offers from multiple purchase options.", "location": "path", "required": true, "type": "string" } }, -"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:deactivate", +"path": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchDelete", "request": { -"$ref": "DeactivateBasePlanRequest" -}, -"response": { -"$ref": "Subscription" +"$ref": "BatchDeleteOneTimeProductOffersRequest" }, "scopes": [ "https://www.googleapis.com/auth/androidpublisher" ] }, -"delete": { -"description": "Deletes a base plan. Can only be done for draft base plans. This action is irreversible.", -"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}", -"httpMethod": "DELETE", -"id": "androidpublisher.monetization.subscriptions.basePlans.delete", +"batchGet": { +"description": "Reads one or more one-time product offers.", +"flatPath": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchGet", +"httpMethod": "POST", +"id": "androidpublisher.monetization.onetimeproducts.purchaseOptions.offers.batchGet", "parameterOrder": [ "packageName", "productId", -"basePlanId" +"purchaseOptionId" ], "parameters": { -"basePlanId": { -"description": "Required. The unique offer ID of the base plan to delete.", +"packageName": { +"description": "Required. The parent app (package name) of the updated offers. Must be equal to the package_name field on all the updated OneTimeProductOffer resources.", "location": "path", "required": true, "type": "string" }, -"packageName": { -"description": "Required. The parent app (package name) of the base plan to delete.", +"productId": { +"description": "Required. The product ID of the parent one-time product, if all updated offers belong to the same product. If this request spans multiple one-time products, set this field to \"-\".", "location": "path", "required": true, "type": "string" }, -"productId": { -"description": "Required. The parent subscription (ID) of the base plan to delete.", +"purchaseOptionId": { +"description": "Required. The parent purchase option (ID) for which the offers should be updated. May be specified as '-' to update offers from multiple purchase options.", "location": "path", "required": true, "type": "string" } }, -"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}", +"path": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchGet", +"request": { +"$ref": "BatchGetOneTimeProductOffersRequest" +}, +"response": { +"$ref": "BatchGetOneTimeProductOffersResponse" +}, "scopes": [ "https://www.googleapis.com/auth/androidpublisher" ] }, -"migratePrices": { -"description": "Migrates subscribers from one or more legacy price cohorts to the current price. Requests result in Google Play notifying affected subscribers. Only up to 250 simultaneous legacy price cohorts are supported.", -"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:migratePrices", +"batchUpdate": { +"description": "Creates or updates one or more one-time product offers.", +"flatPath": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdate", "httpMethod": "POST", -"id": "androidpublisher.monetization.subscriptions.basePlans.migratePrices", +"id": "androidpublisher.monetization.onetimeproducts.purchaseOptions.offers.batchUpdate", "parameterOrder": [ "packageName", "productId", -"basePlanId" +"purchaseOptionId" ], "parameters": { -"basePlanId": { -"description": "Required. The unique base plan ID of the base plan to update prices on.", +"packageName": { +"description": "Required. The parent app (package name) of the updated offers. Must be equal to the package_name field on all the updated OneTimeProductOffer resources.", "location": "path", "required": true, "type": "string" }, -"packageName": { -"description": "Required. Package name of the parent app. Must be equal to the package_name field on the Subscription resource.", +"productId": { +"description": "Required. The product ID of the parent one-time product, if all updated offers belong to the same product. If this request spans multiple one-time products, set this field to \"-\".", "location": "path", "required": true, "type": "string" }, -"productId": { -"description": "Required. The ID of the subscription to update. Must be equal to the product_id field on the Subscription resource.", +"purchaseOptionId": { +"description": "Required. The parent purchase option (ID) for which the offers should be updated. May be specified as '-' to update offers from multiple purchase options.", "location": "path", "required": true, "type": "string" } }, -"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:migratePrices", +"path": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdate", "request": { -"$ref": "MigrateBasePlanPricesRequest" +"$ref": "BatchUpdateOneTimeProductOffersRequest" }, "response": { -"$ref": "MigrateBasePlanPricesResponse" +"$ref": "BatchUpdateOneTimeProductOffersResponse" }, "scopes": [ "https://www.googleapis.com/auth/androidpublisher" ] -} }, -"resources": { -"offers": { -"methods": { -"activate": { -"description": "Activates a subscription offer. Once activated, subscription offers will be available to new subscribers.", -"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers/{offerId}:activate", +"batchUpdateStates": { +"description": "Updates a batch of one-time product offer states.", +"flatPath": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdateStates", "httpMethod": "POST", -"id": "androidpublisher.monetization.subscriptions.basePlans.offers.activate", +"id": "androidpublisher.monetization.onetimeproducts.purchaseOptions.offers.batchUpdateStates", "parameterOrder": [ "packageName", "productId", -"basePlanId", -"offerId" +"purchaseOptionId" +], +"parameters": { +"packageName": { +"description": "Required. The parent app (package name) of the updated one-time product offers.", +"location": "path", +"required": true, +"type": "string" +}, +"productId": { +"description": "Required. The product ID of the parent one-time product, if all updated offers belong to the same one-time product. If this batch update spans multiple one-time products, set this field to \"-\".", +"location": "path", +"required": true, +"type": "string" +}, +"purchaseOptionId": { +"description": "Required. The purchase option ID of the parent purchase option, if all updated offers belong to the same purchase option. If this batch update spans multiple purchase options, set this field to \"-\".", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers:batchUpdateStates", +"request": { +"$ref": "BatchUpdateOneTimeProductOfferStatesRequest" +}, +"response": { +"$ref": "BatchUpdateOneTimeProductOfferStatesResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +}, +"cancel": { +"description": "Cancels a one-time product offer.", +"flatPath": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers/{offerId}:cancel", +"httpMethod": "POST", +"id": "androidpublisher.monetization.onetimeproducts.purchaseOptions.offers.cancel", +"parameterOrder": [ +"packageName", +"productId", +"purchaseOptionId", +"offerId" +], +"parameters": { +"offerId": { +"description": "Required. The offer ID of the offer to cancel.", +"location": "path", +"required": true, +"type": "string" +}, +"packageName": { +"description": "Required. The parent app (package name) of the offer to cancel.", +"location": "path", +"required": true, +"type": "string" +}, +"productId": { +"description": "Required. The parent one-time product (ID) of the offer to cancel.", +"location": "path", +"required": true, +"type": "string" +}, +"purchaseOptionId": { +"description": "Required. The parent purchase option (ID) of the offer to cancel.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers/{offerId}:cancel", +"request": { +"$ref": "CancelOneTimeProductOfferRequest" +}, +"response": { +"$ref": "OneTimeProductOffer" +}, +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +}, +"deactivate": { +"description": "Deactivates a one-time product offer.", +"flatPath": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers/{offerId}:deactivate", +"httpMethod": "POST", +"id": "androidpublisher.monetization.onetimeproducts.purchaseOptions.offers.deactivate", +"parameterOrder": [ +"packageName", +"productId", +"purchaseOptionId", +"offerId" +], +"parameters": { +"offerId": { +"description": "Required. The offer ID of the offer to deactivate.", +"location": "path", +"required": true, +"type": "string" +}, +"packageName": { +"description": "Required. The parent app (package name) of the offer to deactivate.", +"location": "path", +"required": true, +"type": "string" +}, +"productId": { +"description": "Required. The parent one-time product (ID) of the offer to deactivate.", +"location": "path", +"required": true, +"type": "string" +}, +"purchaseOptionId": { +"description": "Required. The parent purchase option (ID) of the offer to deactivate.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers/{offerId}:deactivate", +"request": { +"$ref": "DeactivateOneTimeProductOfferRequest" +}, +"response": { +"$ref": "OneTimeProductOffer" +}, +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +}, +"list": { +"description": "Lists all offers under a given app, product, or purchase option.", +"flatPath": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers", +"httpMethod": "GET", +"id": "androidpublisher.monetization.onetimeproducts.purchaseOptions.offers.list", +"parameterOrder": [ +"packageName", +"productId", +"purchaseOptionId" +], +"parameters": { +"packageName": { +"description": "Required. The parent app (package name) for which the offers should be read.", +"location": "path", +"required": true, +"type": "string" +}, +"pageSize": { +"description": "Optional. The maximum number of offers to return. The service may return fewer than this value. If unspecified, at most 50 offers will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "Optional. A page token, received from a previous `ListOneTimeProductsOffers` call. Provide this to retrieve the subsequent page. When paginating, product_id, package_name and purchase_option_id provided to `ListOneTimeProductsOffersRequest` must match the call that provided the page token.", +"location": "query", +"type": "string" +}, +"productId": { +"description": "Required. The parent one-time product (ID) for which the offers should be read. May be specified as '-' to read all offers under an app.", +"location": "path", +"required": true, +"type": "string" +}, +"purchaseOptionId": { +"description": "Required. The parent purchase option (ID) for which the offers should be read. May be specified as '-' to read all offers under a one-time product or an app. Must be specified as '-' if product_id is specified as '-'.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/oneTimeProducts/{productId}/purchaseOptions/{purchaseOptionId}/offers", +"response": { +"$ref": "ListOneTimeProductOffersResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +} +} +} +} +} +} +}, +"subscriptions": { +"methods": { +"archive": { +"deprecated": true, +"description": "Deprecated: subscription archiving is not supported.", +"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}:archive", +"httpMethod": "POST", +"id": "androidpublisher.monetization.subscriptions.archive", +"parameterOrder": [ +"packageName", +"productId" +], +"parameters": { +"packageName": { +"description": "Required. The parent app (package name) of the app of the subscription to delete.", +"location": "path", +"required": true, +"type": "string" +}, +"productId": { +"description": "Required. The unique product ID of the subscription to delete.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}:archive", +"request": { +"$ref": "ArchiveSubscriptionRequest" +}, +"response": { +"$ref": "Subscription" +}, +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +}, +"batchGet": { +"description": "Reads one or more subscriptions.", +"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions:batchGet", +"httpMethod": "GET", +"id": "androidpublisher.monetization.subscriptions.batchGet", +"parameterOrder": [ +"packageName" +], +"parameters": { +"packageName": { +"description": "Required. The parent app (package name) for which the subscriptions should be retrieved. Must be equal to the package_name field on all the requests.", +"location": "path", +"required": true, +"type": "string" +}, +"productIds": { +"description": "Required. A list of up to 100 subscription product IDs to retrieve. All the IDs must be different.", +"location": "query", +"repeated": true, +"type": "string" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/subscriptions:batchGet", +"response": { +"$ref": "BatchGetSubscriptionsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +}, +"batchUpdate": { +"description": "Updates a batch of subscriptions. Set the latencyTolerance field on nested requests to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT to achieve maximum update throughput.", +"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions:batchUpdate", +"httpMethod": "POST", +"id": "androidpublisher.monetization.subscriptions.batchUpdate", +"parameterOrder": [ +"packageName" +], +"parameters": { +"packageName": { +"description": "Required. The parent app (package name) for which the subscriptions should be updated. Must be equal to the package_name field on all the Subscription resources.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/subscriptions:batchUpdate", +"request": { +"$ref": "BatchUpdateSubscriptionsRequest" +}, +"response": { +"$ref": "BatchUpdateSubscriptionsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +}, +"create": { +"description": "Creates a new subscription. Newly added base plans will remain in draft state until activated.", +"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions", +"httpMethod": "POST", +"id": "androidpublisher.monetization.subscriptions.create", +"parameterOrder": [ +"packageName" +], +"parameters": { +"packageName": { +"description": "Required. The parent app (package name) for which the subscription should be created. Must be equal to the package_name field on the Subscription resource.", +"location": "path", +"required": true, +"type": "string" +}, +"productId": { +"description": "Required. The ID to use for the subscription. For the requirements on this format, see the documentation of the product_id field on the Subscription resource.", +"location": "query", +"type": "string" +}, +"regionsVersion.version": { +"description": "Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.", +"location": "query", +"type": "string" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/subscriptions", +"request": { +"$ref": "Subscription" +}, +"response": { +"$ref": "Subscription" +}, +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +}, +"delete": { +"description": "Deletes a subscription. A subscription can only be deleted if it has never had a base plan published.", +"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}", +"httpMethod": "DELETE", +"id": "androidpublisher.monetization.subscriptions.delete", +"parameterOrder": [ +"packageName", +"productId" +], +"parameters": { +"packageName": { +"description": "Required. The parent app (package name) of the app of the subscription to delete.", +"location": "path", +"required": true, +"type": "string" +}, +"productId": { +"description": "Required. The unique product ID of the subscription to delete.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}", +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +}, +"get": { +"description": "Reads a single subscription.", +"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}", +"httpMethod": "GET", +"id": "androidpublisher.monetization.subscriptions.get", +"parameterOrder": [ +"packageName", +"productId" +], +"parameters": { +"packageName": { +"description": "Required. The parent app (package name) of the subscription to get.", +"location": "path", +"required": true, +"type": "string" +}, +"productId": { +"description": "Required. The unique product ID of the subscription to get.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}", +"response": { +"$ref": "Subscription" +}, +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +}, +"list": { +"description": "Lists all subscriptions under a given app.", +"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions", +"httpMethod": "GET", +"id": "androidpublisher.monetization.subscriptions.list", +"parameterOrder": [ +"packageName" +], +"parameters": { +"packageName": { +"description": "Required. The parent app (package name) for which the subscriptions should be read.", +"location": "path", +"required": true, +"type": "string" +}, +"pageSize": { +"description": "The maximum number of subscriptions to return. The service may return fewer than this value. If unspecified, at most 50 subscriptions will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", +"format": "int32", +"location": "query", +"type": "integer" +}, +"pageToken": { +"description": "A page token, received from a previous `ListSubscriptions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListSubscriptions` must match the call that provided the page token.", +"location": "query", +"type": "string" +}, +"showArchived": { +"deprecated": true, +"description": "Deprecated: subscription archiving is not supported.", +"location": "query", +"type": "boolean" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/subscriptions", +"response": { +"$ref": "ListSubscriptionsResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +}, +"patch": { +"description": "Updates an existing subscription.", +"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}", +"httpMethod": "PATCH", +"id": "androidpublisher.monetization.subscriptions.patch", +"parameterOrder": [ +"packageName", +"productId" +], +"parameters": { +"allowMissing": { +"description": "Optional. If set to true, and the subscription with the given package_name and product_id doesn't exist, the subscription will be created. If a new subscription is created, update_mask is ignored.", +"location": "query", +"type": "boolean" +}, +"latencyTolerance": { +"description": "Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.", +"enum": [ +"PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT" +], +"enumDescriptions": [ +"Defaults to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE.", +"The update will propagate to clients within several minutes on average and up to a few hours in rare cases. Throughput is limited to 7,200 updates per app per hour.", +"The update will propagate to clients within 24 hours. Supports high throughput of up to 720,000 updates per app per hour using batch modification methods." +], +"location": "query", +"type": "string" +}, +"packageName": { +"description": "Immutable. Package name of the parent app.", +"location": "path", +"required": true, +"type": "string" +}, +"productId": { +"description": "Immutable. Unique product ID of the product. Unique within the parent app. Product IDs must be composed of lower-case letters (a-z), numbers (0-9), underscores (_) and dots (.). It must start with a lower-case letter or number, and be between 1 and 40 (inclusive) characters in length.", +"location": "path", +"required": true, +"type": "string" +}, +"regionsVersion.version": { +"description": "Required. A string representing the version of available regions being used for the specified resource. Regional prices and latest supported version for the resource have to be specified according to the information published in [this article](https://support.google.com/googleplay/android-developer/answer/10532353). Each time the supported locations substantially change, the version will be incremented. Using this field will ensure that creating and updating the resource with an older region's version and set of regional prices and currencies will succeed even though a new version is available.", +"location": "query", +"type": "string" +}, +"updateMask": { +"description": "Required. The list of fields to be updated.", +"format": "google-fieldmask", +"location": "query", +"type": "string" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}", +"request": { +"$ref": "Subscription" +}, +"response": { +"$ref": "Subscription" +}, +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +} +}, +"resources": { +"basePlans": { +"methods": { +"activate": { +"description": "Activates a base plan. Once activated, base plans will be available to new subscribers.", +"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:activate", +"httpMethod": "POST", +"id": "androidpublisher.monetization.subscriptions.basePlans.activate", +"parameterOrder": [ +"packageName", +"productId", +"basePlanId" +], +"parameters": { +"basePlanId": { +"description": "Required. The unique base plan ID of the base plan to activate.", +"location": "path", +"required": true, +"type": "string" +}, +"packageName": { +"description": "Required. The parent app (package name) of the base plan to activate.", +"location": "path", +"required": true, +"type": "string" +}, +"productId": { +"description": "Required. The parent subscription (ID) of the base plan to activate.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:activate", +"request": { +"$ref": "ActivateBasePlanRequest" +}, +"response": { +"$ref": "Subscription" +}, +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +}, +"batchMigratePrices": { +"description": "Batch variant of the MigrateBasePlanPrices endpoint. Set the latencyTolerance field on nested requests to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT to achieve maximum update throughput.", +"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchMigratePrices", +"httpMethod": "POST", +"id": "androidpublisher.monetization.subscriptions.basePlans.batchMigratePrices", +"parameterOrder": [ +"packageName", +"productId" +], +"parameters": { +"packageName": { +"description": "Required. The parent app (package name) for which the subscriptions should be created or updated. Must be equal to the package_name field on all the Subscription resources.", +"location": "path", +"required": true, +"type": "string" +}, +"productId": { +"description": "Required. The product ID of the parent subscription, if all updated offers belong to the same subscription. If this batch update spans multiple subscriptions, set this field to \"-\". Must be set.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchMigratePrices", +"request": { +"$ref": "BatchMigrateBasePlanPricesRequest" +}, +"response": { +"$ref": "BatchMigrateBasePlanPricesResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +}, +"batchUpdateStates": { +"description": "Activates or deactivates base plans across one or multiple subscriptions. Set the latencyTolerance field on nested requests to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT to achieve maximum update throughput.", +"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchUpdateStates", +"httpMethod": "POST", +"id": "androidpublisher.monetization.subscriptions.basePlans.batchUpdateStates", +"parameterOrder": [ +"packageName", +"productId" +], +"parameters": { +"packageName": { +"description": "Required. The parent app (package name) of the updated base plans.", +"location": "path", +"required": true, +"type": "string" +}, +"productId": { +"description": "Required. The product ID of the parent subscription, if all updated base plans belong to the same subscription. If this batch update spans multiple subscriptions, set this field to \"-\". Must be set.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans:batchUpdateStates", +"request": { +"$ref": "BatchUpdateBasePlanStatesRequest" +}, +"response": { +"$ref": "BatchUpdateBasePlanStatesResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +}, +"deactivate": { +"description": "Deactivates a base plan. Once deactivated, the base plan will become unavailable to new subscribers, but existing subscribers will maintain their subscription", +"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:deactivate", +"httpMethod": "POST", +"id": "androidpublisher.monetization.subscriptions.basePlans.deactivate", +"parameterOrder": [ +"packageName", +"productId", +"basePlanId" +], +"parameters": { +"basePlanId": { +"description": "Required. The unique base plan ID of the base plan to deactivate.", +"location": "path", +"required": true, +"type": "string" +}, +"packageName": { +"description": "Required. The parent app (package name) of the base plan to deactivate.", +"location": "path", +"required": true, +"type": "string" +}, +"productId": { +"description": "Required. The parent subscription (ID) of the base plan to deactivate.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:deactivate", +"request": { +"$ref": "DeactivateBasePlanRequest" +}, +"response": { +"$ref": "Subscription" +}, +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +}, +"delete": { +"description": "Deletes a base plan. Can only be done for draft base plans. This action is irreversible.", +"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}", +"httpMethod": "DELETE", +"id": "androidpublisher.monetization.subscriptions.basePlans.delete", +"parameterOrder": [ +"packageName", +"productId", +"basePlanId" +], +"parameters": { +"basePlanId": { +"description": "Required. The unique offer ID of the base plan to delete.", +"location": "path", +"required": true, +"type": "string" +}, +"packageName": { +"description": "Required. The parent app (package name) of the base plan to delete.", +"location": "path", +"required": true, +"type": "string" +}, +"productId": { +"description": "Required. The parent subscription (ID) of the base plan to delete.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}", +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +}, +"migratePrices": { +"description": "Migrates subscribers from one or more legacy price cohorts to the current price. Requests result in Google Play notifying affected subscribers. Only up to 250 simultaneous legacy price cohorts are supported.", +"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:migratePrices", +"httpMethod": "POST", +"id": "androidpublisher.monetization.subscriptions.basePlans.migratePrices", +"parameterOrder": [ +"packageName", +"productId", +"basePlanId" +], +"parameters": { +"basePlanId": { +"description": "Required. The unique base plan ID of the base plan to update prices on.", +"location": "path", +"required": true, +"type": "string" +}, +"packageName": { +"description": "Required. Package name of the parent app. Must be equal to the package_name field on the Subscription resource.", +"location": "path", +"required": true, +"type": "string" +}, +"productId": { +"description": "Required. The ID of the subscription to update. Must be equal to the product_id field on the Subscription resource.", +"location": "path", +"required": true, +"type": "string" +} +}, +"path": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}:migratePrices", +"request": { +"$ref": "MigrateBasePlanPricesRequest" +}, +"response": { +"$ref": "MigrateBasePlanPricesResponse" +}, +"scopes": [ +"https://www.googleapis.com/auth/androidpublisher" +] +} +}, +"resources": { +"offers": { +"methods": { +"activate": { +"description": "Activates a subscription offer. Once activated, subscription offers will be available to new subscribers.", +"flatPath": "androidpublisher/v3/applications/{packageName}/subscriptions/{productId}/basePlans/{basePlanId}/offers/{offerId}:activate", +"httpMethod": "POST", +"id": "androidpublisher.monetization.subscriptions.basePlans.offers.activate", +"parameterOrder": [ +"packageName", +"productId", +"basePlanId", +"offerId" ], "parameters": { "basePlanId": { @@ -4831,7 +5521,7 @@ } } }, -"revision": "20250710", +"revision": "20250724", "rootUrl": "https://androidpublisher.googleapis.com/", "schemas": { "Abi": { @@ -4928,6 +5618,76 @@ }, "type": "object" }, +"ActivateOneTimeProductOfferRequest": { +"description": "Request message for ActivateOneTimeProductOffer.", +"id": "ActivateOneTimeProductOfferRequest", +"properties": { +"latencyTolerance": { +"description": "Optional. The latency tolerance for the propagation of this update. Defaults to latency-sensitive.", +"enum": [ +"PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT" +], +"enumDescriptions": [ +"Defaults to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE.", +"The update will propagate to clients within several minutes on average and up to a few hours in rare cases. Throughput is limited to 7,200 updates per app per hour.", +"The update will propagate to clients within 24 hours. Supports high throughput of up to 720,000 updates per app per hour using batch modification methods." +], +"type": "string" +}, +"offerId": { +"description": "Required. The offer ID of the offer to activate.", +"type": "string" +}, +"packageName": { +"description": "Required. The parent app (package name) of the offer to activate.", +"type": "string" +}, +"productId": { +"description": "Required. The parent one-time product (ID) of the offer to activate.", +"type": "string" +}, +"purchaseOptionId": { +"description": "Required. The parent purchase option (ID) of the offer to activate.", +"type": "string" +} +}, +"type": "object" +}, +"ActivatePurchaseOptionRequest": { +"description": "Request message for UpdatePurchaseOptionState.", +"id": "ActivatePurchaseOptionRequest", +"properties": { +"latencyTolerance": { +"description": "Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.", +"enum": [ +"PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT" +], +"enumDescriptions": [ +"Defaults to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE.", +"The update will propagate to clients within several minutes on average and up to a few hours in rare cases. Throughput is limited to 7,200 updates per app per hour.", +"The update will propagate to clients within 24 hours. Supports high throughput of up to 720,000 updates per app per hour using batch modification methods." +], +"type": "string" +}, +"packageName": { +"description": "Required. The parent app (package name) of the purchase option to activate.", +"type": "string" +}, +"productId": { +"description": "Required. The parent one-time product (ID) of the purchase option to activate.", +"type": "string" +}, +"purchaseOptionId": { +"description": "Required. The purchase option ID of the purchase option to activate.", +"type": "string" +} +}, +"type": "object" +}, "ActivateSubscriptionOfferRequest": { "description": "Request message for ActivateSubscriptionOffer.", "id": "ActivateSubscriptionOfferRequest", @@ -5479,111 +6239,307 @@ }, "type": "object" }, -"BatchGetOrdersResponse": { -"description": "Response for the orders.batchGet API.", -"id": "BatchGetOrdersResponse", +"BatchDeleteOneTimeProductOffersRequest": { +"description": "Request message for BatchDeleteOneTimeProductOffers.", +"id": "BatchDeleteOneTimeProductOffersRequest", +"properties": { +"requests": { +"description": "Required. A list of update requests of up to 100 elements. All requests must correspond to different offers.", +"items": { +"$ref": "DeleteOneTimeProductOfferRequest" +}, +"type": "array" +} +}, +"type": "object" +}, +"BatchDeleteOneTimeProductsRequest": { +"description": "Request message for BatchDeleteOneTimeProduct.", +"id": "BatchDeleteOneTimeProductsRequest", +"properties": { +"requests": { +"description": "Required. A list of delete requests of up to 100 elements. All requests must delete different one-time products.", +"items": { +"$ref": "DeleteOneTimeProductRequest" +}, +"type": "array" +} +}, +"type": "object" +}, +"BatchDeletePurchaseOptionsRequest": { +"description": "Request message for BatchDeletePurchaseOption.", +"id": "BatchDeletePurchaseOptionsRequest", +"properties": { +"requests": { +"description": "Required. A list of delete requests of up to 100 elements. All requests must delete purchase options from different one-time products.", +"items": { +"$ref": "DeletePurchaseOptionRequest" +}, +"type": "array" +} +}, +"type": "object" +}, +"BatchGetOneTimeProductOffersRequest": { +"description": "Request message for the BatchGetOneTimeProductOffers endpoint.", +"id": "BatchGetOneTimeProductOffersRequest", +"properties": { +"requests": { +"description": "Required. A list of get requests of up to 100 elements. All requests must retrieve different offers.", +"items": { +"$ref": "GetOneTimeProductOfferRequest" +}, +"type": "array" +} +}, +"type": "object" +}, +"BatchGetOneTimeProductOffersResponse": { +"description": "Response message for the BatchGetOneTimeProductOffers endpoint.", +"id": "BatchGetOneTimeProductOffersResponse", +"properties": { +"oneTimeProductOffers": { +"description": "The list of updated one-time product offers, in the same order as the request.", +"items": { +"$ref": "OneTimeProductOffer" +}, +"type": "array" +} +}, +"type": "object" +}, +"BatchGetOneTimeProductsResponse": { +"description": "Response message for the BatchGetOneTimeProducts endpoint.", +"id": "BatchGetOneTimeProductsResponse", +"properties": { +"oneTimeProducts": { +"description": "The list of requested one-time products, in the same order as the request.", +"items": { +"$ref": "OneTimeProduct" +}, +"type": "array" +} +}, +"type": "object" +}, +"BatchGetOrdersResponse": { +"description": "Response for the orders.batchGet API.", +"id": "BatchGetOrdersResponse", +"properties": { +"orders": { +"description": "Details for the requested order IDs.", +"items": { +"$ref": "Order" +}, +"type": "array" +} +}, +"type": "object" +}, +"BatchGetSubscriptionOffersRequest": { +"description": "Request message for BatchGetSubscriptionOffers endpoint.", +"id": "BatchGetSubscriptionOffersRequest", +"properties": { +"requests": { +"description": "Required. A list of update requests of up to 100 elements. All requests must update different subscriptions.", +"items": { +"$ref": "GetSubscriptionOfferRequest" +}, +"type": "array" +} +}, +"type": "object" +}, +"BatchGetSubscriptionOffersResponse": { +"description": "Response message for BatchGetSubscriptionOffers endpoint.", +"id": "BatchGetSubscriptionOffersResponse", +"properties": { +"subscriptionOffers": { +"items": { +"$ref": "SubscriptionOffer" +}, +"type": "array" +} +}, +"type": "object" +}, +"BatchGetSubscriptionsResponse": { +"description": "Response message for BatchGetSubscriptions endpoint.", +"id": "BatchGetSubscriptionsResponse", +"properties": { +"subscriptions": { +"description": "The list of requested subscriptions, in the same order as the request.", +"items": { +"$ref": "Subscription" +}, +"type": "array" +} +}, +"type": "object" +}, +"BatchMigrateBasePlanPricesRequest": { +"description": "Request message for BatchMigrateBasePlanPrices.", +"id": "BatchMigrateBasePlanPricesRequest", +"properties": { +"requests": { +"description": "Required. Up to 100 price migration requests. All requests must update different base plans.", +"items": { +"$ref": "MigrateBasePlanPricesRequest" +}, +"type": "array" +} +}, +"type": "object" +}, +"BatchMigrateBasePlanPricesResponse": { +"description": "Response message for BatchMigrateBasePlanPrices.", +"id": "BatchMigrateBasePlanPricesResponse", +"properties": { +"responses": { +"description": "Contains one response per requested price migration, in the same order as the request.", +"items": { +"$ref": "MigrateBasePlanPricesResponse" +}, +"type": "array" +} +}, +"type": "object" +}, +"BatchUpdateBasePlanStatesRequest": { +"description": "Request message for BatchUpdateBasePlanStates.", +"id": "BatchUpdateBasePlanStatesRequest", +"properties": { +"requests": { +"description": "Required. The update request list of up to 100 elements. All requests must update different base plans.", +"items": { +"$ref": "UpdateBasePlanStateRequest" +}, +"type": "array" +} +}, +"type": "object" +}, +"BatchUpdateBasePlanStatesResponse": { +"description": "Response message for BatchUpdateBasePlanStates.", +"id": "BatchUpdateBasePlanStatesResponse", +"properties": { +"subscriptions": { +"description": "The list of updated subscriptions. This list will match the requests one to one, in the same order.", +"items": { +"$ref": "Subscription" +}, +"type": "array" +} +}, +"type": "object" +}, +"BatchUpdateOneTimeProductOfferStatesRequest": { +"description": "Request message for BatchUpdateOneTimeProductOfferStates.", +"id": "BatchUpdateOneTimeProductOfferStatesRequest", "properties": { -"orders": { -"description": "Details for the requested order IDs.", +"requests": { +"description": "Required. The update request list of up to 100 elements. All requests must update different offers.", "items": { -"$ref": "Order" +"$ref": "UpdateOneTimeProductOfferStateRequest" }, "type": "array" } }, "type": "object" }, -"BatchGetSubscriptionOffersRequest": { -"description": "Request message for BatchGetSubscriptionOffers endpoint.", -"id": "BatchGetSubscriptionOffersRequest", +"BatchUpdateOneTimeProductOfferStatesResponse": { +"description": "Response message for BatchUpdateOneTimeProductOfferStates.", +"id": "BatchUpdateOneTimeProductOfferStatesResponse", "properties": { -"requests": { -"description": "Required. A list of update requests of up to 100 elements. All requests must update different subscriptions.", +"oneTimeProductOffers": { +"description": "The updated one-time product offers list, in the same order as the request.", "items": { -"$ref": "GetSubscriptionOfferRequest" +"$ref": "OneTimeProductOffer" }, "type": "array" } }, "type": "object" }, -"BatchGetSubscriptionOffersResponse": { -"description": "Response message for BatchGetSubscriptionOffers endpoint.", -"id": "BatchGetSubscriptionOffersResponse", +"BatchUpdateOneTimeProductOffersRequest": { +"description": "Request message for BatchUpdateOneTimeProductOffers.", +"id": "BatchUpdateOneTimeProductOffersRequest", "properties": { -"subscriptionOffers": { +"requests": { +"description": "Required. A list of update requests of up to 100 elements. All requests must update different offers.", "items": { -"$ref": "SubscriptionOffer" +"$ref": "UpdateOneTimeProductOfferRequest" }, "type": "array" } }, "type": "object" }, -"BatchGetSubscriptionsResponse": { -"description": "Response message for BatchGetSubscriptions endpoint.", -"id": "BatchGetSubscriptionsResponse", +"BatchUpdateOneTimeProductOffersResponse": { +"description": "Response message for BatchUpdateOneTimeProductOffers.", +"id": "BatchUpdateOneTimeProductOffersResponse", "properties": { -"subscriptions": { -"description": "The list of requested subscriptions, in the same order as the request.", +"oneTimeProductOffers": { +"description": "The list of updated one-time product offers, in the same order as the request.", "items": { -"$ref": "Subscription" +"$ref": "OneTimeProductOffer" }, "type": "array" } }, "type": "object" }, -"BatchMigrateBasePlanPricesRequest": { -"description": "Request message for BatchMigrateBasePlanPrices.", -"id": "BatchMigrateBasePlanPricesRequest", +"BatchUpdateOneTimeProductsRequest": { +"description": "Request message for BatchUpdateOneTimeProduct.", +"id": "BatchUpdateOneTimeProductsRequest", "properties": { "requests": { -"description": "Required. Up to 100 price migration requests. All requests must update different base plans.", +"description": "Required. A list of update requests of up to 100 elements. All requests must update different one-time products.", "items": { -"$ref": "MigrateBasePlanPricesRequest" +"$ref": "UpdateOneTimeProductRequest" }, "type": "array" } }, "type": "object" }, -"BatchMigrateBasePlanPricesResponse": { -"description": "Response message for BatchMigrateBasePlanPrices.", -"id": "BatchMigrateBasePlanPricesResponse", +"BatchUpdateOneTimeProductsResponse": { +"description": "Response message for BatchUpdateOneTimeProduct.", +"id": "BatchUpdateOneTimeProductsResponse", "properties": { -"responses": { -"description": "Contains one response per requested price migration, in the same order as the request.", +"oneTimeProducts": { +"description": "The list of updated one-time products list, in the same order as the request.", "items": { -"$ref": "MigrateBasePlanPricesResponse" +"$ref": "OneTimeProduct" }, "type": "array" } }, "type": "object" }, -"BatchUpdateBasePlanStatesRequest": { -"description": "Request message for BatchUpdateBasePlanStates.", -"id": "BatchUpdateBasePlanStatesRequest", +"BatchUpdatePurchaseOptionStatesRequest": { +"description": "Request message for BatchUpdatePurchaseOptionStates.", +"id": "BatchUpdatePurchaseOptionStatesRequest", "properties": { "requests": { -"description": "Required. The update request list of up to 100 elements. All requests must update different base plans.", +"description": "Required. The update request list of up to 100 elements. All requests must update different purchase options.", "items": { -"$ref": "UpdateBasePlanStateRequest" +"$ref": "UpdatePurchaseOptionStateRequest" }, "type": "array" } }, "type": "object" }, -"BatchUpdateBasePlanStatesResponse": { -"description": "Response message for BatchUpdateBasePlanStates.", -"id": "BatchUpdateBasePlanStatesResponse", +"BatchUpdatePurchaseOptionStatesResponse": { +"description": "Response message for BatchUpdatePurchaseOptionStates.", +"id": "BatchUpdatePurchaseOptionStatesResponse", "properties": { -"subscriptions": { -"description": "The list of updated subscriptions. This list will match the requests one to one, in the same order.", +"oneTimeProducts": { +"description": "The list of updated one-time products. This list will match the requests one to one, in the same order.", "items": { -"$ref": "Subscription" +"$ref": "OneTimeProduct" }, "type": "array" } @@ -5743,6 +6699,43 @@ "properties": {}, "type": "object" }, +"CancelOneTimeProductOfferRequest": { +"description": "Request message for CancelOneTimeProductOffer.", +"id": "CancelOneTimeProductOfferRequest", +"properties": { +"latencyTolerance": { +"description": "Optional. The latency tolerance for the propagation of this update. Defaults to latency-sensitive.", +"enum": [ +"PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT" +], +"enumDescriptions": [ +"Defaults to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE.", +"The update will propagate to clients within several minutes on average and up to a few hours in rare cases. Throughput is limited to 7,200 updates per app per hour.", +"The update will propagate to clients within 24 hours. Supports high throughput of up to 720,000 updates per app per hour using batch modification methods." +], +"type": "string" +}, +"offerId": { +"description": "Required. The offer ID of the offer to cancel.", +"type": "string" +}, +"packageName": { +"description": "Required. The parent app (package name) of the offer to cancel.", +"type": "string" +}, +"productId": { +"description": "Required. The parent one-time product (ID) of the offer to cancel.", +"type": "string" +}, +"purchaseOptionId": { +"description": "Required. The parent purchase option (ID) of the offer to cancel.", +"type": "string" +} +}, +"type": "object" +}, "CancelSurveyResult": { "description": "Result of the cancel survey when the subscription was canceled by the user.", "id": "CancelSurveyResult", @@ -5957,6 +6950,76 @@ }, "type": "object" }, +"DeactivateOneTimeProductOfferRequest": { +"description": "Request message for DeactivateOneTimeProductOffer.", +"id": "DeactivateOneTimeProductOfferRequest", +"properties": { +"latencyTolerance": { +"description": "Optional. The latency tolerance for the propagation of this update. Defaults to latency-sensitive.", +"enum": [ +"PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT" +], +"enumDescriptions": [ +"Defaults to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE.", +"The update will propagate to clients within several minutes on average and up to a few hours in rare cases. Throughput is limited to 7,200 updates per app per hour.", +"The update will propagate to clients within 24 hours. Supports high throughput of up to 720,000 updates per app per hour using batch modification methods." +], +"type": "string" +}, +"offerId": { +"description": "Required. The offer ID of the offer to deactivate.", +"type": "string" +}, +"packageName": { +"description": "Required. The parent app (package name) of the offer to deactivate.", +"type": "string" +}, +"productId": { +"description": "Required. The parent one-time product (ID) of the offer to deactivate.", +"type": "string" +}, +"purchaseOptionId": { +"description": "Required. The parent purchase option (ID) of the offer to deactivate.", +"type": "string" +} +}, +"type": "object" +}, +"DeactivatePurchaseOptionRequest": { +"description": "Request message for UpdatePurchaseOptionState.", +"id": "DeactivatePurchaseOptionRequest", +"properties": { +"latencyTolerance": { +"description": "Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.", +"enum": [ +"PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT" +], +"enumDescriptions": [ +"Defaults to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE.", +"The update will propagate to clients within several minutes on average and up to a few hours in rare cases. Throughput is limited to 7,200 updates per app per hour.", +"The update will propagate to clients within 24 hours. Supports high throughput of up to 720,000 updates per app per hour using batch modification methods." +], +"type": "string" +}, +"packageName": { +"description": "Required. The parent app (package name) of the purchase option to deactivate.", +"type": "string" +}, +"productId": { +"description": "Required. The parent one-time product (ID) of the purchase option to deactivate.", +"type": "string" +}, +"purchaseOptionId": { +"description": "Required. The purchase option ID of the purchase option to deactivate.", +"type": "string" +} +}, +"type": "object" +}, "DeactivateSubscriptionOfferRequest": { "description": "Request message for DeactivateSubscriptionOffer.", "id": "DeactivateSubscriptionOfferRequest", @@ -6005,6 +7068,109 @@ }, "type": "object" }, +"DeleteOneTimeProductOfferRequest": { +"description": "Request message for deleting an one-time product offer.", +"id": "DeleteOneTimeProductOfferRequest", +"properties": { +"latencyTolerance": { +"description": "Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.", +"enum": [ +"PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT" +], +"enumDescriptions": [ +"Defaults to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE.", +"The update will propagate to clients within several minutes on average and up to a few hours in rare cases. Throughput is limited to 7,200 updates per app per hour.", +"The update will propagate to clients within 24 hours. Supports high throughput of up to 720,000 updates per app per hour using batch modification methods." +], +"type": "string" +}, +"offerId": { +"description": "Required. The unique offer ID of the offer to delete.", +"type": "string" +}, +"packageName": { +"description": "Required. The parent app (package name) of the offer to delete.", +"type": "string" +}, +"productId": { +"description": "Required. The parent one-time product (ID) of the offer to delete.", +"type": "string" +}, +"purchaseOptionId": { +"description": "Required. The parent purchase option (ID) of the offer to delete.", +"type": "string" +} +}, +"type": "object" +}, +"DeleteOneTimeProductRequest": { +"description": "Request message for deleting a one-time product.", +"id": "DeleteOneTimeProductRequest", +"properties": { +"latencyTolerance": { +"description": "Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.", +"enum": [ +"PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT" +], +"enumDescriptions": [ +"Defaults to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE.", +"The update will propagate to clients within several minutes on average and up to a few hours in rare cases. Throughput is limited to 7,200 updates per app per hour.", +"The update will propagate to clients within 24 hours. Supports high throughput of up to 720,000 updates per app per hour using batch modification methods." +], +"type": "string" +}, +"packageName": { +"description": "Required. The parent app (package name) of the one-time product to delete.", +"type": "string" +}, +"productId": { +"description": "Required. The one-time product ID of the one-time product to delete.", +"type": "string" +} +}, +"type": "object" +}, +"DeletePurchaseOptionRequest": { +"description": "Request message for deleting a purchase option.", +"id": "DeletePurchaseOptionRequest", +"properties": { +"force": { +"description": "Optional. This field has no effect for purchase options with no offers under them. For purchase options with associated offers: * If `force` is set to false (default), an error will be returned. * If `force` is set to true, any associated offers under the purchase option will be deleted.", +"type": "boolean" +}, +"latencyTolerance": { +"description": "Optional. The latency tolerance for the propagation of this product update. Defaults to latency-sensitive.", +"enum": [ +"PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT" +], +"enumDescriptions": [ +"Defaults to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE.", +"The update will propagate to clients within several minutes on average and up to a few hours in rare cases. Throughput is limited to 7,200 updates per app per hour.", +"The update will propagate to clients within 24 hours. Supports high throughput of up to 720,000 updates per app per hour using batch modification methods." +], +"type": "string" +}, +"packageName": { +"description": "Required. The parent app (package name) of the purchase option to delete.", +"type": "string" +}, +"productId": { +"description": "Required. The parent one-time product (ID) of the purchase option to delete.", +"type": "string" +}, +"purchaseOptionId": { +"description": "Required. The purchase option ID of the purchase option to delete.", +"type": "string" +} +}, +"type": "object" +}, "DeobfuscationFile": { "description": "Represents a deobfuscation file.", "id": "DeobfuscationFile", @@ -6776,6 +7942,29 @@ }, "type": "object" }, +"GetOneTimeProductOfferRequest": { +"description": "Request message for GetOneTimeProductOffers.", +"id": "GetOneTimeProductOfferRequest", +"properties": { +"offerId": { +"description": "Required. The unique offer ID of the offer to get.", +"type": "string" +}, +"packageName": { +"description": "Required. The parent app (package name) of the offer to get.", +"type": "string" +}, +"productId": { +"description": "Required. The parent one-time product (ID) of the offer to get.", +"type": "string" +}, +"purchaseOptionId": { +"description": "Required. The parent purchase option (ID) of the offer to get.", +"type": "string" +} +}, +"type": "object" +}, "GetSubscriptionOfferRequest": { "description": "Request message for GetSubscriptionOffer.", "id": "GetSubscriptionOfferRequest", @@ -7411,13 +8600,49 @@ false "deviceTierConfigs": { "description": "Device tier configs created by the developer.", "items": { -"$ref": "DeviceTierConfig" +"$ref": "DeviceTierConfig" +}, +"type": "array" +}, +"nextPageToken": { +"description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", +"type": "string" +} +}, +"type": "object" +}, +"ListOneTimeProductOffersResponse": { +"description": "Response message for ListOneTimeProductOffers.", +"id": "ListOneTimeProductOffersResponse", +"properties": { +"nextPageToken": { +"description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", +"type": "string" +}, +"oneTimeProductOffers": { +"description": "The one_time_product offers from the specified request.", +"items": { +"$ref": "OneTimeProductOffer" }, "type": "array" +} }, +"type": "object" +}, +"ListOneTimeProductsResponse": { +"description": "Response message for ListOneTimeProducts.", +"id": "ListOneTimeProductsResponse", +"properties": { "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" +}, +"oneTimeProducts": { +"description": "The one-time products from the specified app.", +"items": { +"$ref": "OneTimeProduct" +}, +"type": "array" } }, "type": "object" @@ -7698,100 +8923,509 @@ false "description": "The three-letter currency code defined in ISO 4217.", "type": "string" }, -"nanos": { -"description": "Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.", -"format": "int32", -"type": "integer" +"nanos": { +"description": "Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.", +"format": "int32", +"type": "integer" +}, +"units": { +"description": "The whole units of the amount. For example if `currencyCode` is `\"USD\"`, then 1 unit is one US dollar.", +"format": "int64", +"type": "string" +} +}, +"type": "object" +}, +"MultiAbi": { +"description": "Represents a list of ABIs.", +"id": "MultiAbi", +"properties": { +"abi": { +"description": "A list of targeted ABIs, as represented by the Android Platform", +"items": { +"$ref": "Abi" +}, +"type": "array" +} +}, +"type": "object" +}, +"MultiAbiTargeting": { +"description": "Targeting based on multiple abis.", +"id": "MultiAbiTargeting", +"properties": { +"alternatives": { +"description": "Targeting of other sibling directories that were in the Bundle. For main splits this is targeting of other main splits.", +"items": { +"$ref": "MultiAbi" +}, +"type": "array" +}, +"value": { +"description": "Value of a multi abi.", +"items": { +"$ref": "MultiAbi" +}, +"type": "array" +} +}, +"type": "object" +}, +"OfferDetails": { +"description": "Offer details information related to a purchase line item.", +"id": "OfferDetails", +"properties": { +"basePlanId": { +"description": "The base plan ID. Present for all base plan and offers.", +"type": "string" +}, +"offerId": { +"description": "The offer ID. Only present for discounted offers.", +"type": "string" +}, +"offerTags": { +"description": "The latest offer tags associated with the offer. It includes tags inherited from the base plan.", +"items": { +"type": "string" +}, +"type": "array" +} +}, +"type": "object" +}, +"OfferTag": { +"description": "Represents a custom tag specified for a product offer.", +"id": "OfferTag", +"properties": { +"tag": { +"description": "Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.", +"type": "string" +} +}, +"type": "object" +}, +"OneTimeCode": { +"description": "A single use promotion code.", +"id": "OneTimeCode", +"properties": {}, +"type": "object" +}, +"OneTimeExternalTransaction": { +"description": "Represents a one-time transaction.", +"id": "OneTimeExternalTransaction", +"properties": { +"externalTransactionToken": { +"description": "Input only. Provided during the call to Create. Retrieved from the client when the alternative billing flow is launched.", +"type": "string" +} +}, +"type": "object" +}, +"OneTimeProduct": { +"description": "A single one-time product for an app.", +"id": "OneTimeProduct", +"properties": { +"listings": { +"description": "Required. Set of localized title and description data. Must not have duplicate entries with the same language_code.", +"items": { +"$ref": "OneTimeProductListing" +}, +"type": "array" +}, +"offerTags": { +"description": "Optional. List of up to 20 custom tags specified for this one-time product, and returned to the app through the billing library. Purchase options and offers for this product will also receive these tags in the billing library.", +"items": { +"$ref": "OfferTag" +}, +"type": "array" +}, +"packageName": { +"description": "Required. Immutable. Package name of the parent app.", +"type": "string" +}, +"productId": { +"description": "Required. Immutable. Unique product ID of the product. Unique within the parent app. Product IDs must start with a number or lowercase letter, and can contain numbers (0-9), lowercase letters (a-z), underscores (_), and periods (.).", +"type": "string" +}, +"purchaseOptions": { +"description": "Required. The set of purchase options for this one-time product.", +"items": { +"$ref": "OneTimeProductPurchaseOption" +}, +"type": "array" +}, +"regionsVersion": { +"$ref": "RegionsVersion", +"description": "Output only. The version of the regions configuration that was used to generate the one-time product.", +"readOnly": true +}, +"restrictedPaymentCountries": { +"$ref": "RestrictedPaymentCountries", +"description": "Optional. Countries where the purchase of this one-time product is restricted to payment methods registered in the same country. If empty, no payment location restrictions are imposed." +}, +"taxAndComplianceSettings": { +"$ref": "OneTimeProductTaxAndComplianceSettings", +"description": "Details about taxes and legal compliance." +} +}, +"type": "object" +}, +"OneTimeProductBuyPurchaseOption": { +"description": "A purchase option that can be bought.", +"id": "OneTimeProductBuyPurchaseOption", +"properties": { +"legacyCompatible": { +"description": "Optional. Whether this purchase option will be available in legacy PBL flows that do not support one-time products model. Up to one \"buy\" purchase option can be marked as backwards compatible.", +"type": "boolean" +}, +"multiQuantityEnabled": { +"description": "Optional. Whether this purchase option allows multi-quantity. Multi-quantity allows buyer to purchase more than one item in a single checkout.", +"type": "boolean" +} +}, +"type": "object" +}, +"OneTimeProductDiscountedOffer": { +"description": "Configuration specific to discounted offers.", +"id": "OneTimeProductDiscountedOffer", +"properties": { +"endTime": { +"description": "Time when the offer will stop being available.", +"format": "google-datetime", +"type": "string" +}, +"redemptionLimit": { +"description": "Optional. The number of times this offer can be redeemed. If unset or set to 0, allows for unlimited offer redemptions. Otherwise must be a number between 1 and 50 inclusive.", +"format": "int64", +"type": "string" +}, +"startTime": { +"description": "Time when the offer will start being available.", +"format": "google-datetime", +"type": "string" +} +}, +"type": "object" +}, +"OneTimeProductListing": { +"description": "Regional store listing for a one-time product.", +"id": "OneTimeProductListing", +"properties": { +"description": { +"description": "Required. The description of this product in the language of this listing. The maximum length is 200 characters.", +"type": "string" +}, +"languageCode": { +"description": "Required. The language of this listing, as defined by BCP-47, e.g., \"en-US\".", +"type": "string" +}, +"title": { +"description": "Required. The title of this product in the language of this listing. The maximum length is 55 characters.", +"type": "string" +} +}, +"type": "object" +}, +"OneTimeProductOffer": { +"description": "A single offer for a one-time product.", +"id": "OneTimeProductOffer", +"properties": { +"discountedOffer": { +"$ref": "OneTimeProductDiscountedOffer", +"description": "A discounted offer." +}, +"offerId": { +"description": "Required. Immutable. The ID of this product offer. Must be unique within the purchase option. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.", +"type": "string" +}, +"offerTags": { +"description": "Optional. List of up to 20 custom tags specified for this offer, and returned to the app through the billing library.", +"items": { +"$ref": "OfferTag" +}, +"type": "array" +}, +"packageName": { +"description": "Required. Immutable. The package name of the app the parent product belongs to.", +"type": "string" +}, +"preOrderOffer": { +"$ref": "OneTimeProductPreOrderOffer", +"description": "A pre-order offer." +}, +"productId": { +"description": "Required. Immutable. The ID of the parent product this offer belongs to.", +"type": "string" +}, +"purchaseOptionId": { +"description": "Required. Immutable. The ID of the purchase option to which this offer is an extension.", +"type": "string" +}, +"regionalPricingAndAvailabilityConfigs": { +"description": "Set of regional pricing and availability information for this offer. Must not have duplicate entries with the same region_code.", +"items": { +"$ref": "OneTimeProductOfferRegionalPricingAndAvailabilityConfig" +}, +"type": "array" +}, +"regionsVersion": { +"$ref": "RegionsVersion", +"description": "Output only. The version of the regions configuration that was used to generate the one-time product offer.", +"readOnly": true +}, +"state": { +"description": "Output only. The current state of this offer. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.", +"enum": [ +"STATE_UNSPECIFIED", +"DRAFT", +"ACTIVE", +"CANCELLED", +"INACTIVE" +], +"enumDescriptions": [ +"Default value, should never be used.", +"The offer is not and has never been available to users.", +"The offer is available to users, as long as its conditions are met.", +"This state is specific to pre-orders. The offer is cancelled and not available to users. All pending orders related to this offer were cancelled.", +"This state is specific to discounted offers. The offer is no longer available to users." +], +"readOnly": true, +"type": "string" +} +}, +"type": "object" +}, +"OneTimeProductOfferNoPriceOverrideOptions": { +"description": "Options for one-time product offers without a regional price override.", +"id": "OneTimeProductOfferNoPriceOverrideOptions", +"properties": {}, +"type": "object" +}, +"OneTimeProductOfferRegionalPricingAndAvailabilityConfig": { +"description": "Regional pricing and availability configuration for a one-time product offer.", +"id": "OneTimeProductOfferRegionalPricingAndAvailabilityConfig", +"properties": { +"absoluteDiscount": { +"$ref": "Money", +"description": "The absolute value of the discount that is subtracted from the purchase option price. It should be between 0 and the purchase option price." +}, +"availability": { +"description": "Required. The availability for this region.", +"enum": [ +"AVAILABILITY_UNSPECIFIED", +"AVAILABLE", +"NO_LONGER_AVAILABLE" +], +"enumDescriptions": [ +"Unspecified availability. Must not be used.", +"The offer is available to users.", +"The offer is no longer available to users. This value can only be used if the availability was previously set as AVAILABLE." +], +"type": "string" +}, +"noOverride": { +"$ref": "OneTimeProductOfferNoPriceOverrideOptions", +"description": "The price defined in the purchase option for this region will be used." +}, +"regionCode": { +"description": "Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., \"US\".", +"type": "string" +}, +"relativeDiscount": { +"description": "The fraction of the purchase option price that the user pays for this offer. For example, if the purchase option price for this region is $12, then a 50% discount would correspond to a price of $6. The discount must be specified as a fraction strictly larger than 0 and strictly smaller than 1. The resulting price will be rounded to the nearest billable unit (e.g. cents for USD). The relative discount is considered invalid if the discounted price ends up being smaller than the minimum price allowed in this region.", +"format": "double", +"type": "number" +} +}, +"type": "object" +}, +"OneTimeProductPreOrderOffer": { +"description": "Configuration specific to pre-order offers.", +"id": "OneTimeProductPreOrderOffer", +"properties": { +"endTime": { +"description": "Required. Time when the pre-order will stop being available.", +"format": "google-datetime", +"type": "string" +}, +"priceChangeBehavior": { +"description": "Required. Immutable. Specifies how price changes affect pre-existing pre-orders.", +"enum": [ +"PRE_ORDER_PRICE_CHANGE_BEHAVIOR_UNSPECIFIED", +"PRE_ORDER_PRICE_CHANGE_BEHAVIOR_TWO_POINT_LOWEST", +"PRE_ORDER_PRICE_CHANGE_BEHAVIOR_NEW_ORDERS_ONLY" +], +"enumDescriptions": [ +"Unspecified price change behavior. Must not be used.", +"The buyer gets charged the minimum between the initial price at the time of pre-order and the final offer price on the release date.", +"The buyer gets the same price as the one they pre-ordered, regardless of any price changes that may have happened after the pre-order." +], +"type": "string" }, -"units": { -"description": "The whole units of the amount. For example if `currencyCode` is `\"USD\"`, then 1 unit is one US dollar.", -"format": "int64", +"releaseTime": { +"description": "Required. Time on which the product associated with the pre-order will be released and the pre-order orders fulfilled.", +"format": "google-datetime", +"type": "string" +}, +"startTime": { +"description": "Required. Time when the pre-order will start being available.", +"format": "google-datetime", "type": "string" } }, "type": "object" }, -"MultiAbi": { -"description": "Represents a list of ABIs.", -"id": "MultiAbi", +"OneTimeProductPurchaseOption": { +"description": "A single purchase option for a one-time product.", +"id": "OneTimeProductPurchaseOption", "properties": { -"abi": { -"description": "A list of targeted ABIs, as represented by the Android Platform", +"buyOption": { +"$ref": "OneTimeProductBuyPurchaseOption", +"description": "A purchase option that can be bought." +}, +"newRegionsConfig": { +"$ref": "OneTimeProductPurchaseOptionNewRegionsConfig", +"description": "Pricing information for any new locations Play may launch in the future. If omitted, the purchase option will not be automatically available in any new locations Play may launch in the future." +}, +"offerTags": { +"description": "Optional. List of up to 20 custom tags specified for this purchase option, and returned to the app through the billing library. Offers for this purchase option will also receive these tags in the billing library.", "items": { -"$ref": "Abi" +"$ref": "OfferTag" }, "type": "array" -} }, -"type": "object" +"purchaseOptionId": { +"description": "Required. Immutable. The unique identifier of this purchase option. Must be unique within the one-time product. It must start with a number or lower-case letter, and can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-). The maximum length is 63 characters.", +"type": "string" }, -"MultiAbiTargeting": { -"description": "Targeting based on multiple abis.", -"id": "MultiAbiTargeting", -"properties": { -"alternatives": { -"description": "Targeting of other sibling directories that were in the Bundle. For main splits this is targeting of other main splits.", +"regionalPricingAndAvailabilityConfigs": { +"description": "Regional pricing and availability information for this purchase option.", "items": { -"$ref": "MultiAbi" +"$ref": "OneTimeProductPurchaseOptionRegionalPricingAndAvailabilityConfig" }, "type": "array" }, -"value": { -"description": "Value of a multi abi.", -"items": { -"$ref": "MultiAbi" +"rentOption": { +"$ref": "OneTimeProductRentPurchaseOption", +"description": "A purchase option that can be rented." }, -"type": "array" +"state": { +"description": "Output only. The state of the purchase option, i.e., whether it's active. This field cannot be changed by updating the resource. Use the dedicated endpoints instead.", +"enum": [ +"STATE_UNSPECIFIED", +"DRAFT", +"ACTIVE", +"INACTIVE", +"INACTIVE_PUBLISHED" +], +"enumDescriptions": [ +"Default value, should never be used.", +"The purchase option is not and has never been available to users.", +"The purchase option is available to users.", +"The purchase option is not available to users anymore.", +"The purchase option is not available for purchase anymore, but we continue to expose its offer via the Play Billing Library for backwards compatibility. Only automatically migrated purchase options can be in this state." +], +"readOnly": true, +"type": "string" +}, +"taxAndComplianceSettings": { +"$ref": "PurchaseOptionTaxAndComplianceSettings", +"description": "Optional. Details about taxes and legal compliance." } }, "type": "object" }, -"OfferDetails": { -"description": "Offer details information related to a purchase line item.", -"id": "OfferDetails", +"OneTimeProductPurchaseOptionNewRegionsConfig": { +"description": "Pricing information for any new regions Play may launch in the future.", +"id": "OneTimeProductPurchaseOptionNewRegionsConfig", "properties": { -"basePlanId": { -"description": "The base plan ID. Present for all base plan and offers.", -"type": "string" -}, -"offerId": { -"description": "The offer ID. Only present for discounted offers.", +"availability": { +"description": "Required. The regional availability for the new regions config. When set to AVAILABLE, the pricing information will be used for any new regions Play may launch in the future.", +"enum": [ +"AVAILABILITY_UNSPECIFIED", +"AVAILABLE", +"NO_LONGER_AVAILABLE" +], +"enumDescriptions": [ +"Unspecified availability. Must not be used.", +"The config will be used for any new regions Play may launch in the future.", +"The config is not available anymore and will not be used for any new regions Play may launch in the future. This value can only be used if the availability was previously set as AVAILABLE." +], "type": "string" }, -"offerTags": { -"description": "The latest offer tags associated with the offer. It includes tags inherited from the base plan.", -"items": { -"type": "string" +"eurPrice": { +"$ref": "Money", +"description": "Required. Price in EUR to use for any new regions Play may launch in." }, -"type": "array" +"usdPrice": { +"$ref": "Money", +"description": "Required. Price in USD to use for any new regions Play may launch in." } }, "type": "object" }, -"OfferTag": { -"description": "Represents a custom tag specified for a product offer.", -"id": "OfferTag", +"OneTimeProductPurchaseOptionRegionalPricingAndAvailabilityConfig": { +"description": "Regional pricing and availability configuration for a purchase option.", +"id": "OneTimeProductPurchaseOptionRegionalPricingAndAvailabilityConfig", "properties": { -"tag": { -"description": "Must conform with RFC-1034. That is, this string can only contain lower-case letters (a-z), numbers (0-9), and hyphens (-), and be at most 20 characters.", +"availability": { +"description": "The availability of the purchase option.", +"enum": [ +"AVAILABILITY_UNSPECIFIED", +"AVAILABLE", +"NO_LONGER_AVAILABLE", +"AVAILABLE_IF_RELEASED", +"AVAILABLE_FOR_OFFERS_ONLY" +], +"enumDescriptions": [ +"Unspecified availability. Must not be used.", +"The purchase option is available to users.", +"The purchase option is no longer available to users. This value can only be used if the availability was previously set as AVAILABLE.", +"The purchase option is initially unavailable, but made available via a released pre-order offer.", +"The purchase option is unavailable but offers linked to it (i.e. Play Points offer) are available." +], +"type": "string" +}, +"price": { +"$ref": "Money", +"description": "The price of the purchase option in the specified region. Must be set in the currency that is linked to the specified region." +}, +"regionCode": { +"description": "Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g., \"US\".", "type": "string" } }, "type": "object" }, -"OneTimeCode": { -"description": "A single use promotion code.", -"id": "OneTimeCode", -"properties": {}, +"OneTimeProductRentPurchaseOption": { +"description": "A purchase option that can be rented.", +"id": "OneTimeProductRentPurchaseOption", +"properties": { +"expirationPeriod": { +"description": "Optional. The amount of time the user has after starting consuming the entitlement before it is revoked. Specified in ISO 8601 format.", +"type": "string" +}, +"rentalPeriod": { +"description": "Required. The amount of time a user has the entitlement for. Starts at purchase flow completion. Specified in ISO 8601 format.", +"type": "string" +} +}, "type": "object" }, -"OneTimeExternalTransaction": { -"description": "Represents a one-time transaction.", -"id": "OneTimeExternalTransaction", +"OneTimeProductTaxAndComplianceSettings": { +"description": "Details about taxation, Google Play policy and legal compliance for one-time products.", +"id": "OneTimeProductTaxAndComplianceSettings", "properties": { -"externalTransactionToken": { -"description": "Input only. Provided during the call to Create. Retrieved from the client when the alternative billing flow is launched.", -"type": "string" +"isTokenizedDigitalAsset": { +"description": "Whether this one-time product is declared as a product representing a tokenized digital asset.", +"type": "boolean" +}, +"regionalTaxConfigs": { +"description": "Regional tax configuration.", +"items": { +"$ref": "RegionalTaxConfig" +}, +"type": "array" } }, "type": "object" @@ -8422,6 +10056,27 @@ false }, "type": "object" }, +"PurchaseOptionTaxAndComplianceSettings": { +"description": "Details about taxation, Google Play policy and legal compliance for one-time product purchase options.", +"id": "PurchaseOptionTaxAndComplianceSettings", +"properties": { +"withdrawalRightType": { +"description": "Optional. Digital content or service classification for products distributed to users in eligible regions. If unset, it defaults to `WITHDRAWAL_RIGHT_DIGITAL_CONTENT`. Refer to the [Help Center article](https://support.google.com/googleplay/android-developer/answer/10463498) for more information.", +"enum": [ +"WITHDRAWAL_RIGHT_TYPE_UNSPECIFIED", +"WITHDRAWAL_RIGHT_DIGITAL_CONTENT", +"WITHDRAWAL_RIGHT_SERVICE" +], +"enumDescriptions": [ +"", +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, "PurchaseStateContext": { "description": "Context about the purchase state.", "id": "PurchaseStateContext", @@ -8646,6 +10301,63 @@ false "properties": {}, "type": "object" }, +"RegionalTaxConfig": { +"description": "Details about taxation in a given geographical region.", +"id": "RegionalTaxConfig", +"properties": { +"eligibleForStreamingServiceTaxRate": { +"description": "You must tell us if your app contains streaming products to correctly charge US state and local sales tax. Field only supported in the United States.", +"type": "boolean" +}, +"regionCode": { +"description": "Required. Region code this configuration applies to, as defined by ISO 3166-2, e.g. \"US\".", +"type": "string" +}, +"streamingTaxType": { +"description": "To collect communications or amusement taxes in the United States, choose the appropriate tax category. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498#streaming_tax).", +"enum": [ +"STREAMING_TAX_TYPE_UNSPECIFIED", +"STREAMING_TAX_TYPE_TELCO_VIDEO_RENTAL", +"STREAMING_TAX_TYPE_TELCO_VIDEO_SALES", +"STREAMING_TAX_TYPE_TELCO_VIDEO_MULTI_CHANNEL", +"STREAMING_TAX_TYPE_TELCO_AUDIO_RENTAL", +"STREAMING_TAX_TYPE_TELCO_AUDIO_SALES", +"STREAMING_TAX_TYPE_TELCO_AUDIO_MULTI_CHANNEL" +], +"enumDescriptions": [ +"No telecommunications tax collected.", +"US-specific telecommunications tax tier for video streaming, on demand, rentals / subscriptions / pay-per-view.", +"US-specific telecommunications tax tier for video streaming of pre-recorded content like movies, tv shows.", +"US-specific telecommunications tax tier for video streaming of multi-channel programming.", +"US-specific telecommunications tax tier for audio streaming, rental / subscription.", +"US-specific telecommunications tax tier for audio streaming, sale / permanent download.", +"US-specific telecommunications tax tier for multi channel audio streaming like radio." +], +"type": "string" +}, +"taxTier": { +"description": "Tax tier to specify reduced tax rate. Developers who sell digital news, magazines, newspapers, books, or audiobooks in various regions may be eligible for reduced tax rates. [Learn more](https://support.google.com/googleplay/android-developer/answer/10463498).", +"enum": [ +"TAX_TIER_UNSPECIFIED", +"TAX_TIER_BOOKS_1", +"TAX_TIER_NEWS_1", +"TAX_TIER_NEWS_2", +"TAX_TIER_MUSIC_OR_AUDIO_1", +"TAX_TIER_LIVE_OR_BROADCAST_1" +], +"enumDescriptions": [ +"", +"", +"", +"", +"", +"" +], +"type": "string" +} +}, +"type": "object" +}, "RegionalTaxRateInfo": { "description": "Specified details about taxation in a given geographical region.", "id": "RegionalTaxRateInfo", @@ -10277,6 +11989,116 @@ false }, "type": "object" }, +"UpdateOneTimeProductOfferRequest": { +"description": "Request message for UpdateOneTimeProductOffer.", +"id": "UpdateOneTimeProductOfferRequest", +"properties": { +"allowMissing": { +"description": "Optional. If set to true, and the offer with the given package_name, product_id, purchase_option_id and offer_id doesn't exist, an offer will be created. If a new offer is created, the update_mask is ignored.", +"type": "boolean" +}, +"latencyTolerance": { +"description": "Optional. The latency tolerance for the propagation of this offer update. Defaults to latency-sensitive.", +"enum": [ +"PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT" +], +"enumDescriptions": [ +"Defaults to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE.", +"The update will propagate to clients within several minutes on average and up to a few hours in rare cases. Throughput is limited to 7,200 updates per app per hour.", +"The update will propagate to clients within 24 hours. Supports high throughput of up to 720,000 updates per app per hour using batch modification methods." +], +"type": "string" +}, +"oneTimeProductOffer": { +"$ref": "OneTimeProductOffer", +"description": "Required. The one-time product offer to update." +}, +"regionsVersion": { +"$ref": "RegionsVersion", +"description": "Required. The version of the available regions being used for the offer." +}, +"updateMask": { +"description": "Required. The list of fields to be updated.", +"format": "google-fieldmask", +"type": "string" +} +}, +"type": "object" +}, +"UpdateOneTimeProductOfferStateRequest": { +"description": "Request message to update the state of a one-time product offer.", +"id": "UpdateOneTimeProductOfferStateRequest", +"properties": { +"activateOneTimeProductOfferRequest": { +"$ref": "ActivateOneTimeProductOfferRequest", +"description": "Activates an offer. Once activated, the offer is available to users, as long as its conditions are met." +}, +"cancelOneTimeProductOfferRequest": { +"$ref": "CancelOneTimeProductOfferRequest", +"description": "Cancels an offer. Once cancelled, the offer is not available to users. Any pending orders related to this offer will be cancelled. This state transition is specific to pre-orders." +}, +"deactivateOneTimeProductOfferRequest": { +"$ref": "DeactivateOneTimeProductOfferRequest", +"description": "Deactivates an offer. Once deactivated, the offer is no longer available to users. This state transition is specific to discounted offers." +} +}, +"type": "object" +}, +"UpdateOneTimeProductRequest": { +"description": "Request message for UpdateOneTimeProduct.", +"id": "UpdateOneTimeProductRequest", +"properties": { +"allowMissing": { +"description": "Optional. If set to true, and the one-time product with the given package_name and product_id doesn't exist, the one-time product will be created. If a new one-time product is created, update_mask is ignored.", +"type": "boolean" +}, +"latencyTolerance": { +"description": "Optional. The latency tolerance for the propagation of this product upsert. Defaults to latency-sensitive.", +"enum": [ +"PRODUCT_UPDATE_LATENCY_TOLERANCE_UNSPECIFIED", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE", +"PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT" +], +"enumDescriptions": [ +"Defaults to PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_SENSITIVE.", +"The update will propagate to clients within several minutes on average and up to a few hours in rare cases. Throughput is limited to 7,200 updates per app per hour.", +"The update will propagate to clients within 24 hours. Supports high throughput of up to 720,000 updates per app per hour using batch modification methods." +], +"type": "string" +}, +"oneTimeProduct": { +"$ref": "OneTimeProduct", +"description": "Required. The one-time product to upsert." +}, +"regionsVersion": { +"$ref": "RegionsVersion", +"description": "Required. The version of the available regions being used for the one-time product." +}, +"updateMask": { +"description": "Required. The list of fields to be updated.", +"format": "google-fieldmask", +"type": "string" +} +}, +"type": "object" +}, +"UpdatePurchaseOptionStateRequest": { +"description": "Request message to update the state of a one-time product purchase option.", +"id": "UpdatePurchaseOptionStateRequest", +"properties": { +"activatePurchaseOptionRequest": { +"$ref": "ActivatePurchaseOptionRequest", +"description": "Activates a purchase option. Once activated, the purchase option will be available." +}, +"deactivatePurchaseOptionRequest": { +"$ref": "DeactivatePurchaseOptionRequest", +"description": "Deactivates a purchase option. Once deactivated, the purchase option will become unavailable." +} +}, +"type": "object" +}, "UpdateSubscriptionOfferRequest": { "description": "Request message for UpdateSubscriptionOffer.", "id": "UpdateSubscriptionOfferRequest", From 4e190bf42f69da9d1e7a27197b0fd52b1b25044a Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 29 Jul 2025 07:12:11 +0000 Subject: [PATCH 06/36] feat(backupdr): update the api #### backupdr:v1 The following keys were deleted: - schemas.BackupConfigInfo.properties.lastSuccessfulLogBackupConsistencyTime (Total Keys: 3) --- .../backupdr_v1.projects.locations.backupPlans.html | 8 ++++---- ...dr_v1.projects.locations.backupPlans.revisions.html | 4 ++-- ...v1.projects.locations.backupVaults.dataSources.html | 3 --- .../discovery_cache/documents/backupdr.v1.json | 10 ++-------- 4 files changed, 8 insertions(+), 17 deletions(-) diff --git a/docs/dyn/backupdr_v1.projects.locations.backupPlans.html b/docs/dyn/backupdr_v1.projects.locations.backupPlans.html index e207331c2ba..91aa317ebf2 100644 --- a/docs/dyn/backupdr_v1.projects.locations.backupPlans.html +++ b/docs/dyn/backupdr_v1.projects.locations.backupPlans.html @@ -116,7 +116,7 @@

Method Details

The object takes the form of: { # 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. + "backupRules": [ # Optional. The backup rules for this `BackupPlan`. There must be at least one `BackupRule` message if on_demand_retention_limit_days is not set. { # `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. Minimum value is 1 and maximum value is 36159 for custom retention on-demand backup. Minimum and maximum values are workload specific for all other rules. "ruleId": "A String", # Required. Immutable. The unique id of this `BackupRule`. The `rule_id` is unique per `BackupPlan`.The `rule_id` must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens. Pattern, /a-z{,62}/. @@ -246,7 +246,7 @@

Method Details

An object of the form: { # 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. + "backupRules": [ # Optional. The backup rules for this `BackupPlan`. There must be at least one `BackupRule` message if on_demand_retention_limit_days is not set. { # `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. Minimum value is 1 and maximum value is 36159 for custom retention on-demand backup. Minimum and maximum values are workload specific for all other rules. "ruleId": "A String", # Required. Immutable. The unique id of this `BackupRule`. The `rule_id` is unique per `BackupPlan`.The `rule_id` must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens. Pattern, /a-z{,62}/. @@ -316,7 +316,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 `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. + "backupRules": [ # Optional. The backup rules for this `BackupPlan`. There must be at least one `BackupRule` message if on_demand_retention_limit_days is not set. { # `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. Minimum value is 1 and maximum value is 36159 for custom retention on-demand backup. Minimum and maximum values are workload specific for all other rules. "ruleId": "A String", # Required. Immutable. The unique id of this `BackupRule`. The `rule_id` is unique per `BackupPlan`.The `rule_id` must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens. Pattern, /a-z{,62}/. @@ -395,7 +395,7 @@

Method Details

The object takes the form of: { # 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. + "backupRules": [ # Optional. The backup rules for this `BackupPlan`. There must be at least one `BackupRule` message if on_demand_retention_limit_days is not set. { # `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. Minimum value is 1 and maximum value is 36159 for custom retention on-demand backup. Minimum and maximum values are workload specific for all other rules. "ruleId": "A String", # Required. Immutable. The unique id of this `BackupRule`. The `rule_id` is unique per `BackupPlan`.The `rule_id` must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens. Pattern, /a-z{,62}/. diff --git a/docs/dyn/backupdr_v1.projects.locations.backupPlans.revisions.html b/docs/dyn/backupdr_v1.projects.locations.backupPlans.revisions.html index 2f54f2990b7..222385a7d34 100644 --- a/docs/dyn/backupdr_v1.projects.locations.backupPlans.revisions.html +++ b/docs/dyn/backupdr_v1.projects.locations.backupPlans.revisions.html @@ -108,7 +108,7 @@

Method Details

{ # `BackupPlanRevision` represents a snapshot of a `BackupPlan` at a point in time. "backupPlanSnapshot": { # 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. # The Backup Plan being encompassed by this revision. - "backupRules": [ # Required. The backup rules for this `BackupPlan`. There must be at least one `BackupRule` message. + "backupRules": [ # Optional. The backup rules for this `BackupPlan`. There must be at least one `BackupRule` message if on_demand_retention_limit_days is not set. { # `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. Minimum value is 1 and maximum value is 36159 for custom retention on-demand backup. Minimum and maximum values are workload specific for all other rules. "ruleId": "A String", # Required. Immutable. The unique id of this `BackupRule`. The `rule_id` is unique per `BackupPlan`.The `rule_id` must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens. Pattern, /a-z{,62}/. @@ -182,7 +182,7 @@

Method Details

"backupPlanRevisions": [ # The list of `BackupPlanRevisions` 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. { # `BackupPlanRevision` represents a snapshot of a `BackupPlan` at a point in time. "backupPlanSnapshot": { # 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. # The Backup Plan being encompassed by this revision. - "backupRules": [ # Required. The backup rules for this `BackupPlan`. There must be at least one `BackupRule` message. + "backupRules": [ # Optional. The backup rules for this `BackupPlan`. There must be at least one `BackupRule` message if on_demand_retention_limit_days is not set. { # `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. Minimum value is 1 and maximum value is 36159 for custom retention on-demand backup. Minimum and maximum values are workload specific for all other rules. "ruleId": "A String", # Required. Immutable. The unique id of this `BackupRule`. The `rule_id` is unique per `BackupPlan`.The `rule_id` must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens. Pattern, /a-z{,62}/. diff --git a/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.html b/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.html index 8ed187233fd..18296c299d5 100644 --- a/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.html +++ b/docs/dyn/backupdr_v1.projects.locations.backupVaults.dataSources.html @@ -284,7 +284,6 @@

Method Details

}, "lastBackupState": "A String", # Output only. The status of the last backup to this BackupVault "lastSuccessfulBackupConsistencyTime": "A String", # Output only. If the last backup were successful, this field has the consistency date. - "lastSuccessfulLogBackupConsistencyTime": "A String", # Output only. If the last log backup were successful, this field has the consistency date. }, "backupCount": "A String", # Number of backups in the data source. "configState": "A String", # Output only. The backup configuration state. @@ -415,7 +414,6 @@

Method Details

}, "lastBackupState": "A String", # Output only. The status of the last backup to this BackupVault "lastSuccessfulBackupConsistencyTime": "A String", # Output only. If the last backup were successful, this field has the consistency date. - "lastSuccessfulLogBackupConsistencyTime": "A String", # Output only. If the last log backup were successful, this field has the consistency date. }, "backupCount": "A String", # Number of backups in the data source. "configState": "A String", # Output only. The backup configuration state. @@ -526,7 +524,6 @@

Method Details

}, "lastBackupState": "A String", # Output only. The status of the last backup to this BackupVault "lastSuccessfulBackupConsistencyTime": "A String", # Output only. If the last backup were successful, this field has the consistency date. - "lastSuccessfulLogBackupConsistencyTime": "A String", # Output only. If the last log backup were successful, this field has the consistency date. }, "backupCount": "A String", # Number of backups in the data source. "configState": "A String", # Output only. The backup configuration state. diff --git a/googleapiclient/discovery_cache/documents/backupdr.v1.json b/googleapiclient/discovery_cache/documents/backupdr.v1.json index 2e99bc668a2..5407335cd73 100644 --- a/googleapiclient/discovery_cache/documents/backupdr.v1.json +++ b/googleapiclient/discovery_cache/documents/backupdr.v1.json @@ -2060,7 +2060,7 @@ } } }, -"revision": "20250711", +"revision": "20250720", "rootUrl": "https://backupdr.googleapis.com/", "schemas": { "AbandonBackupRequest": { @@ -2791,12 +2791,6 @@ "format": "google-datetime", "readOnly": true, "type": "string" -}, -"lastSuccessfulLogBackupConsistencyTime": { -"description": "Output only. If the last log backup were successful, this field has the consistency date.", -"format": "google-datetime", -"readOnly": true, -"type": "string" } }, "type": "object" @@ -2905,7 +2899,7 @@ "id": "BackupPlan", "properties": { "backupRules": { -"description": "Required. The backup rules for this `BackupPlan`. There must be at least one `BackupRule` message.", +"description": "Optional. The backup rules for this `BackupPlan`. There must be at least one `BackupRule` message if on_demand_retention_limit_days is not set.", "items": { "$ref": "BackupRule" }, From 3ce3b052af75b07ba04dde5e2245f0efb179795a Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 29 Jul 2025 07:12:11 +0000 Subject: [PATCH 07/36] feat(bigquery): update the api #### bigquery:v2 The following keys were added: - schemas.ExternalServiceCost.properties.billingMethod.type (Total Keys: 1) - schemas.JobStatistics2.properties.totalServicesSkuSlotMs (Total Keys: 3) --- docs/dyn/bigquery_v2.jobs.html | 10 ++++++++++ .../discovery_cache/documents/bigquery.v2.json | 12 +++++++++++- 2 files changed, 21 insertions(+), 1 deletion(-) diff --git a/docs/dyn/bigquery_v2.jobs.html b/docs/dyn/bigquery_v2.jobs.html index 61c0150dfab..3e245a2797f 100644 --- a/docs/dyn/bigquery_v2.jobs.html +++ b/docs/dyn/bigquery_v2.jobs.html @@ -697,6 +697,7 @@

Method Details

}, "externalServiceCosts": [ # Output only. Job cost breakdown as bigquery internal cost and external service costs. { # The external service cost is a portion of the total cost, these costs are not additive with total_bytes_billed. Moreover, this field only track external service costs that will show up as BigQuery costs (e.g. training BigQuery ML job with google cloud CAIP or Automl Tables services), not other costs which may be accrued by running the query (e.g. reading from Bigtable or Cloud Storage). The external service costs with different billing sku (e.g. CAIP job is charged based on VM usage) are converted to BigQuery billed_bytes and slot_ms with equivalent amount of US dollars. Services may not directly correlate to these metrics, but these are the equivalents for billing purposes. Output only. + "billingMethod": "A String", # The billing method used for the external job. This field is only used when billed on the services sku, set to "SERVICES_SKU". Otherwise, it is unspecified for backward compatibility. "bytesBilled": "A String", # External service cost in terms of bigquery bytes billed. "bytesProcessed": "A String", # External service cost in terms of bigquery bytes processed. "externalService": "A String", # External service name. @@ -1424,6 +1425,7 @@

Method Details

"totalBytesProcessed": "A String", # Output only. Total bytes processed for the job. "totalBytesProcessedAccuracy": "A String", # Output only. For dry-run jobs, totalBytesProcessed is an estimate and this field specifies the accuracy of the estimate. Possible values can be: UNKNOWN: accuracy of the estimate is unknown. PRECISE: estimate is precise. LOWER_BOUND: estimate is lower bound of what the query would cost. UPPER_BOUND: estimate is upper bound of what the query would cost. "totalPartitionsProcessed": "A String", # Output only. Total number of partitions processed from all partitioned tables referenced in the job. + "totalServicesSkuSlotMs": "A String", # Output only. Total slot-milliseconds for the job that run on external services and billed on the service SKU. This field is only populated for jobs that have external service costs, and is the total of the usage for costs whose billing method is "SERVICES_SKU". "totalSlotMs": "A String", # Output only. Slot-milliseconds for the job. "transferredBytes": "A String", # Output only. Total bytes transferred for cross-cloud queries such as Cross Cloud Transfer and CREATE TABLE AS SELECT (CTAS). "undeclaredQueryParameters": [ # Output only. GoogleSQL only: list of undeclared query parameters detected during a dry run validation. @@ -2161,6 +2163,7 @@

Method Details

}, "externalServiceCosts": [ # Output only. Job cost breakdown as bigquery internal cost and external service costs. { # The external service cost is a portion of the total cost, these costs are not additive with total_bytes_billed. Moreover, this field only track external service costs that will show up as BigQuery costs (e.g. training BigQuery ML job with google cloud CAIP or Automl Tables services), not other costs which may be accrued by running the query (e.g. reading from Bigtable or Cloud Storage). The external service costs with different billing sku (e.g. CAIP job is charged based on VM usage) are converted to BigQuery billed_bytes and slot_ms with equivalent amount of US dollars. Services may not directly correlate to these metrics, but these are the equivalents for billing purposes. Output only. + "billingMethod": "A String", # The billing method used for the external job. This field is only used when billed on the services sku, set to "SERVICES_SKU". Otherwise, it is unspecified for backward compatibility. "bytesBilled": "A String", # External service cost in terms of bigquery bytes billed. "bytesProcessed": "A String", # External service cost in terms of bigquery bytes processed. "externalService": "A String", # External service name. @@ -2888,6 +2891,7 @@

Method Details

"totalBytesProcessed": "A String", # Output only. Total bytes processed for the job. "totalBytesProcessedAccuracy": "A String", # Output only. For dry-run jobs, totalBytesProcessed is an estimate and this field specifies the accuracy of the estimate. Possible values can be: UNKNOWN: accuracy of the estimate is unknown. PRECISE: estimate is precise. LOWER_BOUND: estimate is lower bound of what the query would cost. UPPER_BOUND: estimate is upper bound of what the query would cost. "totalPartitionsProcessed": "A String", # Output only. Total number of partitions processed from all partitioned tables referenced in the job. + "totalServicesSkuSlotMs": "A String", # Output only. Total slot-milliseconds for the job that run on external services and billed on the service SKU. This field is only populated for jobs that have external service costs, and is the total of the usage for costs whose billing method is "SERVICES_SKU". "totalSlotMs": "A String", # Output only. Slot-milliseconds for the job. "transferredBytes": "A String", # Output only. Total bytes transferred for cross-cloud queries such as Cross Cloud Transfer and CREATE TABLE AS SELECT (CTAS). "undeclaredQueryParameters": [ # Output only. GoogleSQL only: list of undeclared query parameters detected during a dry run validation. @@ -3706,6 +3710,7 @@

Method Details

}, "externalServiceCosts": [ # Output only. Job cost breakdown as bigquery internal cost and external service costs. { # The external service cost is a portion of the total cost, these costs are not additive with total_bytes_billed. Moreover, this field only track external service costs that will show up as BigQuery costs (e.g. training BigQuery ML job with google cloud CAIP or Automl Tables services), not other costs which may be accrued by running the query (e.g. reading from Bigtable or Cloud Storage). The external service costs with different billing sku (e.g. CAIP job is charged based on VM usage) are converted to BigQuery billed_bytes and slot_ms with equivalent amount of US dollars. Services may not directly correlate to these metrics, but these are the equivalents for billing purposes. Output only. + "billingMethod": "A String", # The billing method used for the external job. This field is only used when billed on the services sku, set to "SERVICES_SKU". Otherwise, it is unspecified for backward compatibility. "bytesBilled": "A String", # External service cost in terms of bigquery bytes billed. "bytesProcessed": "A String", # External service cost in terms of bigquery bytes processed. "externalService": "A String", # External service name. @@ -4433,6 +4438,7 @@

Method Details

"totalBytesProcessed": "A String", # Output only. Total bytes processed for the job. "totalBytesProcessedAccuracy": "A String", # Output only. For dry-run jobs, totalBytesProcessed is an estimate and this field specifies the accuracy of the estimate. Possible values can be: UNKNOWN: accuracy of the estimate is unknown. PRECISE: estimate is precise. LOWER_BOUND: estimate is lower bound of what the query would cost. UPPER_BOUND: estimate is upper bound of what the query would cost. "totalPartitionsProcessed": "A String", # Output only. Total number of partitions processed from all partitioned tables referenced in the job. + "totalServicesSkuSlotMs": "A String", # Output only. Total slot-milliseconds for the job that run on external services and billed on the service SKU. This field is only populated for jobs that have external service costs, and is the total of the usage for costs whose billing method is "SERVICES_SKU". "totalSlotMs": "A String", # Output only. Slot-milliseconds for the job. "transferredBytes": "A String", # Output only. Total bytes transferred for cross-cloud queries such as Cross Cloud Transfer and CREATE TABLE AS SELECT (CTAS). "undeclaredQueryParameters": [ # Output only. GoogleSQL only: list of undeclared query parameters detected during a dry run validation. @@ -5141,6 +5147,7 @@

Method Details

}, "externalServiceCosts": [ # Output only. Job cost breakdown as bigquery internal cost and external service costs. { # The external service cost is a portion of the total cost, these costs are not additive with total_bytes_billed. Moreover, this field only track external service costs that will show up as BigQuery costs (e.g. training BigQuery ML job with google cloud CAIP or Automl Tables services), not other costs which may be accrued by running the query (e.g. reading from Bigtable or Cloud Storage). The external service costs with different billing sku (e.g. CAIP job is charged based on VM usage) are converted to BigQuery billed_bytes and slot_ms with equivalent amount of US dollars. Services may not directly correlate to these metrics, but these are the equivalents for billing purposes. Output only. + "billingMethod": "A String", # The billing method used for the external job. This field is only used when billed on the services sku, set to "SERVICES_SKU". Otherwise, it is unspecified for backward compatibility. "bytesBilled": "A String", # External service cost in terms of bigquery bytes billed. "bytesProcessed": "A String", # External service cost in terms of bigquery bytes processed. "externalService": "A String", # External service name. @@ -5868,6 +5875,7 @@

Method Details

"totalBytesProcessed": "A String", # Output only. Total bytes processed for the job. "totalBytesProcessedAccuracy": "A String", # Output only. For dry-run jobs, totalBytesProcessed is an estimate and this field specifies the accuracy of the estimate. Possible values can be: UNKNOWN: accuracy of the estimate is unknown. PRECISE: estimate is precise. LOWER_BOUND: estimate is lower bound of what the query would cost. UPPER_BOUND: estimate is upper bound of what the query would cost. "totalPartitionsProcessed": "A String", # Output only. Total number of partitions processed from all partitioned tables referenced in the job. + "totalServicesSkuSlotMs": "A String", # Output only. Total slot-milliseconds for the job that run on external services and billed on the service SKU. This field is only populated for jobs that have external service costs, and is the total of the usage for costs whose billing method is "SERVICES_SKU". "totalSlotMs": "A String", # Output only. Slot-milliseconds for the job. "transferredBytes": "A String", # Output only. Total bytes transferred for cross-cloud queries such as Cross Cloud Transfer and CREATE TABLE AS SELECT (CTAS). "undeclaredQueryParameters": [ # Output only. GoogleSQL only: list of undeclared query parameters detected during a dry run validation. @@ -6601,6 +6609,7 @@

Method Details

}, "externalServiceCosts": [ # Output only. Job cost breakdown as bigquery internal cost and external service costs. { # The external service cost is a portion of the total cost, these costs are not additive with total_bytes_billed. Moreover, this field only track external service costs that will show up as BigQuery costs (e.g. training BigQuery ML job with google cloud CAIP or Automl Tables services), not other costs which may be accrued by running the query (e.g. reading from Bigtable or Cloud Storage). The external service costs with different billing sku (e.g. CAIP job is charged based on VM usage) are converted to BigQuery billed_bytes and slot_ms with equivalent amount of US dollars. Services may not directly correlate to these metrics, but these are the equivalents for billing purposes. Output only. + "billingMethod": "A String", # The billing method used for the external job. This field is only used when billed on the services sku, set to "SERVICES_SKU". Otherwise, it is unspecified for backward compatibility. "bytesBilled": "A String", # External service cost in terms of bigquery bytes billed. "bytesProcessed": "A String", # External service cost in terms of bigquery bytes processed. "externalService": "A String", # External service name. @@ -7328,6 +7337,7 @@

Method Details

"totalBytesProcessed": "A String", # Output only. Total bytes processed for the job. "totalBytesProcessedAccuracy": "A String", # Output only. For dry-run jobs, totalBytesProcessed is an estimate and this field specifies the accuracy of the estimate. Possible values can be: UNKNOWN: accuracy of the estimate is unknown. PRECISE: estimate is precise. LOWER_BOUND: estimate is lower bound of what the query would cost. UPPER_BOUND: estimate is upper bound of what the query would cost. "totalPartitionsProcessed": "A String", # Output only. Total number of partitions processed from all partitioned tables referenced in the job. + "totalServicesSkuSlotMs": "A String", # Output only. Total slot-milliseconds for the job that run on external services and billed on the service SKU. This field is only populated for jobs that have external service costs, and is the total of the usage for costs whose billing method is "SERVICES_SKU". "totalSlotMs": "A String", # Output only. Slot-milliseconds for the job. "transferredBytes": "A String", # Output only. Total bytes transferred for cross-cloud queries such as Cross Cloud Transfer and CREATE TABLE AS SELECT (CTAS). "undeclaredQueryParameters": [ # Output only. GoogleSQL only: list of undeclared query parameters detected during a dry run validation. diff --git a/googleapiclient/discovery_cache/documents/bigquery.v2.json b/googleapiclient/discovery_cache/documents/bigquery.v2.json index 23513b215aa..4522c186e18 100644 --- a/googleapiclient/discovery_cache/documents/bigquery.v2.json +++ b/googleapiclient/discovery_cache/documents/bigquery.v2.json @@ -2345,7 +2345,7 @@ } } }, -"revision": "20250615", +"revision": "20250706", "rootUrl": "https://bigquery.googleapis.com/", "schemas": { "AggregateClassificationMetrics": { @@ -4637,6 +4637,10 @@ "description": "The external service cost is a portion of the total cost, these costs are not additive with total_bytes_billed. Moreover, this field only track external service costs that will show up as BigQuery costs (e.g. training BigQuery ML job with google cloud CAIP or Automl Tables services), not other costs which may be accrued by running the query (e.g. reading from Bigtable or Cloud Storage). The external service costs with different billing sku (e.g. CAIP job is charged based on VM usage) are converted to BigQuery billed_bytes and slot_ms with equivalent amount of US dollars. Services may not directly correlate to these metrics, but these are the equivalents for billing purposes. Output only.", "id": "ExternalServiceCost", "properties": { +"billingMethod": { +"description": "The billing method used for the external job. This field is only used when billed on the services sku, set to \"SERVICES_SKU\". Otherwise, it is unspecified for backward compatibility.", +"type": "string" +}, "bytesBilled": { "description": "External service cost in terms of bigquery bytes billed.", "format": "int64", @@ -6439,6 +6443,12 @@ "readOnly": true, "type": "string" }, +"totalServicesSkuSlotMs": { +"description": "Output only. Total slot-milliseconds for the job that run on external services and billed on the service SKU. This field is only populated for jobs that have external service costs, and is the total of the usage for costs whose billing method is \"SERVICES_SKU\".", +"format": "int64", +"readOnly": true, +"type": "string" +}, "totalSlotMs": { "description": "Output only. Slot-milliseconds for the job.", "format": "int64", From bfa825635e39f72bb4be058b3608479cb1c231d1 Mon Sep 17 00:00:00 2001 From: Yoshi Automation Date: Tue, 29 Jul 2025 07:12:11 +0000 Subject: [PATCH 08/36] feat(chat): update the api #### chat:v1 The following keys were added: - schemas.CalendarEventLinkData (Total Keys: 4) - schemas.MeetSpaceLinkData (Total Keys: 6) - schemas.RichLinkMetadata.properties.calendarEventLinkData.$ref (Total Keys: 1) - schemas.RichLinkMetadata.properties.meetSpaceLinkData.$ref (Total Keys: 1) - schemas.Space.properties.customer.type (Total Keys: 1) --- docs/dyn/chat_v1.spaces.html | 11 + docs/dyn/chat_v1.spaces.members.html | 8 +- docs/dyn/chat_v1.spaces.messages.html | 144 +++++++++--- docs/dyn/chat_v1.spaces.spaceEvents.html | 220 ++++++++++++++---- .../discovery_cache/documents/chat.v1.json | 91 +++++++- 5 files changed, 381 insertions(+), 93 deletions(-) diff --git a/docs/dyn/chat_v1.spaces.html b/docs/dyn/chat_v1.spaces.html index c9d0ce3341c..33de22dc5e4 100644 --- a/docs/dyn/chat_v1.spaces.html +++ b/docs/dyn/chat_v1.spaces.html @@ -159,6 +159,7 @@

Method Details

}, "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging. "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`. + "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview). "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters. "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only. "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). @@ -234,6 +235,7 @@

Method Details

}, "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging. "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`. + "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview). "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters. "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only. "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). @@ -308,6 +310,7 @@

Method Details

}, "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging. "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`. + "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview). "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters. "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only. "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). @@ -407,6 +410,7 @@

Method Details

}, "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging. "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`. + "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview). "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters. "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only. "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). @@ -488,6 +492,7 @@

Method Details

}, "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging. "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`. + "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview). "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters. "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only. "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). @@ -573,6 +578,7 @@

Method Details

}, "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging. "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`. + "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview). "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters. "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only. "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). @@ -664,6 +670,7 @@

Method Details

}, "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging. "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`. + "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview). "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters. "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only. "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). @@ -739,6 +746,7 @@

Method Details

}, "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging. "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`. + "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview). "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters. "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only. "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). @@ -826,6 +834,7 @@

Method Details

}, "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging. "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`. + "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview). "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters. "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only. "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). @@ -938,6 +947,7 @@

Method Details

}, "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging. "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`. + "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview). "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters. "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only. "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). @@ -1012,6 +1022,7 @@

Method Details

}, "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging. "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`. + "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview). "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters. "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only. "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user). diff --git a/docs/dyn/chat_v1.spaces.members.html b/docs/dyn/chat_v1.spaces.members.html index 683b39283eb..0b018530209 100644 --- a/docs/dyn/chat_v1.spaces.members.html +++ b/docs/dyn/chat_v1.spaces.members.html @@ -85,10 +85,10 @@

Instance Methods

Deletes a membership. For an example, see [Remove a user or a Google Chat app from a space](https://developers.google.com/workspace/chat/delete-members). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with [administrator approval](https://support.google.com/a?p=chat-app-auth) in [Developer Preview](https://developers.google.com/workspace/preview) and the authorization scope: - `https://www.googleapis.com/auth/chat.app.memberships` - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.memberships` - `https://www.googleapis.com/auth/chat.memberships.app` (to remove the calling app from the space) - `https://www.googleapis.com/auth/chat.import` (import mode spaces only) - User authentication grants administrator privileges when an administrator account authenticates, `use_admin_access` is `true`, and the following authorization scope is used: - `https://www.googleapis.com/auth/chat.admin.memberships` App authentication is not supported for the following use cases: - Removing a Google Group from a space. - Removing a Chat app from a space. To delete memberships for space managers, the requester must be a space manager. If you're using [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) the Chat app must be the space creator.

get(name, useAdminAccess=None, x__xgafv=None)

-

Returns details about a membership. For an example, see [Get details about a user's or Google Chat app's membership](https://developers.google.com/workspace/chat/get-members). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with the authorization scope: - `https://www.googleapis.com/auth/chat.bot` - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.memberships.readonly` - `https://www.googleapis.com/auth/chat.memberships` - User authentication grants administrator privileges when an administrator account authenticates, `use_admin_access` is `true`, and one of the following authorization scopes is used: - `https://www.googleapis.com/auth/chat.admin.memberships.readonly` - `https://www.googleapis.com/auth/chat.admin.memberships`

+

Returns details about a membership. For an example, see [Get details about a user's or Google Chat app's membership](https://developers.google.com/workspace/chat/get-members). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.bot` - `https://www.googleapis.com/auth/chat.app.memberships` (requires [administrator approval](https://support.google.com/a?p=chat-app-auth)) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.memberships.readonly` - `https://www.googleapis.com/auth/chat.memberships` - User authentication grants administrator privileges when an administrator account authenticates, `use_admin_access` is `true`, and one of the following authorization scopes is used: - `https://www.googleapis.com/auth/chat.admin.memberships.readonly` - `https://www.googleapis.com/auth/chat.admin.memberships`

list(parent, filter=None, pageSize=None, pageToken=None, showGroups=None, showInvited=None, useAdminAccess=None, x__xgafv=None)

-

Lists memberships in a space. For an example, see [List users and Google Chat apps in a space](https://developers.google.com/workspace/chat/list-members). Listing memberships with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) lists memberships in spaces that the authenticated user has access to. Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with the authorization scope: - `https://www.googleapis.com/auth/chat.bot` - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.memberships.readonly` - `https://www.googleapis.com/auth/chat.memberships` - `https://www.googleapis.com/auth/chat.import` (import mode spaces only) - User authentication grants administrator privileges when an administrator account authenticates, `use_admin_access` is `true`, and one of the following authorization scopes is used: - `https://www.googleapis.com/auth/chat.admin.memberships.readonly` - `https://www.googleapis.com/auth/chat.admin.memberships`

+

Lists memberships in a space. For an example, see [List users and Google Chat apps in a space](https://developers.google.com/workspace/chat/list-members). Listing memberships with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) lists memberships in spaces that the authenticated user has access to. Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.bot` - `https://www.googleapis.com/auth/chat.app.memberships` (requires [administrator approval](https://support.google.com/a?p=chat-app-auth)) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.memberships.readonly` - `https://www.googleapis.com/auth/chat.memberships` - `https://www.googleapis.com/auth/chat.import` (import mode spaces only) - User authentication grants administrator privileges when an administrator account authenticates, `use_admin_access` is `true`, and one of the following authorization scopes is used: - `https://www.googleapis.com/auth/chat.admin.memberships.readonly` - `https://www.googleapis.com/auth/chat.admin.memberships`

list_next()

Retrieves the next page of results.

@@ -192,7 +192,7 @@

Method Details

get(name, useAdminAccess=None, x__xgafv=None) - 
Returns details about a membership. For an example, see [Get details about a user's or Google Chat app's membership](https://developers.google.com/workspace/chat/get-members). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with the authorization scope: - `https://www.googleapis.com/auth/chat.bot` - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.memberships.readonly` - `https://www.googleapis.com/auth/chat.memberships` - User authentication grants administrator privileges when an administrator account authenticates, `use_admin_access` is `true`, and one of the following authorization scopes is used: - `https://www.googleapis.com/auth/chat.admin.memberships.readonly` - `https://www.googleapis.com/auth/chat.admin.memberships`
+  
Returns details about a membership. For an example, see [Get details about a user's or Google Chat app's membership](https://developers.google.com/workspace/chat/get-members). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.bot` - `https://www.googleapis.com/auth/chat.app.memberships` (requires [administrator approval](https://support.google.com/a?p=chat-app-auth)) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.memberships.readonly` - `https://www.googleapis.com/auth/chat.memberships` - User authentication grants administrator privileges when an administrator account authenticates, `use_admin_access` is `true`, and one of the following authorization scopes is used: - `https://www.googleapis.com/auth/chat.admin.memberships.readonly` - `https://www.googleapis.com/auth/chat.admin.memberships`
 
 Args:
   name: string, Required. Resource name of the membership to retrieve. To get the app's own membership [by using user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user), you can optionally use `spaces/{space}/members/app`. Format: `spaces/{space}/members/{member}` or `spaces/{space}/members/app` You can use the user's email as an alias for `{member}`. For example, `spaces/{space}/members/example@gmail.com` where `example@gmail.com` is the email of the Google Chat user. (required)
@@ -226,7 +226,7 @@ 
Method Details

 
 

     list(parent, filter=None, pageSize=None, pageToken=None, showGroups=None, showInvited=None, useAdminAccess=None, x__xgafv=None)
-  
Lists memberships in a space. For an example, see [List users and Google Chat apps in a space](https://developers.google.com/workspace/chat/list-members). Listing memberships with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) lists memberships in spaces that the authenticated user has access to. Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with the authorization scope: - `https://www.googleapis.com/auth/chat.bot` - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.memberships.readonly` - `https://www.googleapis.com/auth/chat.memberships` - `https://www.googleapis.com/auth/chat.import` (import mode spaces only) - User authentication grants administrator privileges when an administrator account authenticates, `use_admin_access` is `true`, and one of the following authorization scopes is used: - `https://www.googleapis.com/auth/chat.admin.memberships.readonly` - `https://www.googleapis.com/auth/chat.admin.memberships`
+  
Lists memberships in a space. For an example, see [List users and Google Chat apps in a space](https://developers.google.com/workspace/chat/list-members). Listing memberships with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) lists memberships in spaces that the authenticated user has access to. Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.bot` - `https://www.googleapis.com/auth/chat.app.memberships` (requires [administrator approval](https://support.google.com/a?p=chat-app-auth)) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.memberships.readonly` - `https://www.googleapis.com/auth/chat.memberships` - `https://www.googleapis.com/auth/chat.import` (import mode spaces only) - User authentication grants administrator privileges when an administrator account authenticates, `use_admin_access` is `true`, and one of the following authorization scopes is used: - `https://www.googleapis.com/auth/chat.admin.memberships.readonly` - `https://www.googleapis.com/auth/chat.admin.memberships`
 
 Args:
   parent: string, Required. The resource name of the space for which to fetch a membership list. Format: spaces/{space} (required)
diff --git a/docs/dyn/chat_v1.spaces.messages.html b/docs/dyn/chat_v1.spaces.messages.html
index fd3955ac318..ec12d73177d 100644
--- a/docs/dyn/chat_v1.spaces.messages.html
+++ b/docs/dyn/chat_v1.spaces.messages.html
@@ -1446,8 +1446,8 @@ 
Method Details

     },
     "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
   },
-  "annotations": [ # Output only. Annotations associated with the `text` in this message.
-    { # 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" } }] ```
+  "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+    { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
       "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
         "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
           "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -1460,8 +1460,12 @@ 
Method Details

           "uid": "A String", # Output only. Unique key for the custom emoji resource.
         },
       },
-      "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.
+      "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+      "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+        "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+          "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+          "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+        },
         "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}`
@@ -1473,6 +1477,11 @@ 
Method Details

           },
           "mimeType": "A String", # The mime type of the linked Google Drive resource.
         },
+        "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+          "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+          "meetingCode": "A String", # Meeting code of the linked Meet space.
+          "type": "A String", # Indicates the type of the Meet space.
+        },
         "richLinkType": "A String", # The rich link type.
         "uri": "A String", # The URI of this link.
       },
@@ -2352,6 +2361,7 @@ 
Method Details

     },
     "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
     "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+    "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
     "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
     "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
     "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -3756,8 +3766,8 @@ 
Method Details

     },
     "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
   },
-  "annotations": [ # Output only. Annotations associated with the `text` in this message.
-    { # 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" } }] ```
+  "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+    { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
       "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
         "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
           "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -3770,8 +3780,12 @@ 
Method Details

           "uid": "A String", # Output only. Unique key for the custom emoji resource.
         },
       },
-      "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.
+      "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+      "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+        "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+          "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+          "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+        },
         "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}`
@@ -3783,6 +3797,11 @@ 
Method Details

           },
           "mimeType": "A String", # The mime type of the linked Google Drive resource.
         },
+        "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+          "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+          "meetingCode": "A String", # Meeting code of the linked Meet space.
+          "type": "A String", # Indicates the type of the Meet space.
+        },
         "richLinkType": "A String", # The rich link type.
         "uri": "A String", # The URI of this link.
       },
@@ -4662,6 +4681,7 @@ 
Method Details

     },
     "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
     "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+    "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
     "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
     "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
     "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -6084,8 +6104,8 @@ 
Method Details

     },
     "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
   },
-  "annotations": [ # Output only. Annotations associated with the `text` in this message.
-    { # 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" } }] ```
+  "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+    { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
       "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
         "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
           "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -6098,8 +6118,12 @@ 
Method Details

           "uid": "A String", # Output only. Unique key for the custom emoji resource.
         },
       },
-      "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.
+      "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+      "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+        "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+          "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+          "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+        },
         "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}`
@@ -6111,6 +6135,11 @@ 
Method Details

           },
           "mimeType": "A String", # The mime type of the linked Google Drive resource.
         },
+        "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+          "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+          "meetingCode": "A String", # Meeting code of the linked Meet space.
+          "type": "A String", # Indicates the type of the Meet space.
+        },
         "richLinkType": "A String", # The rich link type.
         "uri": "A String", # The URI of this link.
       },
@@ -6990,6 +7019,7 @@ 
Method Details

     },
     "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
     "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+    "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
     "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
     "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
     "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -8400,8 +8430,8 @@ 
Method Details

         },
         "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
       },
-      "annotations": [ # Output only. Annotations associated with the `text` in this message.
-        { # 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" } }] ```
+      "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+        { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
           "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
             "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
               "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -8414,8 +8444,12 @@ 
Method Details

               "uid": "A String", # Output only. Unique key for the custom emoji resource.
             },
           },
-          "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.
+          "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+          "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+            "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+              "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+              "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+            },
             "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}`
@@ -8427,6 +8461,11 @@ 
Method Details

               },
               "mimeType": "A String", # The mime type of the linked Google Drive resource.
             },
+            "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+              "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+              "meetingCode": "A String", # Meeting code of the linked Meet space.
+              "type": "A String", # Indicates the type of the Meet space.
+            },
             "richLinkType": "A String", # The rich link type.
             "uri": "A String", # The URI of this link.
           },
@@ -9306,6 +9345,7 @@ 
Method Details

         },
         "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
         "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+        "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
         "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
         "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
         "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -10721,8 +10761,8 @@ 
Method Details

     },
     "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
   },
-  "annotations": [ # Output only. Annotations associated with the `text` in this message.
-    { # 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" } }] ```
+  "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+    { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
       "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
         "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
           "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -10735,8 +10775,12 @@ 
Method Details

           "uid": "A String", # Output only. Unique key for the custom emoji resource.
         },
       },
-      "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.
+      "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+      "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+        "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+          "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+          "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+        },
         "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}`
@@ -10748,6 +10792,11 @@ 
Method Details

           },
           "mimeType": "A String", # The mime type of the linked Google Drive resource.
         },
+        "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+          "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+          "meetingCode": "A String", # Meeting code of the linked Meet space.
+          "type": "A String", # Indicates the type of the Meet space.
+        },
         "richLinkType": "A String", # The rich link type.
         "uri": "A String", # The URI of this link.
       },
@@ -11627,6 +11676,7 @@ 
Method Details

     },
     "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
     "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+    "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
     "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
     "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
     "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -13025,8 +13075,8 @@ 
Method Details

     },
     "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
   },
-  "annotations": [ # Output only. Annotations associated with the `text` in this message.
-    { # 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" } }] ```
+  "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+    { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
       "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
         "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
           "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -13039,8 +13089,12 @@ 
Method Details

           "uid": "A String", # Output only. Unique key for the custom emoji resource.
         },
       },
-      "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.
+      "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+      "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+        "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+          "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+          "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+        },
         "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}`
@@ -13052,6 +13106,11 @@ 
Method Details

           },
           "mimeType": "A String", # The mime type of the linked Google Drive resource.
         },
+        "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+          "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+          "meetingCode": "A String", # Meeting code of the linked Meet space.
+          "type": "A String", # Indicates the type of the Meet space.
+        },
         "richLinkType": "A String", # The rich link type.
         "uri": "A String", # The URI of this link.
       },
@@ -13931,6 +13990,7 @@ 
Method Details

     },
     "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
     "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+    "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
     "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
     "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
     "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -15329,8 +15389,8 @@ 
Method Details

     },
     "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
   },
-  "annotations": [ # Output only. Annotations associated with the `text` in this message.
-    { # 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" } }] ```
+  "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+    { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
       "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
         "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
           "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -15343,8 +15403,12 @@ 
Method Details

           "uid": "A String", # Output only. Unique key for the custom emoji resource.
         },
       },
-      "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.
+      "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+      "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+        "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+          "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+          "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+        },
         "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}`
@@ -15356,6 +15420,11 @@ 
Method Details

           },
           "mimeType": "A String", # The mime type of the linked Google Drive resource.
         },
+        "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+          "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+          "meetingCode": "A String", # Meeting code of the linked Meet space.
+          "type": "A String", # Indicates the type of the Meet space.
+        },
         "richLinkType": "A String", # The rich link type.
         "uri": "A String", # The URI of this link.
       },
@@ -16235,6 +16304,7 @@ 
Method Details

     },
     "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
     "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+    "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
     "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
     "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
     "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -17633,8 +17703,8 @@ 
Method Details

     },
     "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
   },
-  "annotations": [ # Output only. Annotations associated with the `text` in this message.
-    { # 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" } }] ```
+  "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+    { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
       "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
         "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
           "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -17647,8 +17717,12 @@ 
Method Details

           "uid": "A String", # Output only. Unique key for the custom emoji resource.
         },
       },
-      "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.
+      "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+      "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+        "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+          "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+          "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+        },
         "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}`
@@ -17660,6 +17734,11 @@ 
Method Details

           },
           "mimeType": "A String", # The mime type of the linked Google Drive resource.
         },
+        "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+          "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+          "meetingCode": "A String", # Meeting code of the linked Meet space.
+          "type": "A String", # Indicates the type of the Meet space.
+        },
         "richLinkType": "A String", # The rich link type.
         "uri": "A String", # The URI of this link.
       },
@@ -18539,6 +18618,7 @@ 
Method Details

     },
     "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
     "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+    "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
     "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
     "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
     "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
diff --git a/docs/dyn/chat_v1.spaces.spaceEvents.html b/docs/dyn/chat_v1.spaces.spaceEvents.html
index 912a1caca16..c943e23ea5f 100644
--- a/docs/dyn/chat_v1.spaces.spaceEvents.html
+++ b/docs/dyn/chat_v1.spaces.spaceEvents.html
@@ -1561,8 +1561,8 @@ 
Method Details

             },
             "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
           },
-          "annotations": [ # Output only. Annotations associated with the `text` in this message.
-            { # 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" } }] ```
+          "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+            { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
               "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
                 "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
                   "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -1575,8 +1575,12 @@ 
Method Details

                   "uid": "A String", # Output only. Unique key for the custom emoji resource.
                 },
               },
-              "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.
+              "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+              "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+                "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+                  "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+                  "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+                },
                 "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}`
@@ -1588,6 +1592,11 @@ 
Method Details

                   },
                   "mimeType": "A String", # The mime type of the linked Google Drive resource.
                 },
+                "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+                  "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+                  "meetingCode": "A String", # Meeting code of the linked Meet space.
+                  "type": "A String", # Indicates the type of the Meet space.
+                },
                 "richLinkType": "A String", # The rich link type.
                 "uri": "A String", # The URI of this link.
               },
@@ -2467,6 +2476,7 @@ 
Method Details

             },
             "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
             "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+            "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
             "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
             "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
             "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -3860,8 +3870,8 @@ 
Method Details

             },
             "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
           },
-          "annotations": [ # Output only. Annotations associated with the `text` in this message.
-            { # 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" } }] ```
+          "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+            { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
               "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
                 "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
                   "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -3874,8 +3884,12 @@ 
Method Details

                   "uid": "A String", # Output only. Unique key for the custom emoji resource.
                 },
               },
-              "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.
+              "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+              "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+                "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+                  "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+                  "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+                },
                 "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}`
@@ -3887,6 +3901,11 @@ 
Method Details

                   },
                   "mimeType": "A String", # The mime type of the linked Google Drive resource.
                 },
+                "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+                  "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+                  "meetingCode": "A String", # Meeting code of the linked Meet space.
+                  "type": "A String", # Indicates the type of the Meet space.
+                },
                 "richLinkType": "A String", # The rich link type.
                 "uri": "A String", # The URI of this link.
               },
@@ -4766,6 +4785,7 @@ 
Method Details

             },
             "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
             "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+            "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
             "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
             "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
             "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -6159,8 +6179,8 @@ 
Method Details

             },
             "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
           },
-          "annotations": [ # Output only. Annotations associated with the `text` in this message.
-            { # 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" } }] ```
+          "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+            { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
               "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
                 "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
                   "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -6173,8 +6193,12 @@ 
Method Details

                   "uid": "A String", # Output only. Unique key for the custom emoji resource.
                 },
               },
-              "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.
+              "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+              "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+                "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+                  "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+                  "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+                },
                 "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}`
@@ -6186,6 +6210,11 @@ 
Method Details

                   },
                   "mimeType": "A String", # The mime type of the linked Google Drive resource.
                 },
+                "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+                  "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+                  "meetingCode": "A String", # Meeting code of the linked Meet space.
+                  "type": "A String", # Indicates the type of the Meet space.
+                },
                 "richLinkType": "A String", # The rich link type.
                 "uri": "A String", # The URI of this link.
               },
@@ -7065,6 +7094,7 @@ 
Method Details

             },
             "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
             "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+            "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
             "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
             "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
             "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -8456,8 +8486,8 @@ 
Method Details

         },
         "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
       },
-      "annotations": [ # Output only. Annotations associated with the `text` in this message.
-        { # 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" } }] ```
+      "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+        { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
           "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
             "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
               "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -8470,8 +8500,12 @@ 
Method Details

               "uid": "A String", # Output only. Unique key for the custom emoji resource.
             },
           },
-          "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.
+          "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+          "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+            "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+              "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+              "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+            },
             "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}`
@@ -8483,6 +8517,11 @@ 
Method Details

               },
               "mimeType": "A String", # The mime type of the linked Google Drive resource.
             },
+            "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+              "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+              "meetingCode": "A String", # Meeting code of the linked Meet space.
+              "type": "A String", # Indicates the type of the Meet space.
+            },
             "richLinkType": "A String", # The rich link type.
             "uri": "A String", # The URI of this link.
           },
@@ -9362,6 +9401,7 @@ 
Method Details

         },
         "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
         "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+        "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
         "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
         "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
         "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -10751,8 +10791,8 @@ 
Method Details

         },
         "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
       },
-      "annotations": [ # Output only. Annotations associated with the `text` in this message.
-        { # 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" } }] ```
+      "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+        { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
           "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
             "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
               "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -10765,8 +10805,12 @@ 
Method Details

               "uid": "A String", # Output only. Unique key for the custom emoji resource.
             },
           },
-          "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.
+          "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+          "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+            "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+              "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+              "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+            },
             "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}`
@@ -10778,6 +10822,11 @@ 
Method Details

               },
               "mimeType": "A String", # The mime type of the linked Google Drive resource.
             },
+            "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+              "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+              "meetingCode": "A String", # Meeting code of the linked Meet space.
+              "type": "A String", # Indicates the type of the Meet space.
+            },
             "richLinkType": "A String", # The rich link type.
             "uri": "A String", # The URI of this link.
           },
@@ -11657,6 +11706,7 @@ 
Method Details

         },
         "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
         "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+        "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
         "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
         "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
         "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -13046,8 +13096,8 @@ 
Method Details

         },
         "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
       },
-      "annotations": [ # Output only. Annotations associated with the `text` in this message.
-        { # 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" } }] ```
+      "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+        { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
           "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
             "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
               "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -13060,8 +13110,12 @@ 
Method Details

               "uid": "A String", # Output only. Unique key for the custom emoji resource.
             },
           },
-          "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.
+          "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+          "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+            "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+              "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+              "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+            },
             "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}`
@@ -13073,6 +13127,11 @@ 
Method Details

               },
               "mimeType": "A String", # The mime type of the linked Google Drive resource.
             },
+            "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+              "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+              "meetingCode": "A String", # Meeting code of the linked Meet space.
+              "type": "A String", # Indicates the type of the Meet space.
+            },
             "richLinkType": "A String", # The rich link type.
             "uri": "A String", # The URI of this link.
           },
@@ -13952,6 +14011,7 @@ 
Method Details

         },
         "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
         "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+        "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
         "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
         "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
         "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -14136,6 +14196,7 @@ 
Method Details

           },
           "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
           "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+          "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
           "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
           "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
           "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -14204,6 +14265,7 @@ 
Method Details

       },
       "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
       "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+      "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
       "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
       "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
       "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -15740,8 +15802,8 @@ 
Method Details

                 },
                 "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
               },
-              "annotations": [ # Output only. Annotations associated with the `text` in this message.
-                { # 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" } }] ```
+              "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+                { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
                   "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
                     "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
                       "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -15754,8 +15816,12 @@ 
Method Details

                       "uid": "A String", # Output only. Unique key for the custom emoji resource.
                     },
                   },
-                  "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.
+                  "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+                  "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+                    "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+                      "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+                      "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+                    },
                     "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}`
@@ -15767,6 +15833,11 @@ 
Method Details

                       },
                       "mimeType": "A String", # The mime type of the linked Google Drive resource.
                     },
+                    "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+                      "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+                      "meetingCode": "A String", # Meeting code of the linked Meet space.
+                      "type": "A String", # Indicates the type of the Meet space.
+                    },
                     "richLinkType": "A String", # The rich link type.
                     "uri": "A String", # The URI of this link.
                   },
@@ -16646,6 +16717,7 @@ 
Method Details

                 },
                 "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
                 "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+                "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
                 "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
                 "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
                 "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -18039,8 +18111,8 @@ 
Method Details

                 },
                 "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
               },
-              "annotations": [ # Output only. Annotations associated with the `text` in this message.
-                { # 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" } }] ```
+              "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+                { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
                   "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
                     "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
                       "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -18053,8 +18125,12 @@ 
Method Details

                       "uid": "A String", # Output only. Unique key for the custom emoji resource.
                     },
                   },
-                  "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.
+                  "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+                  "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+                    "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+                      "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+                      "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+                    },
                     "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}`
@@ -18066,6 +18142,11 @@ 
Method Details

                       },
                       "mimeType": "A String", # The mime type of the linked Google Drive resource.
                     },
+                    "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+                      "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+                      "meetingCode": "A String", # Meeting code of the linked Meet space.
+                      "type": "A String", # Indicates the type of the Meet space.
+                    },
                     "richLinkType": "A String", # The rich link type.
                     "uri": "A String", # The URI of this link.
                   },
@@ -18945,6 +19026,7 @@ 
Method Details

                 },
                 "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
                 "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+                "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
                 "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
                 "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
                 "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -20338,8 +20420,8 @@ 
Method Details

                 },
                 "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
               },
-              "annotations": [ # Output only. Annotations associated with the `text` in this message.
-                { # 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" } }] ```
+              "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+                { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
                   "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
                     "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
                       "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -20352,8 +20434,12 @@ 
Method Details

                       "uid": "A String", # Output only. Unique key for the custom emoji resource.
                     },
                   },
-                  "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.
+                  "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+                  "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+                    "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+                      "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+                      "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+                    },
                     "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}`
@@ -20365,6 +20451,11 @@ 
Method Details

                       },
                       "mimeType": "A String", # The mime type of the linked Google Drive resource.
                     },
+                    "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+                      "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+                      "meetingCode": "A String", # Meeting code of the linked Meet space.
+                      "type": "A String", # Indicates the type of the Meet space.
+                    },
                     "richLinkType": "A String", # The rich link type.
                     "uri": "A String", # The URI of this link.
                   },
@@ -21244,6 +21335,7 @@ 
Method Details

                 },
                 "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
                 "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+                "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
                 "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
                 "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
                 "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -22635,8 +22727,8 @@ 
Method Details

             },
             "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
           },
-          "annotations": [ # Output only. Annotations associated with the `text` in this message.
-            { # 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" } }] ```
+          "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+            { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
               "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
                 "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
                   "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -22649,8 +22741,12 @@ 
Method Details

                   "uid": "A String", # Output only. Unique key for the custom emoji resource.
                 },
               },
-              "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.
+              "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+              "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+                "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+                  "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+                  "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+                },
                 "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}`
@@ -22662,6 +22758,11 @@ 
Method Details

                   },
                   "mimeType": "A String", # The mime type of the linked Google Drive resource.
                 },
+                "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+                  "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+                  "meetingCode": "A String", # Meeting code of the linked Meet space.
+                  "type": "A String", # Indicates the type of the Meet space.
+                },
                 "richLinkType": "A String", # The rich link type.
                 "uri": "A String", # The URI of this link.
               },
@@ -23541,6 +23642,7 @@ 
Method Details

             },
             "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
             "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+            "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
             "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
             "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
             "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -24930,8 +25032,8 @@ 
Method Details

             },
             "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
           },
-          "annotations": [ # Output only. Annotations associated with the `text` in this message.
-            { # 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" } }] ```
+          "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+            { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
               "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
                 "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
                   "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -24944,8 +25046,12 @@ 
Method Details

                   "uid": "A String", # Output only. Unique key for the custom emoji resource.
                 },
               },
-              "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.
+              "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+              "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+                "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+                  "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+                  "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+                },
                 "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}`
@@ -24957,6 +25063,11 @@ 
Method Details

                   },
                   "mimeType": "A String", # The mime type of the linked Google Drive resource.
                 },
+                "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+                  "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+                  "meetingCode": "A String", # Meeting code of the linked Meet space.
+                  "type": "A String", # Indicates the type of the Meet space.
+                },
                 "richLinkType": "A String", # The rich link type.
                 "uri": "A String", # The URI of this link.
               },
@@ -25836,6 +25947,7 @@ 
Method Details

             },
             "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
             "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+            "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
             "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
             "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
             "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -27225,8 +27337,8 @@ 
Method Details

             },
             "url": "A String", # Input only. URL for users to authenticate or configure. (Only for `REQUEST_CONFIG` response types.)
           },
-          "annotations": [ # Output only. Annotations associated with the `text` in this message.
-            { # 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" } }] ```
+          "annotations": [ # Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.
+            { # Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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" } }] ```
               "customEmojiMetadata": { # Annotation metadata for custom emoji. # The metadata for a custom emoji.
                 "customEmoji": { # Represents a [custom emoji](https://support.google.com/chat/answer/12800149). # The custom emoji.
                   "emojiName": "A String", # Optional. Immutable. User-provided name for the custom emoji, which is unique within the organization. Required when the custom emoji is created, output only otherwise. Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores. Hyphens and underscores should be used to separate words and cannot be used consecutively. Example: `:valid-emoji-name:`
@@ -27239,8 +27351,12 @@ 
Method Details

                   "uid": "A String", # Output only. Unique key for the custom emoji resource.
                 },
               },
-              "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.
+              "length": 42, # Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.
+              "richLinkMetadata": { # A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0. # The metadata for a rich link.
+                "calendarEventLinkData": { # Data for Calendar event links. # Data for a calendar event link.
+                  "calendarId": "A String", # The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.
+                  "eventId": "A String", # The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.
+                },
                 "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}`
@@ -27252,6 +27368,11 @@ 
Method Details

                   },
                   "mimeType": "A String", # The mime type of the linked Google Drive resource.
                 },
+                "meetSpaceLinkData": { # Data for Meet space links. # Data for a meet space link.
+                  "huddleStatus": "A String", # Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.
+                  "meetingCode": "A String", # Meeting code of the linked Meet space.
+                  "type": "A String", # Indicates the type of the Meet space.
+                },
                 "richLinkType": "A String", # The rich link type.
                 "uri": "A String", # The URI of this link.
               },
@@ -28131,6 +28252,7 @@ 
Method Details

             },
             "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
             "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+            "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
             "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
             "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
             "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -28315,6 +28437,7 @@ 
Method Details

               },
               "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
               "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+              "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
               "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
               "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
               "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
@@ -28383,6 +28506,7 @@ 
Method Details

           },
           "adminInstalled": True or False, # Output only. For direct message (DM) spaces with a Chat app, whether the space was created by a Google Workspace administrator. Administrators can install and set up a direct message with a Chat app on behalf of users in their organization. To support admin install, your Chat app must feature direct messaging.
           "createTime": "A String", # Optional. Immutable. For spaces created in Chat, the time the space was created. This field is output only, except when used in import mode spaces. For import mode spaces, set this field to the historical timestamp at which the space was created in the source in order to preserve the original creation time. Only populated in the output when `spaceType` is `GROUP_CHAT` or `SPACE`.
+          "customer": "A String", # Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).
           "displayName": "A String", # Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.
           "externalUserAllowed": True or False, # Optional. Immutable. Whether this space permits any Google Chat user as a member. Input when creating a space in a Google Workspace organization. Omit this field when creating spaces in the following conditions: * The authenticated user uses a consumer account (unmanaged user account). By default, a space created by a consumer account permits any Google Chat user. For existing spaces, this field is output only.
           "importMode": True or False, # Optional. Whether this space is created in `Import Mode` as part of a data migration into Google Workspace. While spaces are being imported, they aren't visible to users until the import is complete. Creating a space in `Import Mode`requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user).
diff --git a/googleapiclient/discovery_cache/documents/chat.v1.json b/googleapiclient/discovery_cache/documents/chat.v1.json
index 2a559a0efe8..f521df6e03e 100644
--- a/googleapiclient/discovery_cache/documents/chat.v1.json
+++ b/googleapiclient/discovery_cache/documents/chat.v1.json
@@ -737,7 +737,7 @@
 ]
 },
 "get": {
-"description": "Returns details about a membership. For an example, see [Get details about a user's or Google Chat app's membership](https://developers.google.com/workspace/chat/get-members). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with the authorization scope: - `https://www.googleapis.com/auth/chat.bot` - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.memberships.readonly` - `https://www.googleapis.com/auth/chat.memberships` - User authentication grants administrator privileges when an administrator account authenticates, `use_admin_access` is `true`, and one of the following authorization scopes is used: - `https://www.googleapis.com/auth/chat.admin.memberships.readonly` - `https://www.googleapis.com/auth/chat.admin.memberships`",
+"description": "Returns details about a membership. For an example, see [Get details about a user's or Google Chat app's membership](https://developers.google.com/workspace/chat/get-members). Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.bot` - `https://www.googleapis.com/auth/chat.app.memberships` (requires [administrator approval](https://support.google.com/a?p=chat-app-auth)) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.memberships.readonly` - `https://www.googleapis.com/auth/chat.memberships` - User authentication grants administrator privileges when an administrator account authenticates, `use_admin_access` is `true`, and one of the following authorization scopes is used: - `https://www.googleapis.com/auth/chat.admin.memberships.readonly` - `https://www.googleapis.com/auth/chat.admin.memberships`",
 "flatPath": "v1/spaces/{spacesId}/members/{membersId}",
 "httpMethod": "GET",
 "id": "chat.spaces.members.get",
@@ -772,7 +772,7 @@
 ]
 },
 "list": {
-"description": "Lists memberships in a space. For an example, see [List users and Google Chat apps in a space](https://developers.google.com/workspace/chat/list-members). Listing memberships with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) lists memberships in spaces that the authenticated user has access to. Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with the authorization scope: - `https://www.googleapis.com/auth/chat.bot` - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.memberships.readonly` - `https://www.googleapis.com/auth/chat.memberships` - `https://www.googleapis.com/auth/chat.import` (import mode spaces only) - User authentication grants administrator privileges when an administrator account authenticates, `use_admin_access` is `true`, and one of the following authorization scopes is used: - `https://www.googleapis.com/auth/chat.admin.memberships.readonly` - `https://www.googleapis.com/auth/chat.admin.memberships`",
+"description": "Lists memberships in a space. For an example, see [List users and Google Chat apps in a space](https://developers.google.com/workspace/chat/list-members). Listing memberships with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) lists memberships in spaces that the Chat app has access to, but excludes Chat app memberships, including its own. Listing memberships with [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) lists memberships in spaces that the authenticated user has access to. Supports the following types of [authentication](https://developers.google.com/workspace/chat/authenticate-authorize): - [App authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.bot` - `https://www.googleapis.com/auth/chat.app.memberships` (requires [administrator approval](https://support.google.com/a?p=chat-app-auth)) - [User authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.memberships.readonly` - `https://www.googleapis.com/auth/chat.memberships` - `https://www.googleapis.com/auth/chat.import` (import mode spaces only) - User authentication grants administrator privileges when an administrator account authenticates, `use_admin_access` is `true`, and one of the following authorization scopes is used: - `https://www.googleapis.com/auth/chat.admin.memberships.readonly` - `https://www.googleapis.com/auth/chat.admin.memberships`",
 "flatPath": "v1/spaces/{spacesId}/members",
 "httpMethod": "GET",
 "id": "chat.spaces.members.list",
@@ -1528,7 +1528,7 @@
 }
 }
 },
-"revision": "20250710",
+"revision": "20250720",
 "rootUrl": "https://chat.googleapis.com/",
 "schemas": {
 "AccessSettings": {
@@ -1678,7 +1678,7 @@
 "type": "object"
 },
 "Annotation": {
-"description": "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\" } }] ```",
+"description": "Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0. 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\" } }] ```",
 "id": "Annotation",
 "properties": {
 "customEmojiMetadata": {
@@ -1686,7 +1686,7 @@
 "description": "The metadata for a custom emoji."
 },
 "length": {
-"description": "Length of the substring in the plain-text message body this annotation corresponds to.",
+"description": "Length of the substring in the plain-text message body this annotation corresponds to. If not present, indicates a length of 0.",
 "format": "int32",
 "type": "integer"
 },
@@ -1851,6 +1851,21 @@
 },
 "type": "object"
 },
+"CalendarEventLinkData": {
+"description": "Data for Calendar event links.",
+"id": "CalendarEventLinkData",
+"properties": {
+"calendarId": {
+"description": "The [Calendar identifier](https://developers.google.com/workspace/calendar/api/v3/reference/calendars) of the linked Calendar.",
+"type": "string"
+},
+"eventId": {
+"description": "The [Event identifier](https://developers.google.com/workspace/calendar/api/v3/reference/events) of the linked Calendar event.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "Card": {
 "description": "A card is a UI element that can contain UI widgets such as text and images.",
 "id": "Card",
@@ -4157,6 +4172,48 @@
 },
 "type": "object"
 },
+"MeetSpaceLinkData": {
+"description": "Data for Meet space links.",
+"id": "MeetSpaceLinkData",
+"properties": {
+"huddleStatus": {
+"description": "Optional. Output only. If the Meet is a Huddle, indicates the status of the huddle. Otherwise, this is unset.",
+"enum": [
+"HUDDLE_STATUS_UNSPECIFIED",
+"STARTED",
+"ENDED",
+"MISSED"
+],
+"enumDescriptions": [
+"Default value for the enum. Don't use.",
+"The huddle has started.",
+"The huddle has ended. In this case the meet space URI and identifiers will no longer be valid.",
+"The huddle has been missed. In this case the meet space URI and identifiers will no longer be valid."
+],
+"readOnly": true,
+"type": "string"
+},
+"meetingCode": {
+"description": "Meeting code of the linked Meet space.",
+"type": "string"
+},
+"type": {
+"description": "Indicates the type of the Meet space.",
+"enum": [
+"TYPE_UNSPECIFIED",
+"MEETING",
+"HUDDLE"
+],
+"enumDescriptions": [
+"Default value for the enum. Don't use.",
+"The meet space is a meeting.",
+"The meet space is a huddle."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "Membership": {
 "description": "Represents a membership relation in Google Chat, such as whether a user or Chat app is invited to, part of, or absent from a space.",
 "id": "Membership",
@@ -4327,7 +4384,7 @@
 "description": "Input only. Parameters that a Chat app can use to configure how its response is posted."
 },
 "annotations": {
-"description": "Output only. Annotations associated with the `text` in this message.",
+"description": "Output only. Annotations can be associated with the plain-text body of the message or with chips that link to Google Workspace resources like Google Docs or Sheets with a `start_index` and `length` of 0.",
 "items": {
 "$ref": "Annotation"
 },
@@ -4706,9 +4763,13 @@
 "type": "object"
 },
 "RichLinkMetadata": {
-"description": "A rich link to a resource.",
+"description": "A rich link to a resource. Rich links can be associated with the plain-text body of the message or represent chips that link to Google Workspace resources like Google Docs or Sheets with a with `start_index` and `length` of 0.",
 "id": "RichLinkMetadata",
 "properties": {
+"calendarEventLinkData": {
+"$ref": "CalendarEventLinkData",
+"description": "Data for a calendar event link."
+},
 "chatSpaceLinkData": {
 "$ref": "ChatSpaceLinkData",
 "description": "Data for a chat space link."
@@ -4717,17 +4778,25 @@
 "$ref": "DriveLinkData",
 "description": "Data for a drive link."
 },
+"meetSpaceLinkData": {
+"$ref": "MeetSpaceLinkData",
+"description": "Data for a meet space link."
+},
 "richLinkType": {
 "description": "The rich link type.",
 "enum": [
 "RICH_LINK_TYPE_UNSPECIFIED",
 "DRIVE_FILE",
-"CHAT_SPACE"
+"CHAT_SPACE",
+"MEET_SPACE",
+"CALENDAR_EVENT"
 ],
 "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."
+"A Chat space rich link type. For example, a space smart chip.",
+"A Meet message rich link type. For example, a Meet chip.",
+"A Calendar message rich link type. For example, a Calendar chip."
 ],
 "type": "string"
 },
@@ -4883,6 +4952,10 @@
 "format": "google-datetime",
 "type": "string"
 },
+"customer": {
+"description": "Optional. Immutable. The customer id of the domain of the space. Required only when creating a space with [app authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-app) and `SpaceType` is `SPACE`, otherwise should not be set. In the format `customers/{customer}`, where `customer` is the `id` from the [Admin SDK customer resource]( https://developers.google.com/admin-sdk/directory/reference/rest/v1/customers). Private apps can also use the `customers/my_customer` alias to create the space in the same Google Workspace organization as the app. For DMs, this field isn't populated. [Developer Preview](https://developers.google.com/workspace/preview).",
+"type": "string"
+},
 "displayName": {
 "description": "Optional. The space's display name. Required when [creating a space](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/create) with a `spaceType` of `SPACE`. If you receive the error message `ALREADY_EXISTS` when creating a space or updating the `displayName`, try a different `displayName`. An existing space within the Google Workspace organization might already use this display name. For direct messages, this field might be empty. Supports up to 128 characters.",
 "type": "string"

From cfda841bae2dd1cc185c7c1eb2dc6d7654194c69 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:12 +0000
Subject: [PATCH 09/36] feat(cloudbuild): update the api

#### cloudbuild:v2

The following keys were deleted:
- schemas.Capabilities (Total Keys: 6)
- schemas.SecurityContext.properties.capabilities.$ref (Total Keys: 1)
---
 ...ild_v1.projects.locations.workerPools.html |  8 +++---
 .../documents/cloudbuild.v1.json              |  4 +--
 .../documents/cloudbuild.v2.json              | 27 +------------------
 3 files changed, 7 insertions(+), 32 deletions(-)

diff --git a/docs/dyn/cloudbuild_v1.projects.locations.workerPools.html b/docs/dyn/cloudbuild_v1.projects.locations.workerPools.html
index cd840bd3204..91a29d11bc4 100644
--- a/docs/dyn/cloudbuild_v1.projects.locations.workerPools.html
+++ b/docs/dyn/cloudbuild_v1.projects.locations.workerPools.html
@@ -128,7 +128,7 @@ 
Method Details

     "privateServiceConnect": { # Defines the Private Service Connect network configuration for the pool. # Immutable. Private Service Connect(PSC) Network configuration for the pool.
       "networkAttachment": "A String", # Required. Immutable. The network attachment that the worker network interface is peered to. Must be in the format `projects/{project}/regions/{region}/networkAttachments/{networkAttachment}`. The region of network attachment must be the same as the worker pool. See [Network Attachments](https://cloud.google.com/vpc/docs/about-network-attachments)
       "publicIpAddressDisabled": True or False, # Required. Immutable. Disable public IP on the primary network interface. If true, workers are created without any public address, which prevents network egress to public IPs unless a network proxy is configured. If false, workers are created with a public address which allows for public internet egress. The public address only applies to traffic through the primary network interface. If `route_all_traffic` is set to true, all traffic will go through the non-primary network interface, this boolean has no effect.
-      "routeAllTraffic": True or False, # Immutable. Route all traffic through PSC interface. Enable this if you want full control of traffic in the private pool. Configure Cloud NAT for the subnet of network attachment if you need to access public Internet. If false, Only route private IPs, e.g. 10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16 through PSC interface.
+      "routeAllTraffic": True or False, # Immutable. Route all traffic through PSC interface. Enable this if you want full control of traffic in the private pool. Configure Cloud NAT for the subnet of network attachment if you need to access public Internet. If false, Only route RFC 1918 (10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16) and RFC 6598 (100.64.0.0/10) through PSC interface.
     },
     "workerConfig": { # Defines the configuration to be used for creating workers in the pool. # Machine configuration for the workers in the pool.
       "diskSizeGb": "A String", # Size of the disk attached to the worker, in GB. See [Worker pool config file](https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema). Specify a value of up to 4000. If `0` is specified, Cloud Build will use a standard disk size.
@@ -241,7 +241,7 @@ 
Method Details

     "privateServiceConnect": { # Defines the Private Service Connect network configuration for the pool. # Immutable. Private Service Connect(PSC) Network configuration for the pool.
       "networkAttachment": "A String", # Required. Immutable. The network attachment that the worker network interface is peered to. Must be in the format `projects/{project}/regions/{region}/networkAttachments/{networkAttachment}`. The region of network attachment must be the same as the worker pool. See [Network Attachments](https://cloud.google.com/vpc/docs/about-network-attachments)
       "publicIpAddressDisabled": True or False, # Required. Immutable. Disable public IP on the primary network interface. If true, workers are created without any public address, which prevents network egress to public IPs unless a network proxy is configured. If false, workers are created with a public address which allows for public internet egress. The public address only applies to traffic through the primary network interface. If `route_all_traffic` is set to true, all traffic will go through the non-primary network interface, this boolean has no effect.
-      "routeAllTraffic": True or False, # Immutable. Route all traffic through PSC interface. Enable this if you want full control of traffic in the private pool. Configure Cloud NAT for the subnet of network attachment if you need to access public Internet. If false, Only route private IPs, e.g. 10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16 through PSC interface.
+      "routeAllTraffic": True or False, # Immutable. Route all traffic through PSC interface. Enable this if you want full control of traffic in the private pool. Configure Cloud NAT for the subnet of network attachment if you need to access public Internet. If false, Only route RFC 1918 (10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16) and RFC 6598 (100.64.0.0/10) through PSC interface.
     },
     "workerConfig": { # Defines the configuration to be used for creating workers in the pool. # Machine configuration for the workers in the pool.
       "diskSizeGb": "A String", # Size of the disk attached to the worker, in GB. See [Worker pool config file](https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema). Specify a value of up to 4000. If `0` is specified, Cloud Build will use a standard disk size.
@@ -291,7 +291,7 @@ 
Method Details

         "privateServiceConnect": { # Defines the Private Service Connect network configuration for the pool. # Immutable. Private Service Connect(PSC) Network configuration for the pool.
           "networkAttachment": "A String", # Required. Immutable. The network attachment that the worker network interface is peered to. Must be in the format `projects/{project}/regions/{region}/networkAttachments/{networkAttachment}`. The region of network attachment must be the same as the worker pool. See [Network Attachments](https://cloud.google.com/vpc/docs/about-network-attachments)
           "publicIpAddressDisabled": True or False, # Required. Immutable. Disable public IP on the primary network interface. If true, workers are created without any public address, which prevents network egress to public IPs unless a network proxy is configured. If false, workers are created with a public address which allows for public internet egress. The public address only applies to traffic through the primary network interface. If `route_all_traffic` is set to true, all traffic will go through the non-primary network interface, this boolean has no effect.
-          "routeAllTraffic": True or False, # Immutable. Route all traffic through PSC interface. Enable this if you want full control of traffic in the private pool. Configure Cloud NAT for the subnet of network attachment if you need to access public Internet. If false, Only route private IPs, e.g. 10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16 through PSC interface.
+          "routeAllTraffic": True or False, # Immutable. Route all traffic through PSC interface. Enable this if you want full control of traffic in the private pool. Configure Cloud NAT for the subnet of network attachment if you need to access public Internet. If false, Only route RFC 1918 (10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16) and RFC 6598 (100.64.0.0/10) through PSC interface.
         },
         "workerConfig": { # Defines the configuration to be used for creating workers in the pool. # Machine configuration for the workers in the pool.
           "diskSizeGb": "A String", # Size of the disk attached to the worker, in GB. See [Worker pool config file](https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema). Specify a value of up to 4000. If `0` is specified, Cloud Build will use a standard disk size.
@@ -347,7 +347,7 @@ 
Method Details

     "privateServiceConnect": { # Defines the Private Service Connect network configuration for the pool. # Immutable. Private Service Connect(PSC) Network configuration for the pool.
       "networkAttachment": "A String", # Required. Immutable. The network attachment that the worker network interface is peered to. Must be in the format `projects/{project}/regions/{region}/networkAttachments/{networkAttachment}`. The region of network attachment must be the same as the worker pool. See [Network Attachments](https://cloud.google.com/vpc/docs/about-network-attachments)
       "publicIpAddressDisabled": True or False, # Required. Immutable. Disable public IP on the primary network interface. If true, workers are created without any public address, which prevents network egress to public IPs unless a network proxy is configured. If false, workers are created with a public address which allows for public internet egress. The public address only applies to traffic through the primary network interface. If `route_all_traffic` is set to true, all traffic will go through the non-primary network interface, this boolean has no effect.
-      "routeAllTraffic": True or False, # Immutable. Route all traffic through PSC interface. Enable this if you want full control of traffic in the private pool. Configure Cloud NAT for the subnet of network attachment if you need to access public Internet. If false, Only route private IPs, e.g. 10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16 through PSC interface.
+      "routeAllTraffic": True or False, # Immutable. Route all traffic through PSC interface. Enable this if you want full control of traffic in the private pool. Configure Cloud NAT for the subnet of network attachment if you need to access public Internet. If false, Only route RFC 1918 (10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16) and RFC 6598 (100.64.0.0/10) through PSC interface.
     },
     "workerConfig": { # Defines the configuration to be used for creating workers in the pool. # Machine configuration for the workers in the pool.
       "diskSizeGb": "A String", # Size of the disk attached to the worker, in GB. See [Worker pool config file](https://cloud.google.com/build/docs/private-pools/worker-pool-config-file-schema). Specify a value of up to 4000. If `0` is specified, Cloud Build will use a standard disk size.
diff --git a/googleapiclient/discovery_cache/documents/cloudbuild.v1.json b/googleapiclient/discovery_cache/documents/cloudbuild.v1.json
index 68edaf986d0..6bf7afb3305 100644
--- a/googleapiclient/discovery_cache/documents/cloudbuild.v1.json
+++ b/googleapiclient/discovery_cache/documents/cloudbuild.v1.json
@@ -2573,7 +2573,7 @@
 }
 }
 },
-"revision": "20250609",
+"revision": "20250718",
 "rootUrl": "https://cloudbuild.googleapis.com/",
 "schemas": {
 "ApprovalConfig": {
@@ -5043,7 +5043,7 @@ false
 "type": "boolean"
 },
 "routeAllTraffic": {
-"description": "Immutable. Route all traffic through PSC interface. Enable this if you want full control of traffic in the private pool. Configure Cloud NAT for the subnet of network attachment if you need to access public Internet. If false, Only route private IPs, e.g. 10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16 through PSC interface.",
+"description": "Immutable. Route all traffic through PSC interface. Enable this if you want full control of traffic in the private pool. Configure Cloud NAT for the subnet of network attachment if you need to access public Internet. If false, Only route RFC 1918 (10.0.0.0/8, 172.16.0.0/12, and 192.168.0.0/16) and RFC 6598 (100.64.0.0/10) through PSC interface.",
 "type": "boolean"
 }
 },
diff --git a/googleapiclient/discovery_cache/documents/cloudbuild.v2.json b/googleapiclient/discovery_cache/documents/cloudbuild.v2.json
index dfcb452c46f..cd2aa81c535 100644
--- a/googleapiclient/discovery_cache/documents/cloudbuild.v2.json
+++ b/googleapiclient/discovery_cache/documents/cloudbuild.v2.json
@@ -1087,7 +1087,7 @@
 }
 }
 },
-"revision": "20250418",
+"revision": "20250718",
 "rootUrl": "https://cloudbuild.googleapis.com/",
 "schemas": {
 "AuditConfig": {
@@ -1253,27 +1253,6 @@
 "properties": {},
 "type": "object"
 },
-"Capabilities": {
-"description": "Capabilities adds and removes POSIX capabilities from running containers.",
-"id": "Capabilities",
-"properties": {
-"add": {
-"description": "Optional. Added capabilities +optional",
-"items": {
-"type": "string"
-},
-"type": "array"
-},
-"drop": {
-"description": "Optional. Removed capabilities +optional",
-"items": {
-"type": "string"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
 "ChildStatusReference": {
 "description": "ChildStatusReference is used to point to the statuses of individual TaskRuns and Runs within this PipelineRun.",
 "id": "ChildStatusReference",
@@ -2809,10 +2788,6 @@
 "description": "Optional. AllowPrivilegeEscalation controls whether a process can gain more privileges than its parent process. This bool directly controls if the no_new_privs flag will be set on the container process. AllowPrivilegeEscalation is true always when the container is: 1) run as Privileged 2) has CAP_SYS_ADMIN Note that this field cannot be set when spec.os.name is windows. +optional",
 "type": "boolean"
 },
-"capabilities": {
-"$ref": "Capabilities",
-"description": "Optional. Adds and removes POSIX capabilities from running containers."
-},
 "privileged": {
 "description": "Run container in privileged mode.",
 "type": "boolean"

From 4a2520fd896d51996181b64642c100c1e1edff8b Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:12 +0000
Subject: [PATCH 10/36] feat(contactcenterinsights): update the api

#### contactcenterinsights:v1

The following keys were added:
- resources.projects.resources.locations.resources.conversations.methods.patch.parameters.allowMissing (Total Keys: 2)
- schemas.GoogleCloudContactcenterinsightsV1IngestConversationsRequestGcsSource.properties.transcriptBucketUri.type (Total Keys: 1)
- schemas.GoogleCloudContactcenterinsightsV1alpha1IngestConversationsRequestGcsSource.properties.transcriptBucketUri.type (Total Keys: 1)
---
 ...s_v1.projects.locations.conversations.html | 12 +++++----
 ...ects.locations.datasets.conversations.html |  7 ++---
 .../documents/contactcenterinsights.v1.json   | 27 ++++++++++++++-----
 3 files changed, 31 insertions(+), 15 deletions(-)

diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.html b/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.html
index 54f540035ac..5fbb902f8a6 100644
--- a/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.html
+++ b/docs/dyn/contactcenterinsights_v1.projects.locations.conversations.html
@@ -120,7 +120,7 @@ 
Instance Methods

   list_next()

 
Retrieves the next page of results.

 

-  patch(name, body=None, updateMask=None, x__xgafv=None)

+  patch(name, allowMissing=None, body=None, updateMask=None, x__xgafv=None)

 
Updates a conversation.

 

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

@@ -1522,13 +1522,14 @@ 
Method Details

     "customerChannel": 42, # Optional. Indicates which of the channels, 1 or 2, contains the agent. Note that this must be set for conversations to be properly displayed and analyzed.
   },
   "gcsSource": { # Configuration for Cloud Storage bucket sources. # A cloud storage bucket source. Note that any previously ingested objects from the source will be skipped to avoid duplication.
-    "audioBucketUri": "A String", # Optional. The Cloud Storage path to the conversation audio file if already transcribed. Note that: [1] Don't set this field if the audio is not transcribed. [2] Audio files and transcript files must be in separate buckets / folders. [3] A source file and its corresponding audio file must share the same name to be properly ingested, E.g. `gs://bucket/transcript/conversation1.json` and `gs://bucket/audio/conversation1.mp3`.
-    "bucketObjectType": "A String", # Optional. Specifies the type of the objects in `bucket_uri`.
-    "bucketUri": "A String", # Required. The Cloud Storage bucket containing source objects.
+    "audioBucketUri": "A String", # Optional. The Cloud Storage path to the conversation audio file. Note that: [1] Audio files will be transcribed if not already. [2] Audio files and transcript files must be in separate buckets / folders. [3] A source file and its corresponding audio file must share the same name to be properly ingested, E.g. `gs://bucket/transcript/conversation1.json` and `gs://bucket/audio/conversation1.mp3`.
+    "bucketObjectType": "A String", # Optional. Specifies the type of the objects in `bucket_uri`. Avoid passing this. This is inferred from the `transcript_bucket_uri`, `audio_bucket_uri`.
+    "bucketUri": "A String", # Optional. The Cloud Storage bucket containing source objects. Avoid passing this. Pass this through one of `transcript_bucket_uri` or `audio_bucket_uri`.
     "customMetadataKeys": [ # Optional. Custom keys to extract as conversation labels from metadata files in `metadata_bucket_uri`. Keys not included in this field will be ignored. Note that there is a limit of 100 labels per conversation.
       "A String",
     ],
     "metadataBucketUri": "A String", # Optional. The Cloud Storage path to the conversation metadata. Note that: [1] Metadata files are expected to be in JSON format. [2] Metadata and source files (transcripts or audio) must be in separate buckets / folders. [3] A source file and its corresponding metadata file must share the same name to be properly ingested, E.g. `gs://bucket/audio/conversation1.mp3` and `gs://bucket/metadata/conversation1.json`.
+    "transcriptBucketUri": "A String", # Optional. The Cloud Storage path to the conversation transcripts. Note that: [1] Transcript files are expected to be in JSON format. [2] Transcript, audio, metadata files must be in separate buckets / folders. [3] A source file and its corresponding metadata file must share the same name to be properly ingested, E.g. `gs://bucket/audio/conversation1.mp3` and `gs://bucket/metadata/conversation1.json`.
   },
   "parent": "A String", # Required. The parent resource for new conversations.
   "redactionConfig": { # DLP resources used for redaction while ingesting conversations. DLP settings are applied to conversations ingested from the `UploadConversation` and `IngestConversations` endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the `CreateConversation` endpoint or the Dialogflow / Agent Assist runtime integrations. When using Dialogflow / Agent Assist runtime integrations, redaction should be performed in Dialogflow / Agent Assist. # Optional. DLP settings for transcript redaction. Optional, will default to the config specified in Settings.
@@ -2001,7 +2002,7 @@ 
Method Details

 

 
 

-    patch(name, body=None, updateMask=None, x__xgafv=None)
+    patch(name, allowMissing=None, body=None, updateMask=None, x__xgafv=None)
   
Updates a conversation.
 
 Args:
@@ -2393,6 +2394,7 @@ 
Method Details

   "updateTime": "A String", # Output only. The most recent time at which the conversation was updated.
 }
 
+  allowMissing: boolean, Optional. Defaults to false. If set to true, and the conversation is not found, a new conversation will be created. In this situation, `update_mask` is ignored.
   updateMask: string, The list of fields to be updated. All possible fields can be updated by passing `*`, or a subset of the following updateable fields can be provided: * `agent_id` * `language_code` * `labels` * `metadata` * `quality_metadata` * `call_metadata` * `start_time` * `expire_time` or `ttl` * `data_source.gcs_source.audio_uri` or `data_source.dialogflow_source.audio_uri`
   x__xgafv: string, V1 error format.
     Allowed values
diff --git a/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.conversations.html b/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.conversations.html
index 8e3c11bd2da..cc25f53e209 100644
--- a/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.conversations.html
+++ b/docs/dyn/contactcenterinsights_v1.projects.locations.datasets.conversations.html
@@ -727,13 +727,14 @@ 
Method Details

     "customerChannel": 42, # Optional. Indicates which of the channels, 1 or 2, contains the agent. Note that this must be set for conversations to be properly displayed and analyzed.
   },
   "gcsSource": { # Configuration for Cloud Storage bucket sources. # A cloud storage bucket source. Note that any previously ingested objects from the source will be skipped to avoid duplication.
-    "audioBucketUri": "A String", # Optional. The Cloud Storage path to the conversation audio file if already transcribed. Note that: [1] Don't set this field if the audio is not transcribed. [2] Audio files and transcript files must be in separate buckets / folders. [3] A source file and its corresponding audio file must share the same name to be properly ingested, E.g. `gs://bucket/transcript/conversation1.json` and `gs://bucket/audio/conversation1.mp3`.
-    "bucketObjectType": "A String", # Optional. Specifies the type of the objects in `bucket_uri`.
-    "bucketUri": "A String", # Required. The Cloud Storage bucket containing source objects.
+    "audioBucketUri": "A String", # Optional. The Cloud Storage path to the conversation audio file. Note that: [1] Audio files will be transcribed if not already. [2] Audio files and transcript files must be in separate buckets / folders. [3] A source file and its corresponding audio file must share the same name to be properly ingested, E.g. `gs://bucket/transcript/conversation1.json` and `gs://bucket/audio/conversation1.mp3`.
+    "bucketObjectType": "A String", # Optional. Specifies the type of the objects in `bucket_uri`. Avoid passing this. This is inferred from the `transcript_bucket_uri`, `audio_bucket_uri`.
+    "bucketUri": "A String", # Optional. The Cloud Storage bucket containing source objects. Avoid passing this. Pass this through one of `transcript_bucket_uri` or `audio_bucket_uri`.
     "customMetadataKeys": [ # Optional. Custom keys to extract as conversation labels from metadata files in `metadata_bucket_uri`. Keys not included in this field will be ignored. Note that there is a limit of 100 labels per conversation.
       "A String",
     ],
     "metadataBucketUri": "A String", # Optional. The Cloud Storage path to the conversation metadata. Note that: [1] Metadata files are expected to be in JSON format. [2] Metadata and source files (transcripts or audio) must be in separate buckets / folders. [3] A source file and its corresponding metadata file must share the same name to be properly ingested, E.g. `gs://bucket/audio/conversation1.mp3` and `gs://bucket/metadata/conversation1.json`.
+    "transcriptBucketUri": "A String", # Optional. The Cloud Storage path to the conversation transcripts. Note that: [1] Transcript files are expected to be in JSON format. [2] Transcript, audio, metadata files must be in separate buckets / folders. [3] A source file and its corresponding metadata file must share the same name to be properly ingested, E.g. `gs://bucket/audio/conversation1.mp3` and `gs://bucket/metadata/conversation1.json`.
   },
   "parent": "A String", # Required. The parent resource for new conversations.
   "redactionConfig": { # DLP resources used for redaction while ingesting conversations. DLP settings are applied to conversations ingested from the `UploadConversation` and `IngestConversations` endpoints, including conversation coming from CCAI Platform. They are not applied to conversations ingested from the `CreateConversation` endpoint or the Dialogflow / Agent Assist runtime integrations. When using Dialogflow / Agent Assist runtime integrations, redaction should be performed in Dialogflow / Agent Assist. # Optional. DLP settings for transcript redaction. Optional, will default to the config specified in Settings.
diff --git a/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json b/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json
index 5c55768c206..5e23aeb56ce 100644
--- a/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json
+++ b/googleapiclient/discovery_cache/documents/contactcenterinsights.v1.json
@@ -2335,6 +2335,11 @@
 "name"
 ],
 "parameters": {
+"allowMissing": {
+"description": "Optional. Defaults to false. If set to true, and the conversation is not found, a new conversation will be created. In this situation, `update_mask` is ignored.",
+"location": "query",
+"type": "boolean"
+},
 "name": {
 "description": "Immutable. The resource name of the conversation. Format: projects/{project}/locations/{location}/conversations/{conversation}",
 "location": "path",
@@ -5300,7 +5305,7 @@
 }
 }
 },
-"revision": "20250711",
+"revision": "20250721",
 "rootUrl": "https://contactcenterinsights.googleapis.com/",
 "schemas": {
 "GoogleCloudContactcenterinsightsV1Analysis": {
@@ -7890,11 +7895,11 @@ true
 "id": "GoogleCloudContactcenterinsightsV1IngestConversationsRequestGcsSource",
 "properties": {
 "audioBucketUri": {
-"description": "Optional. The Cloud Storage path to the conversation audio file if already transcribed. Note that: [1] Don't set this field if the audio is not transcribed. [2] Audio files and transcript files must be in separate buckets / folders. [3] A source file and its corresponding audio file must share the same name to be properly ingested, E.g. `gs://bucket/transcript/conversation1.json` and `gs://bucket/audio/conversation1.mp3`.",
+"description": "Optional. The Cloud Storage path to the conversation audio file. Note that: [1] Audio files will be transcribed if not already. [2] Audio files and transcript files must be in separate buckets / folders. [3] A source file and its corresponding audio file must share the same name to be properly ingested, E.g. `gs://bucket/transcript/conversation1.json` and `gs://bucket/audio/conversation1.mp3`.",
 "type": "string"
 },
 "bucketObjectType": {
-"description": "Optional. Specifies the type of the objects in `bucket_uri`.",
+"description": "Optional. Specifies the type of the objects in `bucket_uri`. Avoid passing this. This is inferred from the `transcript_bucket_uri`, `audio_bucket_uri`.",
 "enum": [
 "BUCKET_OBJECT_TYPE_UNSPECIFIED",
 "TRANSCRIPT",
@@ -7908,7 +7913,7 @@ true
 "type": "string"
 },
 "bucketUri": {
-"description": "Required. The Cloud Storage bucket containing source objects.",
+"description": "Optional. The Cloud Storage bucket containing source objects. Avoid passing this. Pass this through one of `transcript_bucket_uri` or `audio_bucket_uri`.",
 "type": "string"
 },
 "customMetadataKeys": {
@@ -7921,6 +7926,10 @@ true
 "metadataBucketUri": {
 "description": "Optional. The Cloud Storage path to the conversation metadata. Note that: [1] Metadata files are expected to be in JSON format. [2] Metadata and source files (transcripts or audio) must be in separate buckets / folders. [3] A source file and its corresponding metadata file must share the same name to be properly ingested, E.g. `gs://bucket/audio/conversation1.mp3` and `gs://bucket/metadata/conversation1.json`.",
 "type": "string"
+},
+"transcriptBucketUri": {
+"description": "Optional. The Cloud Storage path to the conversation transcripts. Note that: [1] Transcript files are expected to be in JSON format. [2] Transcript, audio, metadata files must be in separate buckets / folders. [3] A source file and its corresponding metadata file must share the same name to be properly ingested, E.g. `gs://bucket/audio/conversation1.mp3` and `gs://bucket/metadata/conversation1.json`.",
+"type": "string"
 }
 },
 "type": "object"
@@ -12287,11 +12296,11 @@ true
 "id": "GoogleCloudContactcenterinsightsV1alpha1IngestConversationsRequestGcsSource",
 "properties": {
 "audioBucketUri": {
-"description": "Optional. The Cloud Storage path to the conversation audio file if already transcribed. Note that: [1] Don't set this field if the audio is not transcribed. [2] Audio files and transcript files must be in separate buckets / folders. [3] A source file and its corresponding audio file must share the same name to be properly ingested, E.g. `gs://bucket/transcript/conversation1.json` and `gs://bucket/audio/conversation1.mp3`.",
+"description": "Optional. The Cloud Storage path to the conversation audio file. Note that: [1] Audio files will be transcribed if not already. [2] Audio files and transcript files must be in separate buckets / folders. [3] A source file and its corresponding audio file must share the same name to be properly ingested, E.g. `gs://bucket/transcript/conversation1.json` and `gs://bucket/audio/conversation1.mp3`.",
 "type": "string"
 },
 "bucketObjectType": {
-"description": "Optional. Specifies the type of the objects in `bucket_uri`.",
+"description": "Optional. Specifies the type of the objects in `bucket_uri`. Avoid passing this. This is inferred from the `transcript_bucket_uri`, `audio_bucket_uri`.",
 "enum": [
 "BUCKET_OBJECT_TYPE_UNSPECIFIED",
 "TRANSCRIPT",
@@ -12305,7 +12314,7 @@ true
 "type": "string"
 },
 "bucketUri": {
-"description": "Required. The Cloud Storage bucket containing source objects.",
+"description": "Optional. The Cloud Storage bucket containing source objects. Avoid passing this. Pass this through one of `transcript_bucket_uri` or `audio_bucket_uri`.",
 "type": "string"
 },
 "customMetadataKeys": {
@@ -12318,6 +12327,10 @@ true
 "metadataBucketUri": {
 "description": "Optional. The Cloud Storage path to the conversation metadata. Note that: [1] Metadata files are expected to be in JSON format. [2] Metadata and source files (transcripts or audio) must be in separate buckets / folders. [3] A source file and its corresponding metadata file must share the same name to be properly ingested, E.g. `gs://bucket/audio/conversation1.mp3` and `gs://bucket/metadata/conversation1.json`.",
 "type": "string"
+},
+"transcriptBucketUri": {
+"description": "Optional. The Cloud Storage path to the conversation transcripts. Note that: [1] Transcript files are expected to be in JSON format. [2] Transcript, audio, metadata files must be in separate buckets / folders. [3] A source file and its corresponding metadata file must share the same name to be properly ingested, E.g. `gs://bucket/audio/conversation1.mp3` and `gs://bucket/metadata/conversation1.json`.",
+"type": "string"
 }
 },
 "type": "object"

From d62e912ae6a21abf80039d6f0cc36b91f3a1ccb1 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:12 +0000
Subject: [PATCH 11/36] feat(discoveryengine): update the api

#### discoveryengine:v1

The following keys were deleted:
- schemas.GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpec.properties.toolRegistry.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecVertexAiSearchSpec.properties.disabled (Total Keys: 2)
- schemas.GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecWebGroundingSpec.properties.enabled (Total Keys: 2)

The following keys were added:
- resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.methods.get (Total Keys: 11)
- resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.methods.patch (Total Keys: 15)
- schemas.GoogleCloudDiscoveryengineV1AssistAnswer.properties.name.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1Assistant (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1CmekConfig.properties.kmsKeyVersion.readOnly (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1ProvisionProjectRequest.properties.saasParams.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1ProvisionProjectRequestSaasParams (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1alphaCmekConfig.properties.kmsKeyVersion.readOnly (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaCmekConfig.properties.kmsKeyVersion.readOnly (Total Keys: 1)

#### discoveryengine:v1alpha

The following keys were deleted:
- resources.media.methods.upload (Total Keys: 16)
- schemas.GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpec.properties.toolRegistry.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecVertexAiSearchSpec.properties.disabled (Total Keys: 2)
- schemas.GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecWebGroundingSpec.properties.enabled (Total Keys: 2)

The following keys were added:
- resources.media.methods.download (Total Keys: 17)
- resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.methods.get (Total Keys: 11)
- resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.methods.patch (Total Keys: 15)
- resources.projects.resources.locations.resources.collections.resources.engines.resources.sessions.resources.files.methods.list (Total Keys: 18)
- resources.projects.resources.locations.resources.notebooks.methods.listRecentlyViewed (Total Keys: 16)
- resources.projects.resources.locations.resources.notebooks.resources.sources.methods.batchCreate (Total Keys: 12)
- schemas.GoogleCloudDiscoveryengineV1Assistant (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1CmekConfig.properties.kmsKeyVersion.readOnly (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaAssistAnswer.properties.name.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaAssistant (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1alphaCmekConfig.properties.kmsKeyVersion.readOnly (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaFileCharacteristics (Total Keys: 5)
- schemas.GoogleCloudDiscoveryengineV1alphaFileMetadata (Total Keys: 26)
- schemas.GoogleCloudDiscoveryengineV1alphaFileView (Total Keys: 20)
- schemas.GoogleCloudDiscoveryengineV1alphaImageCharacteristics (Total Keys: 13)
- schemas.GoogleCloudDiscoveryengineV1alphaListFilesResponse (Total Keys: 5)
- schemas.GoogleCloudDiscoveryengineV1alphaProvisionProjectRequest.properties.saasParams.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaProvisionProjectRequestSaasParams (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1alphaUploadSessionFileRequest (Total Keys: 4)
- schemas.GoogleCloudDiscoveryengineV1alphaUploadSessionFileResponse (Total Keys: 4)
- schemas.GoogleCloudDiscoveryengineV1alphaVideoCharacteristics (Total Keys: 26)
- schemas.GoogleCloudDiscoveryengineV1betaCmekConfig.properties.kmsKeyVersion.readOnly (Total Keys: 1)
- schemas.GoogleCloudNotebooklmV1alphaAgentspaceMetadata (Total Keys: 4)
- schemas.GoogleCloudNotebooklmV1alphaBatchCreateSourcesRequest (Total Keys: 4)
- schemas.GoogleCloudNotebooklmV1alphaBatchCreateSourcesResponse (Total Keys: 4)
- schemas.GoogleCloudNotebooklmV1alphaListRecentlyViewedNotebooksResponse (Total Keys: 5)
- schemas.GoogleCloudNotebooklmV1alphaNotebook (Total Keys: 15)
- schemas.GoogleCloudNotebooklmV1alphaSource (Total Keys: 14)
- schemas.GoogleCloudNotebooklmV1alphaUserContent (Total Keys: 8)

#### discoveryengine:v1beta

The following keys were deleted:
- schemas.GoogleCloudDiscoveryengineV1betaStreamAssistRequestToolsSpec.properties.toolRegistry.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaStreamAssistRequestToolsSpecVertexAiSearchSpec.properties.disabled (Total Keys: 2)
- schemas.GoogleCloudDiscoveryengineV1betaStreamAssistRequestToolsSpecWebGroundingSpec.properties.enabled (Total Keys: 2)

The following keys were added:
- resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.methods.get (Total Keys: 11)
- resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.methods.patch (Total Keys: 15)
- schemas.GoogleCloudDiscoveryengineV1Assistant (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1CmekConfig.properties.kmsKeyVersion.readOnly (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1alphaCmekConfig.properties.kmsKeyVersion.readOnly (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaAssistAnswer.properties.name.type (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaAssistant (Total Keys: 3)
- schemas.GoogleCloudDiscoveryengineV1betaCmekConfig.properties.kmsKeyVersion.readOnly (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaProvisionProjectRequest.properties.saasParams.$ref (Total Keys: 1)
- schemas.GoogleCloudDiscoveryengineV1betaProvisionProjectRequestSaasParams (Total Keys: 3)
---
 docs/dyn/discoveryengine_v1.projects.html     |   3 +
 ...ine_v1.projects.locations.cmekConfigs.html |  12 +-
 ...ects.locations.collections.dataStores.html |  20 +-
 ...tions.collections.dataStores.sessions.html |   2 +-
 ...ations.collections.engines.assistants.html |  56 +-
 ...ocations.collections.engines.sessions.html |   2 +-
 ...gine_v1.projects.locations.dataStores.html |  20 +-
 ...rojects.locations.dataStores.sessions.html |   2 +-
 ...discoveryengine_v1.projects.locations.html |   8 +-
 ...jects.locations.identityMappingStores.html |  16 +-
 ..._v1.projects.locations.rankingConfigs.html |   2 +-
 docs/dyn/discoveryengine_v1alpha.media.html   | 687 +++++----------
 .../dyn/discoveryengine_v1alpha.projects.html |   3 +
 ...1alpha.projects.locations.cmekConfigs.html |  12 +-
 ...ects.locations.collections.dataStores.html |  20 +-
 ...tions.collections.dataStores.sessions.html |   2 +-
 ...ations.collections.engines.assistants.html |  56 +-
 ...ns.collections.engines.sessions.files.html | 179 ++++
 ...ocations.collections.engines.sessions.html |   7 +-
 ...v1alpha.projects.locations.dataStores.html |  20 +-
 ...rojects.locations.dataStores.sessions.html |   2 +-
 ...veryengine_v1alpha.projects.locations.html |   8 +-
 ...jects.locations.identityMappingStores.html |  16 +-
 ..._v1alpha.projects.locations.notebooks.html |  55 ++
 ....projects.locations.notebooks.sources.html |  54 ++
 ...pha.projects.locations.rankingConfigs.html |   2 +-
 docs/dyn/discoveryengine_v1beta.projects.html |   3 +
 ...v1beta.projects.locations.cmekConfigs.html |  12 +-
 ...ects.locations.collections.dataStores.html |  20 +-
 ...tions.collections.dataStores.sessions.html |   2 +-
 ...ations.collections.engines.assistants.html |  56 +-
 ...ocations.collections.engines.sessions.html |   2 +-
 ..._v1beta.projects.locations.dataStores.html |  20 +-
 ...rojects.locations.dataStores.sessions.html |   2 +-
 ...overyengine_v1beta.projects.locations.html |   8 +-
 ...jects.locations.identityMappingStores.html |  16 +-
 ...eta.projects.locations.rankingConfigs.html |   2 +-
 .../documents/discoveryengine.v1.json         | 133 ++-
 .../documents/discoveryengine.v1alpha.json    | 815 ++++++++++++++++--
 .../documents/discoveryengine.v1beta.json     | 144 +++-
 40 files changed, 1793 insertions(+), 708 deletions(-)
 create mode 100644 docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.files.html

diff --git a/docs/dyn/discoveryengine_v1.projects.html b/docs/dyn/discoveryengine_v1.projects.html
index a0cab0f983d..29423e4cde3 100644
--- a/docs/dyn/discoveryengine_v1.projects.html
+++ b/docs/dyn/discoveryengine_v1.projects.html
@@ -108,6 +108,9 @@ 
Method Details

 { # Request for ProjectService.ProvisionProject method.
   "acceptDataUseTerms": True or False, # Required. Set to `true` to specify that caller has read and would like to give consent to the [Terms for data use](https://cloud.google.com/retail/data-use-terms).
   "dataUseTermsVersion": "A String", # Required. The version of the [Terms for data use](https://cloud.google.com/retail/data-use-terms) that caller has read and would like to give consent to. Acceptable version is `2022-11-23`, and this may change over time.
+  "saasParams": { # Parameters for Agentspace. # Optional. Parameters for Agentspace.
+    "acceptBizQos": True or False, # Optional. Set to `true` to specify that caller has read and would like to give consent to the [Terms for Agent Space quality of service].
+  },
 }
 
   x__xgafv: string, V1 error format.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.cmekConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.cmekConfigs.html
index cf8596b981c..be3a054d4ce 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.cmekConfigs.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.cmekConfigs.html
@@ -146,8 +146,8 @@ 
Method Details

 
     { # Configurations used to enable CMEK data encryption with Cloud KMS keys.
   "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-  "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-  "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+  "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+  "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
   "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
   "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
   "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -178,8 +178,8 @@ 
Method Details

   "cmekConfigs": [ # All the customer's CmekConfigs.
     { # Configurations used to enable CMEK data encryption with Cloud KMS keys.
       "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-      "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-      "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+      "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+      "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
       "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
       "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
       "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -205,8 +205,8 @@ 
Method Details

 
 { # Configurations used to enable CMEK data encryption with Cloud KMS keys.
   "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-  "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-  "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+  "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+  "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
   "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
   "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
   "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.html
index ccf727bcab3..cb231f0ab9d 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.html
@@ -236,8 +236,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -446,8 +446,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -612,8 +612,8 @@ 
Method Details

       },
       "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
         "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-        "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-        "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+        "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+        "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
         "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
         "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
         "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -766,8 +766,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -902,8 +902,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
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 db1d8b6f959..94a40c74a01 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.sessions.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.dataStores.sessions.html
@@ -638,7 +638,7 @@ 
Method Details

 
 Args:
   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, starred. Examples: "user_pseudo_id = some_id" "starred = true"
+  filter: string, A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: "user_pseudo_id = some_id" "display_name = \"some_name\"" "starred = true" "is_pinned=true AND (NOT labels:hidden)" "create_time > \"1970-01-01T12:00:00Z\""
   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` * `is_pinned` Example: * "update_time desc" * "create_time" * "is_pinned desc,update_time desc": list sessions by is_pinned first, then by update_time.
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, A page token, received from a previous `ListSessions` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.html b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.html
index c3a5195cd9f..a8a6b201959 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.assistants.html
@@ -77,6 +77,12 @@ 
Instance Methods

 

   close()

 
Close httplib2 connections.

+

+  get(name, x__xgafv=None)

+
Gets an Assistant.

+

+  patch(name, body=None, updateMask=None, x__xgafv=None)

+
Updates an Assistant

 

   streamAssist(name, body=None, x__xgafv=None)

 
Assists the user with a query in a streaming fashion.

@@ -86,6 +92,52 @@ 
Method Details

   
Close httplib2 connections.

 

 
+

+    get(name, x__xgafv=None)
+  
Gets an Assistant.
+
+Args:
+  name: string, Required. Resource name of Assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Discovery Engine Assistant resource.
+  "name": "A String", # Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.
+}

+

+
+

+    patch(name, body=None, updateMask=None, x__xgafv=None)
+  
Updates an Assistant
+
+Args:
+  name: string, Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Discovery Engine Assistant resource.
+  "name": "A String", # Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.
+}
+
+  updateMask: string, The list of fields to update.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Discovery Engine Assistant resource.
+  "name": "A String", # Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.
+}

+

+
 

     streamAssist(name, body=None, x__xgafv=None)
   
Assists the user with a query in a streaming fashion.
@@ -107,7 +159,6 @@ 
Method Details

   "toolsSpec": { # Specification of tools that are used to serve the request. # Optional. Specification of tools that are used to serve the request.
     "imageGenerationSpec": { # Specification of the image generation tool. # Optional. Specification of the image generation tool.
     },
-    "toolRegistry": "A String", # Optional. The name of the tool registry to use. Format: `projects/{project}/locations/{location}/toolRegistries/{tool_registry}`
     "vertexAiSearchSpec": { # Specification of the Vertex AI Search tool. # Optional. Specification of the Vertex AI Search tool.
       "dataStoreSpecs": [ # Optional. Specs defining DataStores to filter on in a search call and configurations for those data stores. This is only considered for Engines with multiple data stores.
         { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
@@ -135,13 +186,11 @@ 
Method Details

           "filter": "A String", # Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
         },
       ],
-      "disabled": True or False, # Optional. Deprecated. Please refrain from using this field. Whether the Vertex AI Search tool is disabled. Default value is false, the tool is enabled by default.
       "filter": "A String", # Optional. The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. Filter expression is case-sensitive. If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. Filtering in Vertex AI Search is done by mapping the LHS filter key to a key property defined in the Vertex AI Search backend -- this mapping is defined by the customer in their schema. For example a media customer might have a field 'name' in their schema. In this case the filter would look like this: filter --> name:'ANY("king kong")' For more information about filtering including syntax and filter operators, see [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
     },
     "videoGenerationSpec": { # Specification of the video generation tool. # Optional. Specification of the video generation tool.
     },
     "webGroundingSpec": { # Specification of the web grounding tool. # Optional. Specification of the web grounding tool. If field is present, enables grounding with web search. Works only if Assistant.web_grounding_type is WEB_GROUNDING_TYPE_GOOGLE_SEARCH or WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH.
-      "enabled": True or False, # Optional. Deprecated. Please refrain from using this field. Whether the web grounding tool is enabled.
     },
   },
   "userMetadata": { # User metadata of the request. # Optional. Information about the user initiating the query.
@@ -163,6 +212,7 @@ 
Method Details

     "assistSkippedReasons": [ # Reasons for not answering the assist call.
       "A String",
     ],
+    "name": "A String", # Immutable. Identifier. Resource name of the `AssistAnswer`. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/assistAnswers/{assist_answer}` This field must be a UTF-8 encoded string with a length limit of 1024 characters.
     "replies": [ # Replies of the assistant.
       { # One part of the multi-part response of the assist call.
         "groundedContent": { # A piece of content and possibly its grounding information. Not all content needs grounding. Phrases like "Of course, I will gladly search it for you." do not need grounding. # Possibly grounded response text or media from the assistant.
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 bed838b459e..e0af3f3c865 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.sessions.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.collections.engines.sessions.html
@@ -638,7 +638,7 @@ 
Method Details

 
 Args:
   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, starred. Examples: "user_pseudo_id = some_id" "starred = true"
+  filter: string, A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: "user_pseudo_id = some_id" "display_name = \"some_name\"" "starred = true" "is_pinned=true AND (NOT labels:hidden)" "create_time > \"1970-01-01T12:00:00Z\""
   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` * `is_pinned` Example: * "update_time desc" * "create_time" * "is_pinned desc,update_time desc": list sessions by is_pinned first, then by update_time.
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, A page token, received from a previous `ListSessions` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.html
index 00b173d8fed..34fc81369c6 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.html
@@ -228,8 +228,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -438,8 +438,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -604,8 +604,8 @@ 
Method Details

       },
       "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
         "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-        "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-        "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+        "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+        "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
         "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
         "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
         "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -758,8 +758,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -894,8 +894,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.sessions.html b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.sessions.html
index ee2b684fabb..08967ff3991 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.dataStores.sessions.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.dataStores.sessions.html
@@ -638,7 +638,7 @@ 
Method Details

 
 Args:
   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, starred. Examples: "user_pseudo_id = some_id" "starred = true"
+  filter: string, A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: "user_pseudo_id = some_id" "display_name = \"some_name\"" "starred = true" "is_pinned=true AND (NOT labels:hidden)" "create_time > \"1970-01-01T12:00:00Z\""
   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` * `is_pinned` Example: * "update_time desc" * "create_time" * "is_pinned desc,update_time desc": list sessions by is_pinned first, then by update_time.
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, A page token, received from a previous `ListSessions` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.html b/docs/dyn/discoveryengine_v1.projects.locations.html
index 230ccfc40ca..6eb42801ab7 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.html
@@ -155,8 +155,8 @@ 
Method Details

 
     { # Configurations used to enable CMEK data encryption with Cloud KMS keys.
   "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-  "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-  "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+  "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+  "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
   "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
   "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
   "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -180,8 +180,8 @@ 
Method Details

 
 { # Configurations used to enable CMEK data encryption with Cloud KMS keys.
   "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-  "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-  "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+  "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+  "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
   "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
   "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
   "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.identityMappingStores.html b/docs/dyn/discoveryengine_v1.projects.locations.identityMappingStores.html
index 3dc8e6f088d..c1e6b07efbf 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.identityMappingStores.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.identityMappingStores.html
@@ -127,8 +127,8 @@ 
Method Details

 { # Identity Mapping Store which contains Identity Mapping Entries.
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the Identity Mapping Store.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -157,8 +157,8 @@ 
Method Details

     { # Identity Mapping Store which contains Identity Mapping Entries.
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the Identity Mapping Store.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -226,8 +226,8 @@ 
Method Details

     { # Identity Mapping Store which contains Identity Mapping Entries.
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the Identity Mapping Store.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -314,8 +314,8 @@ 
Method Details

     { # Identity Mapping Store which contains Identity Mapping Entries.
       "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the Identity Mapping Store.
         "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-        "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-        "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+        "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+        "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
         "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
         "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
         "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
diff --git a/docs/dyn/discoveryengine_v1.projects.locations.rankingConfigs.html b/docs/dyn/discoveryengine_v1.projects.locations.rankingConfigs.html
index 999926a374d..e95dc206b4d 100644
--- a/docs/dyn/discoveryengine_v1.projects.locations.rankingConfigs.html
+++ b/docs/dyn/discoveryengine_v1.projects.locations.rankingConfigs.html
@@ -99,7 +99,7 @@ 
Method Details

   "ignoreRecordDetailsInResponse": True or False, # If true, the response will contain only record ID and score. By default, it is false, the response will contain record details.
   "model": "A String", # The identifier of the model to use. It is one of: * `semantic-ranker-512@latest`: Semantic ranking model with maximum input token size 512. It is set to `semantic-ranker-512@latest` by default if unspecified.
   "query": "A String", # The query to use.
-  "records": [ # Required. A list of records to rank. At most 200 records to rank.
+  "records": [ # Required. A list of records to rank.
     { # Record message for RankService.Rank method.
       "content": "A String", # The content of the record. Empty by default. At least one of title or content should be set otherwise an INVALID_ARGUMENT error is thrown.
       "id": "A String", # The unique ID to represent the record.
diff --git a/docs/dyn/discoveryengine_v1alpha.media.html b/docs/dyn/discoveryengine_v1alpha.media.html
index 305787e875f..cb2daa4aab2 100644
--- a/docs/dyn/discoveryengine_v1alpha.media.html
+++ b/docs/dyn/discoveryengine_v1alpha.media.html
@@ -78,8 +78,11 @@ 
Instance Methods

   close()

 
Close httplib2 connections.

 

-  upload(parent, body=None, media_body=None, media_mime_type=None, x__xgafv=None)

-
Uploads a file for Notebook LM to use. Creates a Source.

+  download(name, fileId=None, viewId=None, x__xgafv=None)

+
Downloads a file from the session.

+

+  download_media(name, fileId=None, viewId=None, x__xgafv=None)

+
Downloads a file from the session.

 
Method Details

 

     close()
@@ -87,274 +90,120 @@ 
Method Details

 

 
 

-    upload(parent, body=None, media_body=None, media_mime_type=None, x__xgafv=None)
-  
Uploads a file for Notebook LM to use. Creates a Source.
+    download(name, fileId=None, viewId=None, x__xgafv=None)
+  
Downloads a file from the session.
 
 Args:
-  parent: string, Required. The parent resource where the sources will be created. Format: projects/{project}/locations/{location}/notebooks/{notebook} (required)
-  body: object, The request body.
-    The object takes the form of:
+  name: string, Required. The resource name of the Session. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}` (required)
+  fileId: string, Required. The ID of the file to be downloaded.
+  viewId: string, Optional. The ID of the view to be downloaded.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
 
-{ # Request for the SourceService.UploadSourceFile method.
-  "blob": { # A reference to data stored on the filesystem, on GFS or in blobstore. # Information about the file being uploaded.
-    "algorithm": "A String", # Deprecated, use one of explicit hash type fields instead. Algorithm used for calculating the hash. As of 2011/01/21, "MD5" is the only possible value for this field. New values may be added at any time.
-    "bigstoreObjectRef": "A String", # Use object_id instead.
-    "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
-    "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
-      "blobGeneration": "A String", # The blob generation id.
-      "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
-      "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
-      "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
-      "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
-    },
-    "compositeMedia": [ # A composite media composed of one or more media objects, set if reference_type is COMPOSITE_MEDIA. The media length field must be set to the sum of the lengths of all composite media objects. Note: All composite media must have length specified.
-      { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites.
-        "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
-        "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
-          "blobGeneration": "A String", # The blob generation id.
-          "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
-          "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
-          "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
-          "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
-        },
-        "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
-        "crc32cHash": 42, # crc32.c hash for the payload.
-        "inline": "A String", # Media data, set if reference_type is INLINE
-        "length": "A String", # Size of the data, in bytes
-        "md5Hash": "A String", # MD5 hash for the payload.
-        "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
-          "bucketName": "A String", # The name of the bucket to which this object belongs.
-          "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
-          "objectName": "A String", # The name of the object.
-        },
-        "path": "A String", # Path to the data, set if reference_type is PATH
-        "referenceType": "A String", # Describes what the field reference contains.
-        "sha1Hash": "A String", # SHA-1 hash for the payload.
-      },
-    ],
-    "contentType": "A String", # MIME type of the data
-    "contentTypeInfo": { # Detailed Content-Type information from Scotty. The Content-Type of the media will typically be filled in by the header or Scotty's best_guess, but this extended information provides the backend with more information so that it can make a better decision if needed. This is only used on media upload requests from Scotty. # Extended content type information provided for Scotty uploads.
-      "bestGuess": "A String", # Scotty's best guess of what the content type of the file is.
-      "fromBytes": "A String", # The content type of the file derived by looking at specific bytes (i.e. "magic bytes") of the actual file.
-      "fromFileName": "A String", # The content type of the file derived from the file extension of the original file name used by the client.
-      "fromHeader": "A String", # The content type of the file as specified in the request headers, multipart headers, or RUPIO start request.
-      "fromUrlPath": "A String", # The content type of the file derived from the file extension of the URL path. The URL path is assumed to represent a file name (which is typically only true for agents that are providing a REST API).
-    },
-    "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
-    "crc32cHash": 42, # For Scotty Uploads: Scotty-provided hashes for uploads For Scotty Downloads: (WARNING: DO NOT USE WITHOUT PERMISSION FROM THE SCOTTY TEAM.) A Hash provided by the agent to be used to verify the data being downloaded. Currently only supported for inline payloads. Further, only crc32c_hash is currently supported.
-    "diffChecksumsResponse": { # Backend response for a Diff get checksums response. For details on the Scotty Diff protocol, visit http://go/scotty-diff-protocol. # Set if reference_type is DIFF_CHECKSUMS_RESPONSE.
-      "checksumsLocation": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # Exactly one of these fields must be populated. If checksums_location is filled, the server will return the corresponding contents to the user. If object_location is filled, the server will calculate the checksums based on the content there and return that to the user. For details on the format of the checksums, see http://go/scotty-diff-protocol.
-        "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
-        "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
-          "blobGeneration": "A String", # The blob generation id.
-          "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
-          "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
-          "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
-          "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
-        },
-        "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
-        "crc32cHash": 42, # crc32.c hash for the payload.
-        "inline": "A String", # Media data, set if reference_type is INLINE
-        "length": "A String", # Size of the data, in bytes
-        "md5Hash": "A String", # MD5 hash for the payload.
-        "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
-          "bucketName": "A String", # The name of the bucket to which this object belongs.
-          "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
-          "objectName": "A String", # The name of the object.
-        },
-        "path": "A String", # Path to the data, set if reference_type is PATH
-        "referenceType": "A String", # Describes what the field reference contains.
-        "sha1Hash": "A String", # SHA-1 hash for the payload.
-      },
-      "chunkSizeBytes": "A String", # The chunk size of checksums. Must be a multiple of 256KB.
-      "objectLocation": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # If set, calculate the checksums based on the contents and return them to the caller.
-        "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
-        "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
-          "blobGeneration": "A String", # The blob generation id.
-          "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
-          "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
-          "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
-          "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
-        },
-        "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
-        "crc32cHash": 42, # crc32.c hash for the payload.
-        "inline": "A String", # Media data, set if reference_type is INLINE
-        "length": "A String", # Size of the data, in bytes
-        "md5Hash": "A String", # MD5 hash for the payload.
-        "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
-          "bucketName": "A String", # The name of the bucket to which this object belongs.
-          "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
-          "objectName": "A String", # The name of the object.
-        },
-        "path": "A String", # Path to the data, set if reference_type is PATH
-        "referenceType": "A String", # Describes what the field reference contains.
-        "sha1Hash": "A String", # SHA-1 hash for the payload.
+Returns:
+  An object of the form:
+
+    { # A reference to data stored on the filesystem, on GFS or in blobstore.
+  "algorithm": "A String", # Deprecated, use one of explicit hash type fields instead. Algorithm used for calculating the hash. As of 2011/01/21, "MD5" is the only possible value for this field. New values may be added at any time.
+  "bigstoreObjectRef": "A String", # Use object_id instead.
+  "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
+  "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
+    "blobGeneration": "A String", # The blob generation id.
+    "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
+    "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
+    "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
+    "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
+  },
+  "compositeMedia": [ # A composite media composed of one or more media objects, set if reference_type is COMPOSITE_MEDIA. The media length field must be set to the sum of the lengths of all composite media objects. Note: All composite media must have length specified.
+    { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites.
+      "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
+      "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
+        "blobGeneration": "A String", # The blob generation id.
+        "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
+        "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
+        "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
+        "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
       },
-      "objectSizeBytes": "A String", # The total size of the server object.
-      "objectVersion": "A String", # The object version of the object the checksums are being returned for.
-    },
-    "diffDownloadResponse": { # Backend response for a Diff download response. For details on the Scotty Diff protocol, visit http://go/scotty-diff-protocol. # Set if reference_type is DIFF_DOWNLOAD_RESPONSE.
-      "objectLocation": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # The original object location.
-        "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
-        "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
-          "blobGeneration": "A String", # The blob generation id.
-          "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
-          "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
-          "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
-          "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
-        },
-        "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
-        "crc32cHash": 42, # crc32.c hash for the payload.
-        "inline": "A String", # Media data, set if reference_type is INLINE
-        "length": "A String", # Size of the data, in bytes
-        "md5Hash": "A String", # MD5 hash for the payload.
-        "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
-          "bucketName": "A String", # The name of the bucket to which this object belongs.
-          "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
-          "objectName": "A String", # The name of the object.
-        },
-        "path": "A String", # Path to the data, set if reference_type is PATH
-        "referenceType": "A String", # Describes what the field reference contains.
-        "sha1Hash": "A String", # SHA-1 hash for the payload.
+      "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
+      "crc32cHash": 42, # crc32.c hash for the payload.
+      "inline": "A String", # Media data, set if reference_type is INLINE
+      "length": "A String", # Size of the data, in bytes
+      "md5Hash": "A String", # MD5 hash for the payload.
+      "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
+        "bucketName": "A String", # The name of the bucket to which this object belongs.
+        "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
+        "objectName": "A String", # The name of the object.
       },
+      "path": "A String", # Path to the data, set if reference_type is PATH
+      "referenceType": "A String", # Describes what the field reference contains.
+      "sha1Hash": "A String", # SHA-1 hash for the payload.
     },
-    "diffUploadRequest": { # A Diff upload request. For details on the Scotty Diff protocol, visit http://go/scotty-diff-protocol. # Set if reference_type is DIFF_UPLOAD_REQUEST.
-      "checksumsInfo": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # The location of the checksums for the new object. Agents must clone the object located here, as the upload server will delete the contents once a response is received. For details on the format of the checksums, see http://go/scotty-diff-protocol.
-        "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
-        "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
-          "blobGeneration": "A String", # The blob generation id.
-          "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
-          "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
-          "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
-          "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
-        },
-        "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
-        "crc32cHash": 42, # crc32.c hash for the payload.
-        "inline": "A String", # Media data, set if reference_type is INLINE
-        "length": "A String", # Size of the data, in bytes
-        "md5Hash": "A String", # MD5 hash for the payload.
-        "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
-          "bucketName": "A String", # The name of the bucket to which this object belongs.
-          "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
-          "objectName": "A String", # The name of the object.
-        },
-        "path": "A String", # Path to the data, set if reference_type is PATH
-        "referenceType": "A String", # Describes what the field reference contains.
-        "sha1Hash": "A String", # SHA-1 hash for the payload.
+  ],
+  "contentType": "A String", # MIME type of the data
+  "contentTypeInfo": { # Detailed Content-Type information from Scotty. The Content-Type of the media will typically be filled in by the header or Scotty's best_guess, but this extended information provides the backend with more information so that it can make a better decision if needed. This is only used on media upload requests from Scotty. # Extended content type information provided for Scotty uploads.
+    "bestGuess": "A String", # Scotty's best guess of what the content type of the file is.
+    "fromBytes": "A String", # The content type of the file derived by looking at specific bytes (i.e. "magic bytes") of the actual file.
+    "fromFileName": "A String", # The content type of the file derived from the file extension of the original file name used by the client.
+    "fromHeader": "A String", # The content type of the file as specified in the request headers, multipart headers, or RUPIO start request.
+    "fromUrlPath": "A String", # The content type of the file derived from the file extension of the URL path. The URL path is assumed to represent a file name (which is typically only true for agents that are providing a REST API).
+  },
+  "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
+  "crc32cHash": 42, # For Scotty Uploads: Scotty-provided hashes for uploads For Scotty Downloads: (WARNING: DO NOT USE WITHOUT PERMISSION FROM THE SCOTTY TEAM.) A Hash provided by the agent to be used to verify the data being downloaded. Currently only supported for inline payloads. Further, only crc32c_hash is currently supported.
+  "diffChecksumsResponse": { # Backend response for a Diff get checksums response. For details on the Scotty Diff protocol, visit http://go/scotty-diff-protocol. # Set if reference_type is DIFF_CHECKSUMS_RESPONSE.
+    "checksumsLocation": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # Exactly one of these fields must be populated. If checksums_location is filled, the server will return the corresponding contents to the user. If object_location is filled, the server will calculate the checksums based on the content there and return that to the user. For details on the format of the checksums, see http://go/scotty-diff-protocol.
+      "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
+      "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
+        "blobGeneration": "A String", # The blob generation id.
+        "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
+        "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
+        "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
+        "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
       },
-      "objectInfo": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # The location of the new object. Agents must clone the object located here, as the upload server will delete the contents once a response is received.
-        "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
-        "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
-          "blobGeneration": "A String", # The blob generation id.
-          "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
-          "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
-          "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
-          "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
-        },
-        "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
-        "crc32cHash": 42, # crc32.c hash for the payload.
-        "inline": "A String", # Media data, set if reference_type is INLINE
-        "length": "A String", # Size of the data, in bytes
-        "md5Hash": "A String", # MD5 hash for the payload.
-        "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
-          "bucketName": "A String", # The name of the bucket to which this object belongs.
-          "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
-          "objectName": "A String", # The name of the object.
-        },
-        "path": "A String", # Path to the data, set if reference_type is PATH
-        "referenceType": "A String", # Describes what the field reference contains.
-        "sha1Hash": "A String", # SHA-1 hash for the payload.
+      "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
+      "crc32cHash": 42, # crc32.c hash for the payload.
+      "inline": "A String", # Media data, set if reference_type is INLINE
+      "length": "A String", # Size of the data, in bytes
+      "md5Hash": "A String", # MD5 hash for the payload.
+      "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
+        "bucketName": "A String", # The name of the bucket to which this object belongs.
+        "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
+        "objectName": "A String", # The name of the object.
       },
-      "objectVersion": "A String", # The object version of the object that is the base version the incoming diff script will be applied to. This field will always be filled in.
+      "path": "A String", # Path to the data, set if reference_type is PATH
+      "referenceType": "A String", # Describes what the field reference contains.
+      "sha1Hash": "A String", # SHA-1 hash for the payload.
     },
-    "diffUploadResponse": { # Backend response for a Diff upload request. For details on the Scotty Diff protocol, visit http://go/scotty-diff-protocol. # Set if reference_type is DIFF_UPLOAD_RESPONSE.
-      "objectVersion": "A String", # The object version of the object at the server. Must be included in the end notification response. The version in the end notification response must correspond to the new version of the object that is now stored at the server, after the upload.
-      "originalObject": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # The location of the original file for a diff upload request. Must be filled in if responding to an upload start notification.
-        "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
-        "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
-          "blobGeneration": "A String", # The blob generation id.
-          "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
-          "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
-          "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
-          "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
-        },
-        "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
-        "crc32cHash": 42, # crc32.c hash for the payload.
-        "inline": "A String", # Media data, set if reference_type is INLINE
-        "length": "A String", # Size of the data, in bytes
-        "md5Hash": "A String", # MD5 hash for the payload.
-        "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
-          "bucketName": "A String", # The name of the bucket to which this object belongs.
-          "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
-          "objectName": "A String", # The name of the object.
-        },
-        "path": "A String", # Path to the data, set if reference_type is PATH
-        "referenceType": "A String", # Describes what the field reference contains.
-        "sha1Hash": "A String", # SHA-1 hash for the payload.
+    "chunkSizeBytes": "A String", # The chunk size of checksums. Must be a multiple of 256KB.
+    "objectLocation": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # If set, calculate the checksums based on the contents and return them to the caller.
+      "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
+      "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
+        "blobGeneration": "A String", # The blob generation id.
+        "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
+        "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
+        "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
+        "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
       },
+      "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
+      "crc32cHash": 42, # crc32.c hash for the payload.
+      "inline": "A String", # Media data, set if reference_type is INLINE
+      "length": "A String", # Size of the data, in bytes
+      "md5Hash": "A String", # MD5 hash for the payload.
+      "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
+        "bucketName": "A String", # The name of the bucket to which this object belongs.
+        "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
+        "objectName": "A String", # The name of the object.
+      },
+      "path": "A String", # Path to the data, set if reference_type is PATH
+      "referenceType": "A String", # Describes what the field reference contains.
+      "sha1Hash": "A String", # SHA-1 hash for the payload.
     },
-    "diffVersionResponse": { # Backend response for a Diff get version response. For details on the Scotty Diff protocol, visit http://go/scotty-diff-protocol. # Set if reference_type is DIFF_VERSION_RESPONSE.
-      "objectSizeBytes": "A String", # The total size of the server object.
-      "objectVersion": "A String", # The version of the object stored at the server.
-    },
-    "downloadParameters": { # Parameters specific to media downloads. # Parameters for a media download.
-      "allowGzipCompression": True or False, # A boolean to be returned in the response to Scotty. Allows/disallows gzip encoding of the payload content when the server thinks it's advantageous (hence, does not guarantee compression) which allows Scotty to GZip the response to the client.
-      "ignoreRange": True or False, # Determining whether or not Apiary should skip the inclusion of any Content-Range header on its response to Scotty.
-    },
-    "filename": "A String", # Original file name
-    "hash": "A String", # Deprecated, use one of explicit hash type fields instead. These two hash related fields will only be populated on Scotty based media uploads and will contain the content of the hash group in the NotificationRequest: http://cs/#google3/blobstore2/api/scotty/service/proto/upload_listener.proto&q=class:Hash Hex encoded hash value of the uploaded media.
-    "hashVerified": True or False, # For Scotty uploads only. If a user sends a hash code and the backend has requested that Scotty verify the upload against the client hash, Scotty will perform the check on behalf of the backend and will reject it if the hashes don't match. This is set to true if Scotty performed this verification.
-    "inline": "A String", # Media data, set if reference_type is INLINE
-    "isPotentialRetry": True or False, # |is_potential_retry| is set false only when Scotty is certain that it has not sent the request before. When a client resumes an upload, this field must be set true in agent calls, because Scotty cannot be certain that it has never sent the request before due to potential failure in the session state persistence.
-    "length": "A String", # Size of the data, in bytes
-    "md5Hash": "A String", # Scotty-provided MD5 hash for an upload.
-    "mediaId": "A String", # Media id to forward to the operation GetMedia. Can be set if reference_type is GET_MEDIA.
-    "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
-      "bucketName": "A String", # The name of the bucket to which this object belongs.
-      "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
-      "objectName": "A String", # The name of the object.
-    },
-    "path": "A String", # Path to the data, set if reference_type is PATH
-    "referenceType": "A String", # Describes what the field reference contains.
-    "sha1Hash": "A String", # Scotty-provided SHA1 hash for an upload.
-    "sha256Hash": "A String", # Scotty-provided SHA256 hash for an upload.
-    "timestamp": "A String", # Time at which the media data was last updated, in milliseconds since UNIX epoch
-    "token": "A String", # A unique fingerprint/version id for the media data
+    "objectSizeBytes": "A String", # The total size of the server object.
+    "objectVersion": "A String", # The object version of the object the checksums are being returned for.
   },
-  "mediaRequestInfo": { # Extra information added to operations that support Scotty media requests. # Media upload request metadata.
-    "currentBytes": "A String", # The number of current bytes uploaded or downloaded.
-    "customData": "A String", # Data to be copied to backend requests. Custom data is returned to Scotty in the agent_state field, which Scotty will then provide in subsequent upload notifications.
-    "diffObjectVersion": "A String", # Set if the http request info is diff encoded. The value of this field is the version number of the base revision. This is corresponding to Apiary's mediaDiffObjectVersion (//depot/google3/java/com/google/api/server/media/variable/DiffObjectVersionVariable.java). See go/esf-scotty-diff-upload for more information.
-    "finalStatus": 42, # The existence of the final_status field indicates that this is the last call to the agent for this request_id. http://google3/uploader/agent/scotty_agent.proto?l=737&rcl=347601929
-    "notificationType": "A String", # The type of notification received from Scotty.
-    "requestId": "A String", # The Scotty request ID.
-    "requestReceivedParamsServingInfo": "A String", # The partition of the Scotty server handling this request. type is uploader_service.RequestReceivedParamsServingInfo LINT.IfChange(request_received_params_serving_info_annotations) LINT.ThenChange()
-    "totalBytes": "A String", # The total size of the file.
-    "totalBytesIsEstimated": True or False, # Whether the total bytes field contains an estimated data.
-  },
-  "sourceId": "A String", # The source id of the associated file. If not set, a source id will be generated and a new tentative source will be created.
-}
-
-  media_body: string, The filename of the media request body, or an instance of a MediaUpload object.
-  media_mime_type: string, The MIME type of the media request body, or an instance of a MediaUpload object.
-  x__xgafv: string, V1 error format.
-    Allowed values
-      1 - v1 error format
-      2 - v2 error format
-
-Returns:
-  An object of the form:
-
-    { # Response for the SourceService.UploadSourceFile method.
-  "mediaResponseInfo": { # This message is for backends to pass their scotty media specific fields to ESF. Backend will include this in their response message to ESF. Example: ExportFile is an rpc defined for upload using scotty from ESF. rpc ExportFile(ExportFileRequest) returns (ExportFileResponse) Message ExportFileResponse will include apiserving.MediaResponseInfo to tell ESF about data like dynamic_dropzone it needs to pass to Scotty. message ExportFileResponse { optional gdata.Media blob = 1; optional apiserving.MediaResponseInfo media_response_info = 2 } # Media upload response metadata.
-    "customData": "A String", # Data to copy from backend response to the next backend requests. Custom data is returned to Scotty in the agent_state field, which Scotty will then provide in subsequent upload notifications.
-    "dataStorageTransform": "A String", # Specifies any transformation to be applied to data before persisting it or retrieving from storage. E.g., encryption options for blobstore2. This should be of the form uploader_service.DataStorageTransform.
-    "destinationBlobMintIndex": 42, # For the first notification of a |diff_encoded| HttpRequestInfo, this is the index of the blob mint that Scotty should use when writing the resulting blob. This field is optional. It's not required ever, even if `original_object_blob_mint_index` is set. In situations like that, we will use the destination blob's mint for the destination blob and regular blob ACL checks for the original object. Note: This field is only for use by Drive API for diff uploads.
-    "dynamicDropTarget": "A String", # Specifies the Scotty Drop Target to use for uploads. If present in a media response, Scotty does not upload to a standard drop zone. Instead, Scotty saves the upload directly to the location specified in this drop target. Unlike drop zones, the drop target is the final storage location for an upload. So, the agent does not need to clone the blob at the end of the upload. The agent is responsible for garbage collecting any orphaned blobs that may occur due to aborted uploads. For more information, see the drop target design doc here: http://goto/ScottyDropTarget This field will be preferred to dynamicDropzone. If provided, the identified field in the response must be of the type uploader.agent.DropTarget.
-    "dynamicDropzone": "A String", # Specifies the Scotty dropzone to use for uploads.
-    "mediaForDiff": { # A reference to data stored on the filesystem, on GFS or in blobstore. # Diff Updates must respond to a START notification with this Media proto to tell Scotty to decode the diff encoded payload and apply the diff against this field. If the request was diff encoded, but this field is not set, Scotty will treat the encoding as identity. This is corresponding to Apiary's DiffUploadResponse.original_object (//depot/google3/gdata/rosy/proto/data.proto?l=413). See go/esf-scotty-diff-upload for more information.
-      "algorithm": "A String", # Deprecated, use one of explicit hash type fields instead. Algorithm used for calculating the hash. As of 2011/01/21, "MD5" is the only possible value for this field. New values may be added at any time.
-      "bigstoreObjectRef": "A String", # Use object_id instead.
+  "diffDownloadResponse": { # Backend response for a Diff download response. For details on the Scotty Diff protocol, visit http://go/scotty-diff-protocol. # Set if reference_type is DIFF_DOWNLOAD_RESPONSE.
+    "objectLocation": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # The original object location.
       "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
       "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
         "blobGeneration": "A String", # The blob generation id.
@@ -363,208 +212,86 @@ 
Method Details

         "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
         "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
       },
-      "compositeMedia": [ # A composite media composed of one or more media objects, set if reference_type is COMPOSITE_MEDIA. The media length field must be set to the sum of the lengths of all composite media objects. Note: All composite media must have length specified.
-        { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites.
-          "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
-          "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
-            "blobGeneration": "A String", # The blob generation id.
-            "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
-            "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
-            "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
-            "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
-          },
-          "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
-          "crc32cHash": 42, # crc32.c hash for the payload.
-          "inline": "A String", # Media data, set if reference_type is INLINE
-          "length": "A String", # Size of the data, in bytes
-          "md5Hash": "A String", # MD5 hash for the payload.
-          "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
-            "bucketName": "A String", # The name of the bucket to which this object belongs.
-            "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
-            "objectName": "A String", # The name of the object.
-          },
-          "path": "A String", # Path to the data, set if reference_type is PATH
-          "referenceType": "A String", # Describes what the field reference contains.
-          "sha1Hash": "A String", # SHA-1 hash for the payload.
-        },
-      ],
-      "contentType": "A String", # MIME type of the data
-      "contentTypeInfo": { # Detailed Content-Type information from Scotty. The Content-Type of the media will typically be filled in by the header or Scotty's best_guess, but this extended information provides the backend with more information so that it can make a better decision if needed. This is only used on media upload requests from Scotty. # Extended content type information provided for Scotty uploads.
-        "bestGuess": "A String", # Scotty's best guess of what the content type of the file is.
-        "fromBytes": "A String", # The content type of the file derived by looking at specific bytes (i.e. "magic bytes") of the actual file.
-        "fromFileName": "A String", # The content type of the file derived from the file extension of the original file name used by the client.
-        "fromHeader": "A String", # The content type of the file as specified in the request headers, multipart headers, or RUPIO start request.
-        "fromUrlPath": "A String", # The content type of the file derived from the file extension of the URL path. The URL path is assumed to represent a file name (which is typically only true for agents that are providing a REST API).
-      },
       "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
-      "crc32cHash": 42, # For Scotty Uploads: Scotty-provided hashes for uploads For Scotty Downloads: (WARNING: DO NOT USE WITHOUT PERMISSION FROM THE SCOTTY TEAM.) A Hash provided by the agent to be used to verify the data being downloaded. Currently only supported for inline payloads. Further, only crc32c_hash is currently supported.
-      "diffChecksumsResponse": { # Backend response for a Diff get checksums response. For details on the Scotty Diff protocol, visit http://go/scotty-diff-protocol. # Set if reference_type is DIFF_CHECKSUMS_RESPONSE.
-        "checksumsLocation": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # Exactly one of these fields must be populated. If checksums_location is filled, the server will return the corresponding contents to the user. If object_location is filled, the server will calculate the checksums based on the content there and return that to the user. For details on the format of the checksums, see http://go/scotty-diff-protocol.
-          "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
-          "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
-            "blobGeneration": "A String", # The blob generation id.
-            "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
-            "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
-            "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
-            "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
-          },
-          "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
-          "crc32cHash": 42, # crc32.c hash for the payload.
-          "inline": "A String", # Media data, set if reference_type is INLINE
-          "length": "A String", # Size of the data, in bytes
-          "md5Hash": "A String", # MD5 hash for the payload.
-          "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
-            "bucketName": "A String", # The name of the bucket to which this object belongs.
-            "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
-            "objectName": "A String", # The name of the object.
-          },
-          "path": "A String", # Path to the data, set if reference_type is PATH
-          "referenceType": "A String", # Describes what the field reference contains.
-          "sha1Hash": "A String", # SHA-1 hash for the payload.
-        },
-        "chunkSizeBytes": "A String", # The chunk size of checksums. Must be a multiple of 256KB.
-        "objectLocation": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # If set, calculate the checksums based on the contents and return them to the caller.
-          "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
-          "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
-            "blobGeneration": "A String", # The blob generation id.
-            "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
-            "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
-            "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
-            "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
-          },
-          "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
-          "crc32cHash": 42, # crc32.c hash for the payload.
-          "inline": "A String", # Media data, set if reference_type is INLINE
-          "length": "A String", # Size of the data, in bytes
-          "md5Hash": "A String", # MD5 hash for the payload.
-          "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
-            "bucketName": "A String", # The name of the bucket to which this object belongs.
-            "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
-            "objectName": "A String", # The name of the object.
-          },
-          "path": "A String", # Path to the data, set if reference_type is PATH
-          "referenceType": "A String", # Describes what the field reference contains.
-          "sha1Hash": "A String", # SHA-1 hash for the payload.
-        },
-        "objectSizeBytes": "A String", # The total size of the server object.
-        "objectVersion": "A String", # The object version of the object the checksums are being returned for.
+      "crc32cHash": 42, # crc32.c hash for the payload.
+      "inline": "A String", # Media data, set if reference_type is INLINE
+      "length": "A String", # Size of the data, in bytes
+      "md5Hash": "A String", # MD5 hash for the payload.
+      "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
+        "bucketName": "A String", # The name of the bucket to which this object belongs.
+        "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
+        "objectName": "A String", # The name of the object.
       },
-      "diffDownloadResponse": { # Backend response for a Diff download response. For details on the Scotty Diff protocol, visit http://go/scotty-diff-protocol. # Set if reference_type is DIFF_DOWNLOAD_RESPONSE.
-        "objectLocation": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # The original object location.
-          "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
-          "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
-            "blobGeneration": "A String", # The blob generation id.
-            "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
-            "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
-            "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
-            "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
-          },
-          "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
-          "crc32cHash": 42, # crc32.c hash for the payload.
-          "inline": "A String", # Media data, set if reference_type is INLINE
-          "length": "A String", # Size of the data, in bytes
-          "md5Hash": "A String", # MD5 hash for the payload.
-          "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
-            "bucketName": "A String", # The name of the bucket to which this object belongs.
-            "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
-            "objectName": "A String", # The name of the object.
-          },
-          "path": "A String", # Path to the data, set if reference_type is PATH
-          "referenceType": "A String", # Describes what the field reference contains.
-          "sha1Hash": "A String", # SHA-1 hash for the payload.
-        },
+      "path": "A String", # Path to the data, set if reference_type is PATH
+      "referenceType": "A String", # Describes what the field reference contains.
+      "sha1Hash": "A String", # SHA-1 hash for the payload.
+    },
+  },
+  "diffUploadRequest": { # A Diff upload request. For details on the Scotty Diff protocol, visit http://go/scotty-diff-protocol. # Set if reference_type is DIFF_UPLOAD_REQUEST.
+    "checksumsInfo": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # The location of the checksums for the new object. Agents must clone the object located here, as the upload server will delete the contents once a response is received. For details on the format of the checksums, see http://go/scotty-diff-protocol.
+      "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
+      "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
+        "blobGeneration": "A String", # The blob generation id.
+        "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
+        "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
+        "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
+        "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
       },
-      "diffUploadRequest": { # A Diff upload request. For details on the Scotty Diff protocol, visit http://go/scotty-diff-protocol. # Set if reference_type is DIFF_UPLOAD_REQUEST.
-        "checksumsInfo": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # The location of the checksums for the new object. Agents must clone the object located here, as the upload server will delete the contents once a response is received. For details on the format of the checksums, see http://go/scotty-diff-protocol.
-          "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
-          "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
-            "blobGeneration": "A String", # The blob generation id.
-            "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
-            "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
-            "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
-            "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
-          },
-          "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
-          "crc32cHash": 42, # crc32.c hash for the payload.
-          "inline": "A String", # Media data, set if reference_type is INLINE
-          "length": "A String", # Size of the data, in bytes
-          "md5Hash": "A String", # MD5 hash for the payload.
-          "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
-            "bucketName": "A String", # The name of the bucket to which this object belongs.
-            "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
-            "objectName": "A String", # The name of the object.
-          },
-          "path": "A String", # Path to the data, set if reference_type is PATH
-          "referenceType": "A String", # Describes what the field reference contains.
-          "sha1Hash": "A String", # SHA-1 hash for the payload.
-        },
-        "objectInfo": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # The location of the new object. Agents must clone the object located here, as the upload server will delete the contents once a response is received.
-          "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
-          "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
-            "blobGeneration": "A String", # The blob generation id.
-            "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
-            "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
-            "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
-            "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
-          },
-          "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
-          "crc32cHash": 42, # crc32.c hash for the payload.
-          "inline": "A String", # Media data, set if reference_type is INLINE
-          "length": "A String", # Size of the data, in bytes
-          "md5Hash": "A String", # MD5 hash for the payload.
-          "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
-            "bucketName": "A String", # The name of the bucket to which this object belongs.
-            "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
-            "objectName": "A String", # The name of the object.
-          },
-          "path": "A String", # Path to the data, set if reference_type is PATH
-          "referenceType": "A String", # Describes what the field reference contains.
-          "sha1Hash": "A String", # SHA-1 hash for the payload.
-        },
-        "objectVersion": "A String", # The object version of the object that is the base version the incoming diff script will be applied to. This field will always be filled in.
+      "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
+      "crc32cHash": 42, # crc32.c hash for the payload.
+      "inline": "A String", # Media data, set if reference_type is INLINE
+      "length": "A String", # Size of the data, in bytes
+      "md5Hash": "A String", # MD5 hash for the payload.
+      "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
+        "bucketName": "A String", # The name of the bucket to which this object belongs.
+        "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
+        "objectName": "A String", # The name of the object.
       },
-      "diffUploadResponse": { # Backend response for a Diff upload request. For details on the Scotty Diff protocol, visit http://go/scotty-diff-protocol. # Set if reference_type is DIFF_UPLOAD_RESPONSE.
-        "objectVersion": "A String", # The object version of the object at the server. Must be included in the end notification response. The version in the end notification response must correspond to the new version of the object that is now stored at the server, after the upload.
-        "originalObject": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # The location of the original file for a diff upload request. Must be filled in if responding to an upload start notification.
-          "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
-          "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
-            "blobGeneration": "A String", # The blob generation id.
-            "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
-            "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
-            "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
-            "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
-          },
-          "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
-          "crc32cHash": 42, # crc32.c hash for the payload.
-          "inline": "A String", # Media data, set if reference_type is INLINE
-          "length": "A String", # Size of the data, in bytes
-          "md5Hash": "A String", # MD5 hash for the payload.
-          "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
-            "bucketName": "A String", # The name of the bucket to which this object belongs.
-            "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
-            "objectName": "A String", # The name of the object.
-          },
-          "path": "A String", # Path to the data, set if reference_type is PATH
-          "referenceType": "A String", # Describes what the field reference contains.
-          "sha1Hash": "A String", # SHA-1 hash for the payload.
-        },
+      "path": "A String", # Path to the data, set if reference_type is PATH
+      "referenceType": "A String", # Describes what the field reference contains.
+      "sha1Hash": "A String", # SHA-1 hash for the payload.
+    },
+    "objectInfo": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # The location of the new object. Agents must clone the object located here, as the upload server will delete the contents once a response is received.
+      "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
+      "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
+        "blobGeneration": "A String", # The blob generation id.
+        "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
+        "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
+        "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
+        "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
       },
-      "diffVersionResponse": { # Backend response for a Diff get version response. For details on the Scotty Diff protocol, visit http://go/scotty-diff-protocol. # Set if reference_type is DIFF_VERSION_RESPONSE.
-        "objectSizeBytes": "A String", # The total size of the server object.
-        "objectVersion": "A String", # The version of the object stored at the server.
+      "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
+      "crc32cHash": 42, # crc32.c hash for the payload.
+      "inline": "A String", # Media data, set if reference_type is INLINE
+      "length": "A String", # Size of the data, in bytes
+      "md5Hash": "A String", # MD5 hash for the payload.
+      "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
+        "bucketName": "A String", # The name of the bucket to which this object belongs.
+        "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
+        "objectName": "A String", # The name of the object.
       },
-      "downloadParameters": { # Parameters specific to media downloads. # Parameters for a media download.
-        "allowGzipCompression": True or False, # A boolean to be returned in the response to Scotty. Allows/disallows gzip encoding of the payload content when the server thinks it's advantageous (hence, does not guarantee compression) which allows Scotty to GZip the response to the client.
-        "ignoreRange": True or False, # Determining whether or not Apiary should skip the inclusion of any Content-Range header on its response to Scotty.
+      "path": "A String", # Path to the data, set if reference_type is PATH
+      "referenceType": "A String", # Describes what the field reference contains.
+      "sha1Hash": "A String", # SHA-1 hash for the payload.
+    },
+    "objectVersion": "A String", # The object version of the object that is the base version the incoming diff script will be applied to. This field will always be filled in.
+  },
+  "diffUploadResponse": { # Backend response for a Diff upload request. For details on the Scotty Diff protocol, visit http://go/scotty-diff-protocol. # Set if reference_type is DIFF_UPLOAD_RESPONSE.
+    "objectVersion": "A String", # The object version of the object at the server. Must be included in the end notification response. The version in the end notification response must correspond to the new version of the object that is now stored at the server, after the upload.
+    "originalObject": { # A sequence of media data references representing composite data. Introduced to support Bigstore composite objects. For details, visit http://go/bigstore-composites. # The location of the original file for a diff upload request. Must be filled in if responding to an upload start notification.
+      "blobRef": "A String", # Blobstore v1 reference, set if reference_type is BLOBSTORE_REF This should be the byte representation of a blobstore.BlobRef. Since Blobstore is deprecating v1, use blobstore2_info instead. For now, any v2 blob will also be represented in this field as v1 BlobRef.
+      "blobstore2Info": { # Information to read/write to blobstore2. # Blobstore v2 info, set if reference_type is BLOBSTORE_REF and it refers to a v2 blob.
+        "blobGeneration": "A String", # The blob generation id.
+        "blobId": "A String", # The blob id, e.g., /blobstore/prod/playground/scotty
+        "downloadReadHandle": "A String", # Read handle passed from Bigstore -> Scotty for a GCS download. This is a signed, serialized blobstore2.ReadHandle proto which must never be set outside of Bigstore, and is not applicable to non-GCS media downloads.
+        "readToken": "A String", # The blob read token. Needed to read blobs that have not been replicated. Might not be available until the final call.
+        "uploadMetadataContainer": "A String", # Metadata passed from Blobstore -> Scotty for a new GCS upload. This is a signed, serialized blobstore2.BlobMetadataContainer proto which must never be consumed outside of Bigstore, and is not applicable to non-GCS media uploads.
       },
-      "filename": "A String", # Original file name
-      "hash": "A String", # Deprecated, use one of explicit hash type fields instead. These two hash related fields will only be populated on Scotty based media uploads and will contain the content of the hash group in the NotificationRequest: http://cs/#google3/blobstore2/api/scotty/service/proto/upload_listener.proto&q=class:Hash Hex encoded hash value of the uploaded media.
-      "hashVerified": True or False, # For Scotty uploads only. If a user sends a hash code and the backend has requested that Scotty verify the upload against the client hash, Scotty will perform the check on behalf of the backend and will reject it if the hashes don't match. This is set to true if Scotty performed this verification.
+      "cosmoBinaryReference": "A String", # A binary data reference for a media download. Serves as a technology-agnostic binary reference in some Google infrastructure. This value is a serialized storage_cosmo.BinaryReference proto. Storing it as bytes is a hack to get around the fact that the cosmo proto (as well as others it includes) doesn't support JavaScript. This prevents us from including the actual type of this field.
+      "crc32cHash": 42, # crc32.c hash for the payload.
       "inline": "A String", # Media data, set if reference_type is INLINE
-      "isPotentialRetry": True or False, # |is_potential_retry| is set false only when Scotty is certain that it has not sent the request before. When a client resumes an upload, this field must be set true in agent calls, because Scotty cannot be certain that it has never sent the request before due to potential failure in the session state persistence.
       "length": "A String", # Size of the data, in bytes
-      "md5Hash": "A String", # Scotty-provided MD5 hash for an upload.
-      "mediaId": "A String", # Media id to forward to the operation GetMedia. Can be set if reference_type is GET_MEDIA.
+      "md5Hash": "A String", # MD5 hash for the payload.
       "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
         "bucketName": "A String", # The name of the bucket to which this object belongs.
         "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
@@ -572,22 +299,56 @@ 
Method Details

       },
       "path": "A String", # Path to the data, set if reference_type is PATH
       "referenceType": "A String", # Describes what the field reference contains.
-      "sha1Hash": "A String", # Scotty-provided SHA1 hash for an upload.
-      "sha256Hash": "A String", # Scotty-provided SHA256 hash for an upload.
-      "timestamp": "A String", # Time at which the media data was last updated, in milliseconds since UNIX epoch
-      "token": "A String", # A unique fingerprint/version id for the media data
+      "sha1Hash": "A String", # SHA-1 hash for the payload.
     },
-    "originalObjectBlobMintIndex": 42, # For the first notification of a |diff_encoded| HttpRequestInfo, this is the index of the blob mint that Scotty should use when reading the original blob. This field is optional. It's not required ever, even if `destination_blob_mint_index` is set. In situations like that, we will use the destination blob's mint for the destination blob and regular blob ACL checks for the original object. Note: This field is only for use by Drive API for diff uploads.
-    "requestClass": "A String", # Request class to use for all Blobstore operations for this request.
-    "scottyAgentUserId": "A String", # Requester ID passed along to be recorded in the Scotty logs
-    "scottyCustomerLog": "A String", # Customer-specific data to be recorded in the Scotty logs type is logs_proto_scotty.CustomerLog
-    "trafficClassField": "A String", # Specifies the TrafficClass that Scotty should use for any RPCs to fetch the response bytes. Will override the traffic class GTOS of the incoming http request. This is a temporary field to facilitate whitelisting and experimentation by the bigstore agent only. For instance, this does not apply to RTMP reads. WARNING: DO NOT USE WITHOUT PERMISSION FROM THE SCOTTY TEAM.
-    "verifyHashFromHeader": True or False, # Tells Scotty to verify hashes on the agent's behalf by parsing out the X-Goog-Hash header.
   },
-  "sourceId": { # SourceId is the last segment of the source's resource name. # The source id of the uploaded source.
-    "id": "A String", # The id of the source.
+  "diffVersionResponse": { # Backend response for a Diff get version response. For details on the Scotty Diff protocol, visit http://go/scotty-diff-protocol. # Set if reference_type is DIFF_VERSION_RESPONSE.
+    "objectSizeBytes": "A String", # The total size of the server object.
+    "objectVersion": "A String", # The version of the object stored at the server.
+  },
+  "downloadParameters": { # Parameters specific to media downloads. # Parameters for a media download.
+    "allowGzipCompression": True or False, # A boolean to be returned in the response to Scotty. Allows/disallows gzip encoding of the payload content when the server thinks it's advantageous (hence, does not guarantee compression) which allows Scotty to GZip the response to the client.
+    "ignoreRange": True or False, # Determining whether or not Apiary should skip the inclusion of any Content-Range header on its response to Scotty.
   },
+  "filename": "A String", # Original file name
+  "hash": "A String", # Deprecated, use one of explicit hash type fields instead. These two hash related fields will only be populated on Scotty based media uploads and will contain the content of the hash group in the NotificationRequest: http://cs/#google3/blobstore2/api/scotty/service/proto/upload_listener.proto&q=class:Hash Hex encoded hash value of the uploaded media.
+  "hashVerified": True or False, # For Scotty uploads only. If a user sends a hash code and the backend has requested that Scotty verify the upload against the client hash, Scotty will perform the check on behalf of the backend and will reject it if the hashes don't match. This is set to true if Scotty performed this verification.
+  "inline": "A String", # Media data, set if reference_type is INLINE
+  "isPotentialRetry": True or False, # |is_potential_retry| is set false only when Scotty is certain that it has not sent the request before. When a client resumes an upload, this field must be set true in agent calls, because Scotty cannot be certain that it has never sent the request before due to potential failure in the session state persistence.
+  "length": "A String", # Size of the data, in bytes
+  "md5Hash": "A String", # Scotty-provided MD5 hash for an upload.
+  "mediaId": "A String", # Media id to forward to the operation GetMedia. Can be set if reference_type is GET_MEDIA.
+  "objectId": { # This is a copy of the tech.blob.ObjectId proto, which could not be used directly here due to transitive closure issues with JavaScript support; see http://b/8801763. # Reference to a TI Blob, set if reference_type is BIGSTORE_REF.
+    "bucketName": "A String", # The name of the bucket to which this object belongs.
+    "generation": "A String", # Generation of the object. Generations are monotonically increasing across writes, allowing them to be be compared to determine which generation is newer. If this is omitted in a request, then you are requesting the live object. See http://go/bigstore-versions
+    "objectName": "A String", # The name of the object.
+  },
+  "path": "A String", # Path to the data, set if reference_type is PATH
+  "referenceType": "A String", # Describes what the field reference contains.
+  "sha1Hash": "A String", # Scotty-provided SHA1 hash for an upload.
+  "sha256Hash": "A String", # Scotty-provided SHA256 hash for an upload.
+  "timestamp": "A String", # Time at which the media data was last updated, in milliseconds since UNIX epoch
+  "token": "A String", # A unique fingerprint/version id for the media data
 }

 

 
+

+    download_media(name, fileId=None, viewId=None, x__xgafv=None)
+  
Downloads a file from the session.
+
+Args:
+  name: string, Required. The resource name of the Session. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}` (required)
+  fileId: string, Required. The ID of the file to be downloaded.
+  viewId: string, Optional. The ID of the view to be downloaded.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  The media object as a string.
+
+    

+

+
 
\ No newline at end of file
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.html b/docs/dyn/discoveryengine_v1alpha.projects.html
index 7fc5271a8ac..927de72a02a 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.html
@@ -144,6 +144,9 @@ 
Method Details

 { # Request for ProjectService.ProvisionProject method.
   "acceptDataUseTerms": True or False, # Required. Set to `true` to specify that caller has read and would like to give consent to the [Terms for data use](https://cloud.google.com/retail/data-use-terms).
   "dataUseTermsVersion": "A String", # Required. The version of the [Terms for data use](https://cloud.google.com/retail/data-use-terms) that caller has read and would like to give consent to. Acceptable version is `2022-11-23`, and this may change over time.
+  "saasParams": { # Parameters for Agentspace. # Optional. Parameters for Agentspace.
+    "acceptBizQos": True or False, # Optional. Set to `true` to specify that caller has read and would like to give consent to the [Terms for Agent Space quality of service].
+  },
 }
 
   x__xgafv: string, V1 error format.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.cmekConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.cmekConfigs.html
index bcf10913aa8..a7979dd52f0 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.cmekConfigs.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.cmekConfigs.html
@@ -146,8 +146,8 @@ 
Method Details

 
     { # Configurations used to enable CMEK data encryption with Cloud KMS keys.
   "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-  "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-  "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+  "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+  "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
   "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
   "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
   "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -178,8 +178,8 @@ 
Method Details

   "cmekConfigs": [ # All the customer's CmekConfigs.
     { # Configurations used to enable CMEK data encryption with Cloud KMS keys.
       "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-      "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-      "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+      "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+      "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
       "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
       "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
       "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -205,8 +205,8 @@ 
Method Details

 
 { # Configurations used to enable CMEK data encryption with Cloud KMS keys.
   "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-  "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-  "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+  "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+  "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
   "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
   "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
   "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.html
index 09fe04a6935..f5395f7614e 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.html
@@ -247,8 +247,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -492,8 +492,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -774,8 +774,8 @@ 
Method Details

       },
       "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
         "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-        "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-        "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+        "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+        "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
         "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
         "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
         "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -963,8 +963,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -1134,8 +1134,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
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 7824e21a326..212206951fa 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.sessions.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.dataStores.sessions.html
@@ -683,7 +683,7 @@ 
Method Details

 
 Args:
   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, starred. Examples: "user_pseudo_id = some_id" "starred = true"
+  filter: string, A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: "user_pseudo_id = some_id" "display_name = \"some_name\"" "starred = true" "is_pinned=true AND (NOT labels:hidden)" "create_time > \"1970-01-01T12:00:00Z\""
   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` * `is_pinned` Example: * "update_time desc" * "create_time" * "is_pinned desc,update_time desc": list sessions by is_pinned first, then by update_time.
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, A page token, received from a previous `ListSessions` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.html
index b60d49b9b33..cdd5fa942dc 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.assistants.html
@@ -77,6 +77,12 @@ 
Instance Methods

 

   close()

 
Close httplib2 connections.

+

+  get(name, x__xgafv=None)

+
Gets an Assistant.

+

+  patch(name, body=None, updateMask=None, x__xgafv=None)

+
Updates an Assistant

 

   streamAssist(name, body=None, x__xgafv=None)

 
Assists the user with a query in a streaming fashion.

@@ -86,6 +92,52 @@ 
Method Details

   
Close httplib2 connections.

 

 
+

+    get(name, x__xgafv=None)
+  
Gets an Assistant.
+
+Args:
+  name: string, Required. Resource name of Assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Discovery Engine Assistant resource.
+  "name": "A String", # Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.
+}

+

+
+

+    patch(name, body=None, updateMask=None, x__xgafv=None)
+  
Updates an Assistant
+
+Args:
+  name: string, Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Discovery Engine Assistant resource.
+  "name": "A String", # Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.
+}
+
+  updateMask: string, The list of fields to update.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Discovery Engine Assistant resource.
+  "name": "A String", # Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.
+}

+

+
 

     streamAssist(name, body=None, x__xgafv=None)
   
Assists the user with a query in a streaming fashion.
@@ -107,7 +159,6 @@ 
Method Details

   "toolsSpec": { # Specification of tools that are used to serve the request. # Optional. Specification of tools that are used to serve the request.
     "imageGenerationSpec": { # Specification of the image generation tool. # Optional. Specification of the image generation tool.
     },
-    "toolRegistry": "A String", # Optional. The name of the tool registry to use. Format: `projects/{project}/locations/{location}/toolRegistries/{tool_registry}`
     "vertexAiSearchSpec": { # Specification of the Vertex AI Search tool. # Optional. Specification of the Vertex AI Search tool.
       "dataStoreSpecs": [ # Optional. Specs defining DataStores to filter on in a search call and configurations for those data stores. This is only considered for Engines with multiple data stores.
         { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
@@ -135,13 +186,11 @@ 
Method Details

           "filter": "A String", # Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
         },
       ],
-      "disabled": True or False, # Optional. Deprecated. Please refrain from using this field. Whether the Vertex AI Search tool is disabled. Default value is false, the tool is enabled by default.
       "filter": "A String", # Optional. The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. Filter expression is case-sensitive. If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. Filtering in Vertex AI Search is done by mapping the LHS filter key to a key property defined in the Vertex AI Search backend -- this mapping is defined by the customer in their schema. For example a media customer might have a field 'name' in their schema. In this case the filter would look like this: filter --> name:'ANY("king kong")' For more information about filtering including syntax and filter operators, see [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
     },
     "videoGenerationSpec": { # Specification of the video generation tool. # Optional. Specification of the video generation tool.
     },
     "webGroundingSpec": { # Specification of the web grounding tool. # Optional. Specification of the web grounding tool. If field is present, enables grounding with web search. Works only if Assistant.web_grounding_type is WEB_GROUNDING_TYPE_GOOGLE_SEARCH or WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH.
-      "enabled": True or False, # Optional. Deprecated. Please refrain from using this field. Whether the web grounding tool is enabled.
     },
   },
   "userMetadata": { # User metadata of the request. # Optional. Information about the user initiating the query.
@@ -163,6 +212,7 @@ 
Method Details

     "assistSkippedReasons": [ # Reasons for not answering the assist call.
       "A String",
     ],
+    "name": "A String", # Immutable. Identifier. Resource name of the `AssistAnswer`. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/assistAnswers/{assist_answer}` This field must be a UTF-8 encoded string with a length limit of 1024 characters.
     "replies": [ # Replies of the assistant.
       { # One part of the multi-part response of the assist call.
         "groundedContent": { # A piece of content and possibly its grounding information. Not all content needs grounding. Phrases like "Of course, I will gladly search it for you." do not need grounding. # Possibly grounded response text or media from the assistant.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.files.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.files.html
new file mode 100644
index 00000000000..fab62032621
--- /dev/null
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.files.html
@@ -0,0 +1,179 @@
+
+
+
+
Discovery Engine API . projects . locations . collections . engines . sessions . files

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

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

+
Lists metadata for all files in the current session.

+

+  list_next()

+
Retrieves the next page of results.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)
+  
Lists metadata for all files in the current session.
+
+Args:
+  parent: string, Required. The resource name of the Session. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}` Name of the session resource to which the file belong. (required)
+  filter: string, Optional. The filter syntax consists of an expression language for constructing a predicate from one or more fields of the files being filtered. Filter expression is case-sensitive. Currently supported field names are: * upload_time * last_add_time * last_use_time * file_name * mime_type Some examples of filters would be: * "file_name = 'file_1'" * "file_name = 'file_1' AND mime_type = 'text/plain'" * "last_use_time > '2025-06-14T12:00:00Z'" For a full description of the filter format, please see https://google.aip.dev/160.
+  pageSize: integer, Optional. The maximum number of files to return. The service may return fewer than this value. If unspecified, at most 100 files will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. If user specifies a value less than or equal to 0 - the request will be rejected with an INVALID_ARGUMENT error.
+  pageToken: string, Optional. A page token received from a previous `ListFiles` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListFiles` must match the call that provided the page token (except `page_size`, which may differ).
+  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 SessionService.ListFiles method.
+  "files": [ # The FileMetadatas.
+    { # Represents a file attached to a session (context file)
+      "byteSize": "A String", # Output only. The size of the context file in bytes.
+      "downloadUri": "A String", # Output only. The AssistantService.DownloadSessionFile URL to download the file. This URL will need the same credentials as AssistantService.ListSessionFileMetadata method and will provide the resource.
+      "fileId": "A String", # Output only. The ID of the file.
+      "fileOriginType": "A String", # Optional. The origin of the file.
+      "lastAddTime": "A String", # Output only. The time the file was added to the session. Note that if a file was added, then modified externally, then added again, the add time will be updated.
+      "metadata": { # Optional. Represents metadata related to the file that can suit particular use cases. The prefix "google." is reserved for the key for use by Google, but other prefixes can be freely used.
+        "a_key": "A String",
+      },
+      "mimeType": "A String", # The content type of the file, see https://www.iana.org/assignments/media-types/media-types.xhtml.
+      "name": "A String", # Output only. The name of the file uploaded.
+      "originalSourceType": "A String", # Optional. The type of the original source of the file.
+      "originalUri": "A String", # Optional. The original location of the file. It may be a local file path, or any other URI that allows accessing the file in an external system. There are two scenarios in which this url may be empty: 1. If the file was sent as inline data (e.g. pasted from the clipboard). 2. If the original location is not available. Note that there's no guarantee that the URI will be pointing to a valid or actually existing file. For example, a file might have been uploaded to the session, and then deleted from the original source.
+      "uploadTime": "A String", # Output only. The time the file was uploaded (If this is a file generated by an internal process and then made available to the session, this indicates the moment it happened).
+      "views": { # Output only. Alternate views of this file object. Each file view is attached to a specific role. Possible example keys: - "thumbnail" - "mobile_thumbnail" - "clip" - "summary" - "translation"
+        "a_key": { # Represents a specific alternate version or "view" of a file object, such as a summary, a thumbnail, a translated version, etc.
+          "byteSize": "A String", # Output only. The size of the view in bytes.
+          "createTime": "A String", # Output only. The time the view was created.
+          "fileCharacteristics": { # Caracteristics of other file types. # Output only. Characteristics of other file types.
+            "characteristics": { # Output only. Generic map of characteristics.
+              "a_key": "A String",
+            },
+          },
+          "imageCharacteristics": { # Standard characteristics of an image media view. # Output only. Characteristics of an image media view.
+            "bitDepth": 42, # Output only. Bit depth of the image (e.g., 8-bit, 16-bit).
+            "colorSpace": "A String", # Output only. Color space of the image (e.g., "RGB", "CMYK", "Grayscale").
+            "height": 42, # Output only. Image height in pixels.
+            "width": 42, # Output only. Image width in pixels.
+          },
+          "mimeType": "A String", # Output only. MIME type (e.g., "image/jpeg", "image/png", "text/plain", "video/mp4")
+          "uri": "A String", # Output only. The URI to access this media view.
+          "videoCharacteristics": { # Standard characteristics of a video media view. # Output only. Characteristics of a video media view.
+            "audioBitrateKbps": 42, # Output only. Bitrate of the audio in kbps.
+            "audioCodecs": [ # Output only. Audio codecs used in the video.
+              "A String",
+            ],
+            "duration": "A String", # Output only. Video duration.
+            "frameRate": 3.14, # Output only. Frame rate (frames per second).
+            "height": 42, # Output only. Video height in pixels.
+            "videoBitrateKbps": 42, # Output only. Bitrate of the video in kbps.
+            "videoCodecs": [ # Output only. Video codecs used in the video.
+              "A String",
+            ],
+            "width": 42, # Output only. Video width in pixels.
+          },
+          "viewId": "A String", # Output only. Globally Unique id for this specific view.
+        },
+      },
+    },
+  ],
+  "nextPageToken": "A String", # A token to retrieve next page of results. Pass this value in the ListFilesRequest.page_token field in the subsequent call to `ListFiles` method to retrieve the next page of results.
+}

+

+
+

+    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.
+        

+

+
+
\ No newline at end of file
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 a884d4102f1..87a15052833 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.collections.engines.sessions.html
@@ -79,6 +79,11 @@ 
Instance Methods

 

 
Returns the answers Resource.

 
+

+  files()
+

+
Returns the files Resource.

+
 

   close()

 
Close httplib2 connections.

@@ -683,7 +688,7 @@ 
Method Details

 
 Args:
   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, starred. Examples: "user_pseudo_id = some_id" "starred = true"
+  filter: string, A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: "user_pseudo_id = some_id" "display_name = \"some_name\"" "starred = true" "is_pinned=true AND (NOT labels:hidden)" "create_time > \"1970-01-01T12:00:00Z\""
   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` * `is_pinned` Example: * "update_time desc" * "create_time" * "is_pinned desc,update_time desc": list sessions by is_pinned first, then by update_time.
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, A page token, received from a previous `ListSessions` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.html
index d52cff804f2..4c182946e85 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.html
@@ -239,8 +239,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -484,8 +484,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -766,8 +766,8 @@ 
Method Details

       },
       "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
         "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-        "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-        "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+        "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+        "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
         "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
         "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
         "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -955,8 +955,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -1126,8 +1126,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.sessions.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.sessions.html
index d8d1a430e70..f354a009d1f 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.sessions.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.dataStores.sessions.html
@@ -683,7 +683,7 @@ 
Method Details

 
 Args:
   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, starred. Examples: "user_pseudo_id = some_id" "starred = true"
+  filter: string, A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: "user_pseudo_id = some_id" "display_name = \"some_name\"" "starred = true" "is_pinned=true AND (NOT labels:hidden)" "create_time > \"1970-01-01T12:00:00Z\""
   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` * `is_pinned` Example: * "update_time desc" * "create_time" * "is_pinned desc,update_time desc": list sessions by is_pinned first, then by update_time.
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, A page token, received from a previous `ListSessions` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.html
index 25e4bcb09de..121feb09fc4 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.html
@@ -291,8 +291,8 @@ 
Method Details

 
     { # Configurations used to enable CMEK data encryption with Cloud KMS keys.
   "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-  "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-  "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+  "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+  "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
   "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
   "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
   "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -1201,8 +1201,8 @@ 
Method Details

 
 { # Configurations used to enable CMEK data encryption with Cloud KMS keys.
   "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-  "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-  "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+  "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+  "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
   "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
   "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
   "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.identityMappingStores.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.identityMappingStores.html
index 54929e5b7fd..e06104b85f5 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.identityMappingStores.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.identityMappingStores.html
@@ -127,8 +127,8 @@ 
Method Details

 { # Identity Mapping Store which contains Identity Mapping Entries.
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the Identity Mapping Store.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -163,8 +163,8 @@ 
Method Details

     { # Identity Mapping Store which contains Identity Mapping Entries.
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the Identity Mapping Store.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -238,8 +238,8 @@ 
Method Details

     { # Identity Mapping Store which contains Identity Mapping Entries.
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the Identity Mapping Store.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -332,8 +332,8 @@ 
Method Details

     { # Identity Mapping Store which contains Identity Mapping Entries.
       "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the Identity Mapping Store.
         "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-        "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-        "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+        "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+        "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
         "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
         "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
         "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.notebooks.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.notebooks.html
index e0413061dfe..f93d4af23d1 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.notebooks.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.notebooks.html
@@ -82,10 +82,65 @@ 
Instance Methods

 

   close()

 
Close httplib2 connections.

+

+  listRecentlyViewed(parent, pageSize=None, pageToken=None, x__xgafv=None)

+
Lists the recently viewed notebooks. Needs a side channel with the user's EUC.

+

+  listRecentlyViewed_next()

+
Retrieves the next page of results.

 
Method Details

 

     close()
   
Close httplib2 connections.

 

 
+

+    listRecentlyViewed(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
Lists the recently viewed notebooks. Needs a side channel with the user's EUC.
+
+Args:
+  parent: string, Required. The parent branch resource name, such as `projects/{project}/locations/{location}`. (required)
+  pageSize: integer, Optional. Maximum number of Notebooks to return. If unspecified, defaults to "200". The maximum allowed value is "500". If this field is negative, will use the default value.
+  pageToken: string, Optional. The page token, provide this to retrieve the subsequent page.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response for NotebookService.ListRecentlyViewedNotebooks method.
+  "nextPageToken": "A String", # The page token, provide this to retrieve the subsequent page.
+  "notebooks": [ # The list of recently viewed notebooks.
+    { # Notebook is a resource where users can store their content (as sources) and interacts with the content.
+      "emoji": "A String", # Output only. The emoji of the notebook.
+      "metadata": { # Metadata for a notebook. # The metadata of the notebook.
+        "createTime": "A String", # The time at which this project was created.
+        "isShareable": True or False, # True if the project is shareable.
+        "isShared": True or False, # True if this project is currently shared with other people, false otherwise.
+        "lastViewed": "A String", # A timestamp indicating the time that the current in session user has last viewed the project.
+      },
+      "name": "A String", # Identifier. The identifier of the notebook. Format: `projects/{project}/locations/{location}/notebooks/{notebook_id}`. This field must be a UTF-8 encoded string.
+      "notebookId": "A String", # Optional. Notebook id, which is the last segment of the notebook's resource name. This is to make it similar with notebooklm API.
+      "title": "A String", # Optional. The title of the notebook.
+    },
+  ],
+}

+

+
+

+    listRecentlyViewed_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.
+        

+

+
 
\ No newline at end of file
diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.notebooks.sources.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.notebooks.sources.html
index 3ea2ef193eb..9debc89ba01 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.notebooks.sources.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.notebooks.sources.html
@@ -74,6 +74,9 @@
 
 
Discovery Engine API . projects . locations . notebooks . sources

 
Instance Methods

+

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

+
Creates a list of Sources.

 

   close()

 
Close httplib2 connections.

@@ -81,6 +84,57 @@ 
Instance Methods

   uploadFile(parent, sourceId, body=None, x__xgafv=None)

 
Uploads a file for Notebook LM to use. Creates a Source.

 
Method Details

+

+    batchCreate(parent, body=None, x__xgafv=None)
+  
Creates a list of Sources.
+
+Args:
+  parent: string, Required. The parent resource where the sources will be created. Format: projects/{project}/locations/{location}/notebooks/{notebook} (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request for SourceService.BatchCreateSources method.
+  "userContents": [ # Required. The UserContents to be uploaded.
+    { # The "Content" messages refer to data the user wants to upload.
+      "agentspaceContent": { # Agentspace content uploaded as source. # Agentspace content uploaded as source.
+        "documentName": "A String", # Optional. The full document name in Agentspace.
+        "engineName": "A String", # Optional. Engine to verify the permission of the document.
+        "ideaforgeIdeaName": "A String", # Optional. The full idea name for IdeaForge.
+      },
+    },
+  ],
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Response for SourceService.BatchCreateSources method.
+  "sources": [ # The Sources.
+    { # Source represents a single source of content.
+      "metadata": { # Represents the metadata of a source and some additional information. # Metadata about the source.
+        "agentspaceMetadata": { # Metadata about an agentspace source. # Metadata for an agentspace source.
+          "documentName": "A String", # Output only. The full document name in Agentspace.
+          "documentTitle": "A String", # Output only. The title of the document.
+        },
+        "sourceAddedTimestamp": "A String", # The timestamp the source was added.
+        "tokenCount": 42, # The number of tokens in the source.
+        "wordCount": 42, # The word count of the source.
+      },
+      "name": "A String", # Identifier. The full resource name of the source. Format: `projects/{project}/locations/{location}/notebooks/{notebook}/sources/{source_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.
+      "sourceId": { # SourceId is the last segment of the source's resource name. # Optional. Source id, which is the last segment of the source's resource name. This is to make it similar with notebooklm API.
+        "id": "A String", # The id of the source.
+      },
+      "title": "A String", # Optional. Title of the source.
+    },
+  ],
+}

+

+
 

     close()
   
Close httplib2 connections.

diff --git a/docs/dyn/discoveryengine_v1alpha.projects.locations.rankingConfigs.html b/docs/dyn/discoveryengine_v1alpha.projects.locations.rankingConfigs.html
index 227eb69ebd6..a148640696d 100644
--- a/docs/dyn/discoveryengine_v1alpha.projects.locations.rankingConfigs.html
+++ b/docs/dyn/discoveryengine_v1alpha.projects.locations.rankingConfigs.html
@@ -99,7 +99,7 @@ 
Method Details

   "ignoreRecordDetailsInResponse": True or False, # If true, the response will contain only record ID and score. By default, it is false, the response will contain record details.
   "model": "A String", # The identifier of the model to use. It is one of: * `semantic-ranker-512@latest`: Semantic ranking model with maximum input token size 512. It is set to `semantic-ranker-512@latest` by default if unspecified.
   "query": "A String", # The query to use.
-  "records": [ # Required. A list of records to rank. At most 200 records to rank.
+  "records": [ # Required. A list of records to rank.
     { # Record message for RankService.Rank method.
       "content": "A String", # The content of the record. Empty by default. At least one of title or content should be set otherwise an INVALID_ARGUMENT error is thrown.
       "id": "A String", # The unique ID to represent the record.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.html b/docs/dyn/discoveryengine_v1beta.projects.html
index 4e54db345ab..88084cbaa9e 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.html
@@ -108,6 +108,9 @@ 
Method Details

 { # Request for ProjectService.ProvisionProject method.
   "acceptDataUseTerms": True or False, # Required. Set to `true` to specify that caller has read and would like to give consent to the [Terms for data use](https://cloud.google.com/retail/data-use-terms).
   "dataUseTermsVersion": "A String", # Required. The version of the [Terms for data use](https://cloud.google.com/retail/data-use-terms) that caller has read and would like to give consent to. Acceptable version is `2022-11-23`, and this may change over time.
+  "saasParams": { # Parameters for Agentspace. # Optional. Parameters for Agentspace.
+    "acceptBizQos": True or False, # Optional. Set to `true` to specify that caller has read and would like to give consent to the [Terms for Agent Space quality of service].
+  },
 }
 
   x__xgafv: string, V1 error format.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.cmekConfigs.html b/docs/dyn/discoveryengine_v1beta.projects.locations.cmekConfigs.html
index 0d9015a79d6..f5b4896eab5 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.cmekConfigs.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.cmekConfigs.html
@@ -146,8 +146,8 @@ 
Method Details

 
     { # Configurations used to enable CMEK data encryption with Cloud KMS keys.
   "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-  "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-  "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+  "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+  "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
   "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
   "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
   "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -178,8 +178,8 @@ 
Method Details

   "cmekConfigs": [ # All the customer's CmekConfigs.
     { # Configurations used to enable CMEK data encryption with Cloud KMS keys.
       "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-      "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-      "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+      "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+      "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
       "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
       "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
       "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -205,8 +205,8 @@ 
Method Details

 
 { # Configurations used to enable CMEK data encryption with Cloud KMS keys.
   "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-  "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-  "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+  "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+  "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
   "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
   "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
   "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.html
index 462aed319af..9f1c44b9ce4 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.html
@@ -236,8 +236,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -455,8 +455,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -630,8 +630,8 @@ 
Method Details

       },
       "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
         "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-        "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-        "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+        "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+        "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
         "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
         "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
         "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -793,8 +793,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -938,8 +938,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
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 773d4db745f..2f35fbe16e8 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.sessions.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.dataStores.sessions.html
@@ -683,7 +683,7 @@ 
Method Details

 
 Args:
   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, starred. Examples: "user_pseudo_id = some_id" "starred = true"
+  filter: string, A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: "user_pseudo_id = some_id" "display_name = \"some_name\"" "starred = true" "is_pinned=true AND (NOT labels:hidden)" "create_time > \"1970-01-01T12:00:00Z\""
   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` * `is_pinned` Example: * "update_time desc" * "create_time" * "is_pinned desc,update_time desc": list sessions by is_pinned first, then by update_time.
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, A page token, received from a previous `ListSessions` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.assistants.html b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.assistants.html
index cfe9c7c2bd8..ed992c9dfd1 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.assistants.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.assistants.html
@@ -77,6 +77,12 @@ 
Instance Methods

 

   close()

 
Close httplib2 connections.

+

+  get(name, x__xgafv=None)

+
Gets an Assistant.

+

+  patch(name, body=None, updateMask=None, x__xgafv=None)

+
Updates an Assistant

 

   streamAssist(name, body=None, x__xgafv=None)

 
Assists the user with a query in a streaming fashion.

@@ -86,6 +92,52 @@ 
Method Details

   
Close httplib2 connections.

 

 
+

+    get(name, x__xgafv=None)
+  
Gets an Assistant.
+
+Args:
+  name: string, Required. Resource name of Assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Discovery Engine Assistant resource.
+  "name": "A String", # Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.
+}

+

+
+

+    patch(name, body=None, updateMask=None, x__xgafv=None)
+  
Updates an Assistant
+
+Args:
+  name: string, Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Discovery Engine Assistant resource.
+  "name": "A String", # Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.
+}
+
+  updateMask: string, The list of fields to update.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Discovery Engine Assistant resource.
+  "name": "A String", # Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.
+}

+

+
 

     streamAssist(name, body=None, x__xgafv=None)
   
Assists the user with a query in a streaming fashion.
@@ -107,7 +159,6 @@ 
Method Details

   "toolsSpec": { # Specification of tools that are used to serve the request. # Optional. Specification of tools that are used to serve the request.
     "imageGenerationSpec": { # Specification of the image generation tool. # Optional. Specification of the image generation tool.
     },
-    "toolRegistry": "A String", # Optional. The name of the tool registry to use. Format: `projects/{project}/locations/{location}/toolRegistries/{tool_registry}`
     "vertexAiSearchSpec": { # Specification of the Vertex AI Search tool. # Optional. Specification of the Vertex AI Search tool.
       "dataStoreSpecs": [ # Optional. Specs defining DataStores to filter on in a search call and configurations for those data stores. This is only considered for Engines with multiple data stores.
         { # A struct to define data stores to filter on in a search call and configurations for those data stores. Otherwise, an `INVALID_ARGUMENT` error is returned.
@@ -135,13 +186,11 @@ 
Method Details

           "filter": "A String", # Optional. Filter specification to filter documents in the data store specified by data_store field. For more information on filtering, see [Filtering](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
         },
       ],
-      "disabled": True or False, # Optional. Deprecated. Please refrain from using this field. Whether the Vertex AI Search tool is disabled. Default value is false, the tool is enabled by default.
       "filter": "A String", # Optional. The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. Filter expression is case-sensitive. If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. Filtering in Vertex AI Search is done by mapping the LHS filter key to a key property defined in the Vertex AI Search backend -- this mapping is defined by the customer in their schema. For example a media customer might have a field 'name' in their schema. In this case the filter would look like this: filter --> name:'ANY("king kong")' For more information about filtering including syntax and filter operators, see [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)
     },
     "videoGenerationSpec": { # Specification of the video generation tool. # Optional. Specification of the video generation tool.
     },
     "webGroundingSpec": { # Specification of the web grounding tool. # Optional. Specification of the web grounding tool. If field is present, enables grounding with web search. Works only if Assistant.web_grounding_type is WEB_GROUNDING_TYPE_GOOGLE_SEARCH or WEB_GROUNDING_TYPE_ENTERPRISE_WEB_SEARCH.
-      "enabled": True or False, # Optional. Deprecated. Please refrain from using this field. Whether the web grounding tool is enabled.
     },
   },
   "userMetadata": { # User metadata of the request. # Optional. Information about the user initiating the query.
@@ -163,6 +212,7 @@ 
Method Details

     "assistSkippedReasons": [ # Reasons for not answering the assist call.
       "A String",
     ],
+    "name": "A String", # Immutable. Identifier. Resource name of the `AssistAnswer`. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/assistAnswers/{assist_answer}` This field must be a UTF-8 encoded string with a length limit of 1024 characters.
     "replies": [ # Replies of the assistant.
       { # One part of the multi-part response of the assist call.
         "groundedContent": { # A piece of content and possibly its grounding information. Not all content needs grounding. Phrases like "Of course, I will gladly search it for you." do not need grounding. # Possibly grounded response text or media from the assistant.
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 ce6b12f8bd7..2b706779b50 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.sessions.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.collections.engines.sessions.html
@@ -683,7 +683,7 @@ 
Method Details

 
 Args:
   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, starred. Examples: "user_pseudo_id = some_id" "starred = true"
+  filter: string, A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: "user_pseudo_id = some_id" "display_name = \"some_name\"" "starred = true" "is_pinned=true AND (NOT labels:hidden)" "create_time > \"1970-01-01T12:00:00Z\""
   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` * `is_pinned` Example: * "update_time desc" * "create_time" * "is_pinned desc,update_time desc": list sessions by is_pinned first, then by update_time.
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, A page token, received from a previous `ListSessions` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.html
index ec560cc504c..cd218150cff 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.html
@@ -228,8 +228,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -447,8 +447,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -622,8 +622,8 @@ 
Method Details

       },
       "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
         "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-        "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-        "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+        "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+        "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
         "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
         "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
         "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -785,8 +785,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -930,8 +930,8 @@ 
Method Details

   },
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the DataStore.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.sessions.html b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.sessions.html
index 59de50c5057..eb36c7f770d 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.sessions.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.dataStores.sessions.html
@@ -683,7 +683,7 @@ 
Method Details

 
 Args:
   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, starred. Examples: "user_pseudo_id = some_id" "starred = true"
+  filter: string, A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: "user_pseudo_id = some_id" "display_name = \"some_name\"" "starred = true" "is_pinned=true AND (NOT labels:hidden)" "create_time > \"1970-01-01T12:00:00Z\""
   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` * `is_pinned` Example: * "update_time desc" * "create_time" * "is_pinned desc,update_time desc": list sessions by is_pinned first, then by update_time.
   pageSize: integer, Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
   pageToken: string, A page token, received from a previous `ListSessions` call. Provide this to retrieve the subsequent page.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.html b/docs/dyn/discoveryengine_v1beta.projects.locations.html
index e69ecd8bfb2..beccf39acdc 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.html
@@ -174,8 +174,8 @@ 
Method Details

 
     { # Configurations used to enable CMEK data encryption with Cloud KMS keys.
   "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-  "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-  "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+  "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+  "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
   "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
   "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
   "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -817,8 +817,8 @@ 
Method Details

 
 { # Configurations used to enable CMEK data encryption with Cloud KMS keys.
   "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-  "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-  "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+  "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+  "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
   "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
   "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
   "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.identityMappingStores.html b/docs/dyn/discoveryengine_v1beta.projects.locations.identityMappingStores.html
index 1193dbbe6f2..a43832ced41 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.identityMappingStores.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.identityMappingStores.html
@@ -127,8 +127,8 @@ 
Method Details

 { # Identity Mapping Store which contains Identity Mapping Entries.
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the Identity Mapping Store.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -157,8 +157,8 @@ 
Method Details

     { # Identity Mapping Store which contains Identity Mapping Entries.
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the Identity Mapping Store.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -226,8 +226,8 @@ 
Method Details

     { # Identity Mapping Store which contains Identity Mapping Entries.
   "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the Identity Mapping Store.
     "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-    "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-    "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+    "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+    "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
     "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
     "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
     "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
@@ -314,8 +314,8 @@ 
Method Details

     { # Identity Mapping Store which contains Identity Mapping Entries.
       "cmekConfig": { # Configurations used to enable CMEK data encryption with Cloud KMS keys. # Output only. CMEK-related information for the Identity Mapping Store.
         "isDefault": True or False, # Output only. The default CmekConfig for the Customer.
-        "kmsKey": "A String", # KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
-        "kmsKeyVersion": "A String", # KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
+        "kmsKey": "A String", # Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.
+        "kmsKeyVersion": "A String", # Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.
         "lastRotationTimestampMicros": "A String", # Output only. The timestamp of the last key rotation.
         "name": "A String", # Required. The name of the CmekConfig of the form `projects/{project}/locations/{location}/cmekConfig` or `projects/{project}/locations/{location}/cmekConfigs/{cmek_config}`.
         "notebooklmState": "A String", # Output only. Whether the NotebookLM Corpus is ready to be used.
diff --git a/docs/dyn/discoveryengine_v1beta.projects.locations.rankingConfigs.html b/docs/dyn/discoveryengine_v1beta.projects.locations.rankingConfigs.html
index ec79919e8c0..78954bc7341 100644
--- a/docs/dyn/discoveryengine_v1beta.projects.locations.rankingConfigs.html
+++ b/docs/dyn/discoveryengine_v1beta.projects.locations.rankingConfigs.html
@@ -99,7 +99,7 @@ 
Method Details

   "ignoreRecordDetailsInResponse": True or False, # If true, the response will contain only record ID and score. By default, it is false, the response will contain record details.
   "model": "A String", # The identifier of the model to use. It is one of: * `semantic-ranker-512@latest`: Semantic ranking model with maximum input token size 512. It is set to `semantic-ranker-512@latest` by default if unspecified.
   "query": "A String", # The query to use.
-  "records": [ # Required. A list of records to rank. At most 200 records to rank.
+  "records": [ # Required. A list of records to rank.
     { # Record message for RankService.Rank method.
       "content": "A String", # The content of the record. Empty by default. At least one of title or content should be set otherwise an INVALID_ARGUMENT error is thrown.
       "id": "A String", # The unique ID to represent the record.
diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1.json
index 36cd0fdfb3a..a82b82bd8e6 100644
--- a/googleapiclient/discovery_cache/documents/discoveryengine.v1.json
+++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1.json
@@ -2175,7 +2175,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state, starred. Examples: \"user_pseudo_id = some_id\" \"starred = true\"",
+"description": "A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: \"user_pseudo_id = some_id\" \"display_name = \\\"some_name\\\"\" \"starred = true\" \"is_pinned=true AND (NOT labels:hidden)\" \"create_time > \\\"1970-01-01T12:00:00Z\\\"\"",
 "location": "query",
 "type": "string"
 },
@@ -3196,6 +3196,65 @@
 "resources": {
 "assistants": {
 "methods": {
+"get": {
+"description": "Gets an Assistant.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.engines.assistants.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. Resource name of Assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Assistant"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"patch": {
+"description": "Updates an Assistant",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}",
+"httpMethod": "PATCH",
+"id": "discoveryengine.projects.locations.collections.engines.assistants.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "The list of fields to update.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1Assistant"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1Assistant"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "streamAssist": {
 "description": "Assists the user with a query in a streaming fashion.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}:streamAssist",
@@ -3982,7 +4041,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state, starred. Examples: \"user_pseudo_id = some_id\" \"starred = true\"",
+"description": "A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: \"user_pseudo_id = some_id\" \"display_name = \\\"some_name\\\"\" \"starred = true\" \"is_pinned=true AND (NOT labels:hidden)\" \"create_time > \\\"1970-01-01T12:00:00Z\\\"\"",
 "location": "query",
 "type": "string"
 },
@@ -5788,7 +5847,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state, starred. Examples: \"user_pseudo_id = some_id\" \"starred = true\"",
+"description": "A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: \"user_pseudo_id = some_id\" \"display_name = \\\"some_name\\\"\" \"starred = true\" \"is_pinned=true AND (NOT labels:hidden)\" \"create_time > \\\"1970-01-01T12:00:00Z\\\"\"",
 "location": "query",
 "type": "string"
 },
@@ -7191,7 +7250,7 @@
 }
 }
 },
-"revision": "20250716",
+"revision": "20250724",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiDistribution": {
@@ -9184,6 +9243,10 @@
 },
 "type": "array"
 },
+"name": {
+"description": "Immutable. Identifier. Resource name of the `AssistAnswer`. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/assistAnswers/{assist_answer}` This field must be a UTF-8 encoded string with a length limit of 1024 characters.",
+"type": "string"
+},
 "replies": {
 "description": "Replies of the assistant.",
 "items": {
@@ -9238,6 +9301,17 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1Assistant": {
+"description": "Discovery Engine Assistant resource.",
+"id": "GoogleCloudDiscoveryengineV1Assistant",
+"properties": {
+"name": {
+"description": "Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1AssistantContent": {
 "description": "Multi-modal content.",
 "id": "GoogleCloudDiscoveryengineV1AssistantContent",
@@ -10180,11 +10254,12 @@
 "type": "boolean"
 },
 "kmsKey": {
-"description": "KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
+"description": "Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
 "type": "string"
 },
 "kmsKeyVersion": {
-"description": "KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"description": "Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"readOnly": true,
 "type": "string"
 },
 "lastRotationTimestampMicros": {
@@ -13089,6 +13164,21 @@
 "dataUseTermsVersion": {
 "description": "Required. The version of the [Terms for data use](https://cloud.google.com/retail/data-use-terms) that caller has read and would like to give consent to. Acceptable version is `2022-11-23`, and this may change over time.",
 "type": "string"
+},
+"saasParams": {
+"$ref": "GoogleCloudDiscoveryengineV1ProvisionProjectRequestSaasParams",
+"description": "Optional. Parameters for Agentspace."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1ProvisionProjectRequestSaasParams": {
+"description": "Parameters for Agentspace.",
+"id": "GoogleCloudDiscoveryengineV1ProvisionProjectRequestSaasParams",
+"properties": {
+"acceptBizQos": {
+"description": "Optional. Set to `true` to specify that caller has read and would like to give consent to the [Terms for Agent Space quality of service].",
+"type": "boolean"
 }
 },
 "type": "object"
@@ -13360,7 +13450,7 @@
 "type": "string"
 },
 "records": {
-"description": "Required. A list of records to rank. At most 200 records to rank.",
+"description": "Required. A list of records to rank.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1RankingRecord"
 },
@@ -15086,10 +15176,6 @@
 "$ref": "GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecImageGenerationSpec",
 "description": "Optional. Specification of the image generation tool."
 },
-"toolRegistry": {
-"description": "Optional. The name of the tool registry to use. Format: `projects/{project}/locations/{location}/toolRegistries/{tool_registry}`",
-"type": "string"
-},
 "vertexAiSearchSpec": {
 "$ref": "GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecVertexAiSearchSpec",
 "description": "Optional. Specification of the Vertex AI Search tool."
@@ -15122,11 +15208,6 @@
 },
 "type": "array"
 },
-"disabled": {
-"deprecated": true,
-"description": "Optional. Deprecated. Please refrain from using this field. Whether the Vertex AI Search tool is disabled. Default value is false, the tool is enabled by default.",
-"type": "boolean"
-},
 "filter": {
 "description": "Optional. The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. Filter expression is case-sensitive. If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. Filtering in Vertex AI Search is done by mapping the LHS filter key to a key property defined in the Vertex AI Search backend -- this mapping is defined by the customer in their schema. For example a media customer might have a field 'name' in their schema. In this case the filter would look like this: filter --> name:'ANY(\"king kong\")' For more information about filtering including syntax and filter operators, see [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)",
 "type": "string"
@@ -15143,13 +15224,7 @@
 "GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecWebGroundingSpec": {
 "description": "Specification of the web grounding tool.",
 "id": "GoogleCloudDiscoveryengineV1StreamAssistRequestToolsSpecWebGroundingSpec",
-"properties": {
-"enabled": {
-"deprecated": true,
-"description": "Optional. Deprecated. Please refrain from using this field. Whether the web grounding tool is enabled.",
-"type": "boolean"
-}
-},
+"properties": {},
 "type": "object"
 },
 "GoogleCloudDiscoveryengineV1StreamAssistResponse": {
@@ -16580,11 +16655,12 @@
 "type": "boolean"
 },
 "kmsKey": {
-"description": "KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
+"description": "Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
 "type": "string"
 },
 "kmsKeyVersion": {
-"description": "KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"description": "Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"readOnly": true,
 "type": "string"
 },
 "lastRotationTimestampMicros": {
@@ -19418,7 +19494,7 @@
 "id": "GoogleCloudDiscoveryengineV1alphaListSessionsRequest",
 "properties": {
 "filter": {
-"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state, starred. Examples: \"user_pseudo_id = some_id\" \"starred = true\"",
+"description": "A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: \"user_pseudo_id = some_id\" \"display_name = \\\"some_name\\\"\" \"starred = true\" \"is_pinned=true AND (NOT labels:hidden)\" \"create_time > \\\"1970-01-01T12:00:00Z\\\"\"",
 "type": "string"
 },
 "orderBy": {
@@ -21691,11 +21767,12 @@ false
 "type": "boolean"
 },
 "kmsKey": {
-"description": "KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
+"description": "Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
 "type": "string"
 },
 "kmsKeyVersion": {
-"description": "KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"description": "Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"readOnly": true,
 "type": "string"
 },
 "lastRotationTimestampMicros": {
diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json
index 932e9227191..9e1df91d1ab 100644
--- a/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json
+++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1alpha.json
@@ -137,45 +137,42 @@
 "resources": {
 "media": {
 "methods": {
-"upload": {
-"description": "Uploads a file for Notebook LM to use. Creates a Source.",
-"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/notebooks/{notebooksId}/sources:uploadFile",
-"httpMethod": "POST",
-"id": "discoveryengine.media.upload",
-"mediaUpload": {
-"accept": [
-"*/*"
-],
-"protocols": {
-"simple": {
-"multipart": true,
-"path": "/upload/v1alpha/{+parent}/sources:uploadFile"
-}
-}
-},
+"download": {
+"description": "Downloads a file from the session.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/sessions/{sessionsId}:downloadFile",
+"httpMethod": "GET",
+"id": "discoveryengine.media.download",
 "parameterOrder": [
-"parent"
+"name"
 ],
 "parameters": {
-"parent": {
-"description": "Required. The parent resource where the sources will be created. Format: projects/{project}/locations/{location}/notebooks/{notebook}",
+"fileId": {
+"description": "Required. The ID of the file to be downloaded.",
+"location": "query",
+"type": "string"
+},
+"name": {
+"description": "Required. The resource name of the Session. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}`",
 "location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/notebooks/[^/]+$",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/sessions/[^/]+$",
 "required": true,
 "type": "string"
-}
 },
-"path": "v1alpha/{+parent}/sources:uploadFile",
-"request": {
-"$ref": "GoogleCloudNotebooklmV1alphaUploadSourceFileRequest"
+"viewId": {
+"description": "Optional. The ID of the view to be downloaded.",
+"location": "query",
+"type": "string"
+}
 },
+"path": "v1alpha/{+name}:downloadFile",
 "response": {
-"$ref": "GoogleCloudNotebooklmV1alphaUploadSourceFileResponse"
+"$ref": "GdataMedia"
 },
 "scopes": [
 "https://www.googleapis.com/auth/cloud-platform"
 ],
-"supportsMediaUpload": true
+"supportsMediaDownload": true,
+"useMediaDownloadService": true
 }
 }
 },
@@ -3023,7 +3020,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state, starred. Examples: \"user_pseudo_id = some_id\" \"starred = true\"",
+"description": "A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: \"user_pseudo_id = some_id\" \"display_name = \\\"some_name\\\"\" \"starred = true\" \"is_pinned=true AND (NOT labels:hidden)\" \"create_time > \\\"1970-01-01T12:00:00Z\\\"\"",
 "location": "query",
 "type": "string"
 },
@@ -4220,6 +4217,65 @@
 "resources": {
 "assistants": {
 "methods": {
+"get": {
+"description": "Gets an Assistant.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.engines.assistants.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. Resource name of Assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaAssistant"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"patch": {
+"description": "Updates an Assistant",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}",
+"httpMethod": "PATCH",
+"id": "discoveryengine.projects.locations.collections.engines.assistants.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "The list of fields to update.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1alpha/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaAssistant"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaAssistant"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "streamAssist": {
 "description": "Assists the user with a query in a streaming fashion.",
 "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}:streamAssist",
@@ -5067,7 +5123,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state, starred. Examples: \"user_pseudo_id = some_id\" \"starred = true\"",
+"description": "A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: \"user_pseudo_id = some_id\" \"display_name = \\\"some_name\\\"\" \"starred = true\" \"is_pinned=true AND (NOT labels:hidden)\" \"create_time > \\\"1970-01-01T12:00:00Z\\\"\"",
 "location": "query",
 "type": "string"
 },
@@ -5167,6 +5223,51 @@
 ]
 }
 }
+},
+"files": {
+"methods": {
+"list": {
+"description": "Lists metadata for all files in the current session.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/sessions/{sessionsId}/files",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.engines.sessions.files.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"filter": {
+"description": "Optional. The filter syntax consists of an expression language for constructing a predicate from one or more fields of the files being filtered. Filter expression is case-sensitive. Currently supported field names are: * upload_time * last_add_time * last_use_time * file_name * mime_type Some examples of filters would be: * \"file_name = 'file_1'\" * \"file_name = 'file_1' AND mime_type = 'text/plain'\" * \"last_use_time > '2025-06-14T12:00:00Z'\" For a full description of the filter format, please see https://google.aip.dev/160.",
+"location": "query",
+"type": "string"
+},
+"pageSize": {
+"description": "Optional. The maximum number of files to return. The service may return fewer than this value. If unspecified, at most 100 files will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000. If user specifies a value less than or equal to 0 - the request will be rejected with an INVALID_ARGUMENT error.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A page token received from a previous `ListFiles` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListFiles` must match the call that provided the page token (except `page_size`, which may differ).",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The resource name of the Session. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}` Name of the session resource to which the file belong.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/sessions/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+parent}/files",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaListFilesResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
 }
 }
 },
@@ -7161,7 +7262,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state, starred. Examples: \"user_pseudo_id = some_id\" \"starred = true\"",
+"description": "A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: \"user_pseudo_id = some_id\" \"display_name = \\\"some_name\\\"\" \"starred = true\" \"is_pinned=true AND (NOT labels:hidden)\" \"create_time > \\\"1970-01-01T12:00:00Z\\\"\"",
 "location": "query",
 "type": "string"
 },
@@ -8341,9 +8442,75 @@
 }
 },
 "notebooks": {
+"methods": {
+"listRecentlyViewed": {
+"description": "Lists the recently viewed notebooks. Needs a side channel with the user's EUC.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/notebooks:listRecentlyViewed",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.notebooks.listRecentlyViewed",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. Maximum number of Notebooks to return. If unspecified, defaults to \"200\". The maximum allowed value is \"500\". If this field is negative, will use the default value.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. The page token, provide this to retrieve the subsequent page.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent branch resource name, such as `projects/{project}/locations/{location}`.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+parent}/notebooks:listRecentlyViewed",
+"response": {
+"$ref": "GoogleCloudNotebooklmV1alphaListRecentlyViewedNotebooksResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+},
 "resources": {
 "sources": {
 "methods": {
+"batchCreate": {
+"description": "Creates a list of Sources.",
+"flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/notebooks/{notebooksId}/sources:batchCreate",
+"httpMethod": "POST",
+"id": "discoveryengine.projects.locations.notebooks.sources.batchCreate",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The parent resource where the sources will be created. Format: projects/{project}/locations/{location}/notebooks/{notebook}",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/notebooks/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1alpha/{+parent}/sources:batchCreate",
+"request": {
+"$ref": "GoogleCloudNotebooklmV1alphaBatchCreateSourcesRequest"
+},
+"response": {
+"$ref": "GoogleCloudNotebooklmV1alphaBatchCreateSourcesResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "uploadFile": {
 "description": "Uploads a file for Notebook LM to use. Creates a Source.",
 "flatPath": "v1alpha/projects/{projectsId}/locations/{locationsId}/notebooks/{notebooksId}/sources/{sourceId}:uploadFile",
@@ -9253,7 +9420,7 @@
 }
 }
 },
-"revision": "20250716",
+"revision": "20250724",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "ApiservingMediaRequestInfo": {
@@ -10330,6 +10497,17 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1Assistant": {
+"description": "Discovery Engine Assistant resource.",
+"id": "GoogleCloudDiscoveryengineV1Assistant",
+"properties": {
+"name": {
+"description": "Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata": {
 "description": "Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.",
 "id": "GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata",
@@ -10419,11 +10597,12 @@
 "type": "boolean"
 },
 "kmsKey": {
-"description": "KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
+"description": "Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
 "type": "string"
 },
 "kmsKeyVersion": {
-"description": "KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"description": "Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"readOnly": true,
 "type": "string"
 },
 "lastRotationTimestampMicros": {
@@ -14667,6 +14846,10 @@
 },
 "type": "array"
 },
+"name": {
+"description": "Immutable. Identifier. Resource name of the `AssistAnswer`. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/assistAnswers/{assist_answer}` This field must be a UTF-8 encoded string with a length limit of 1024 characters.",
+"type": "string"
+},
 "replies": {
 "description": "Replies of the assistant.",
 "items": {
@@ -14721,6 +14904,17 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaAssistant": {
+"description": "Discovery Engine Assistant resource.",
+"id": "GoogleCloudDiscoveryengineV1alphaAssistant",
+"properties": {
+"name": {
+"description": "Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaAssistantContent": {
 "description": "Multi-modal content.",
 "id": "GoogleCloudDiscoveryengineV1alphaAssistantContent",
@@ -15766,11 +15960,12 @@
 "type": "boolean"
 },
 "kmsKey": {
-"description": "KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
+"description": "Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
 "type": "string"
 },
 "kmsKeyVersion": {
-"description": "KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"description": "Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"readOnly": true,
 "type": "string"
 },
 "lastRotationTimestampMicros": {
@@ -18906,6 +19101,169 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaFileCharacteristics": {
+"description": "Caracteristics of other file types.",
+"id": "GoogleCloudDiscoveryengineV1alphaFileCharacteristics",
+"properties": {
+"characteristics": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Output only. Generic map of characteristics.",
+"readOnly": true,
+"type": "object"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaFileMetadata": {
+"description": "Represents a file attached to a session (context file)",
+"id": "GoogleCloudDiscoveryengineV1alphaFileMetadata",
+"properties": {
+"byteSize": {
+"description": "Output only. The size of the context file in bytes.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+},
+"downloadUri": {
+"description": "Output only. The AssistantService.DownloadSessionFile URL to download the file. This URL will need the same credentials as AssistantService.ListSessionFileMetadata method and will provide the resource.",
+"readOnly": true,
+"type": "string"
+},
+"fileId": {
+"description": "Output only. The ID of the file.",
+"readOnly": true,
+"type": "string"
+},
+"fileOriginType": {
+"description": "Optional. The origin of the file.",
+"enum": [
+"FILE_ORIGIN_TYPE_UNSPECIFIED",
+"USER_PROVIDED",
+"AI_GENERATED",
+"INTERNALLY_GENERATED"
+],
+"enumDescriptions": [
+"Default value.",
+"The file was provided by the user.",
+"The file was generated by an AI model.",
+"The file was generated from other files by an internal process."
+],
+"type": "string"
+},
+"lastAddTime": {
+"description": "Output only. The time the file was added to the session. Note that if a file was added, then modified externally, then added again, the add time will be updated.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"metadata": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Optional. Represents metadata related to the file that can suit particular use cases. The prefix \"google.\" is reserved for the key for use by Google, but other prefixes can be freely used.",
+"type": "object"
+},
+"mimeType": {
+"description": "The content type of the file, see https://www.iana.org/assignments/media-types/media-types.xhtml.",
+"type": "string"
+},
+"name": {
+"description": "Output only. The name of the file uploaded.",
+"readOnly": true,
+"type": "string"
+},
+"originalSourceType": {
+"description": "Optional. The type of the original source of the file.",
+"enum": [
+"FILE_SOURCE_UNSPECIFIED",
+"FILE_SOURCE_INLINE",
+"FILE_SOURCE_LOCAL",
+"FILE_SOURCE_CLOUD_STORAGE",
+"FILE_SOURCE_CLOUD_DRIVE",
+"FILE_SOURCE_URL"
+],
+"enumDescriptions": [
+"Default value. Unknown source.",
+"The data of the file was provided inline (e.g. pasted from the clipboard).",
+"The file was uploaded from a local file.",
+"The file was uploaded from Cloud Storage.",
+"The file was uploaded from Drive.",
+"The file was retrieved from a URL (e.g. public web)."
+],
+"type": "string"
+},
+"originalUri": {
+"description": "Optional. The original location of the file. It may be a local file path, or any other URI that allows accessing the file in an external system. There are two scenarios in which this url may be empty: 1. If the file was sent as inline data (e.g. pasted from the clipboard). 2. If the original location is not available. Note that there's no guarantee that the URI will be pointing to a valid or actually existing file. For example, a file might have been uploaded to the session, and then deleted from the original source.",
+"type": "string"
+},
+"uploadTime": {
+"description": "Output only. The time the file was uploaded (If this is a file generated by an internal process and then made available to the session, this indicates the moment it happened).",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"views": {
+"additionalProperties": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaFileView"
+},
+"description": "Output only. Alternate views of this file object. Each file view is attached to a specific role. Possible example keys: - \"thumbnail\" - \"mobile_thumbnail\" - \"clip\" - \"summary\" - \"translation\"",
+"readOnly": true,
+"type": "object"
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaFileView": {
+"description": "Represents a specific alternate version or \"view\" of a file object, such as a summary, a thumbnail, a translated version, etc.",
+"id": "GoogleCloudDiscoveryengineV1alphaFileView",
+"properties": {
+"byteSize": {
+"description": "Output only. The size of the view in bytes.",
+"format": "int64",
+"readOnly": true,
+"type": "string"
+},
+"createTime": {
+"description": "Output only. The time the view was created.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"fileCharacteristics": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaFileCharacteristics",
+"description": "Output only. Characteristics of other file types.",
+"readOnly": true
+},
+"imageCharacteristics": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaImageCharacteristics",
+"description": "Output only. Characteristics of an image media view.",
+"readOnly": true
+},
+"mimeType": {
+"description": "Output only. MIME type (e.g., \"image/jpeg\", \"image/png\", \"text/plain\", \"video/mp4\")",
+"readOnly": true,
+"type": "string"
+},
+"uri": {
+"description": "Output only. The URI to access this media view.",
+"readOnly": true,
+"type": "string"
+},
+"videoCharacteristics": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaVideoCharacteristics",
+"description": "Output only. Characteristics of a video media view.",
+"readOnly": true
+},
+"viewId": {
+"description": "Output only. Globally Unique id for this specific view.",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaFirestoreSource": {
 "description": "Firestore source import data from.",
 "id": "GoogleCloudDiscoveryengineV1alphaFirestoreSource",
@@ -19182,6 +19540,52 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaImageCharacteristics": {
+"description": "Standard characteristics of an image media view.",
+"id": "GoogleCloudDiscoveryengineV1alphaImageCharacteristics",
+"properties": {
+"bitDepth": {
+"description": "Output only. Bit depth of the image (e.g., 8-bit, 16-bit).",
+"format": "int32",
+"readOnly": true,
+"type": "integer"
+},
+"colorSpace": {
+"description": "Output only. Color space of the image (e.g., \"RGB\", \"CMYK\", \"Grayscale\").",
+"enum": [
+"COLOR_SPACE_UNSPECIFIED",
+"RGB",
+"CMYK",
+"GRAYSCALE",
+"YUV",
+"OTHER_COLOR_SPACE"
+],
+"enumDescriptions": [
+"Default value. Unknown color space.",
+"Red, green, blue colorspace.",
+"Cyan, magenta, yellow, and black colorspace.",
+"Grayscale colorspace.",
+"YUV colorspace.",
+"Other colorspace."
+],
+"readOnly": true,
+"type": "string"
+},
+"height": {
+"description": "Output only. Image height in pixels.",
+"format": "int32",
+"readOnly": true,
+"type": "integer"
+},
+"width": {
+"description": "Output only. Image width in pixels.",
+"format": "int32",
+"readOnly": true,
+"type": "integer"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaImportCompletionSuggestionsMetadata": {
 "description": "Metadata related to the progress of the ImportCompletionSuggestions operation. This will be returned by the google.longrunning.Operation.metadata field.",
 "id": "GoogleCloudDiscoveryengineV1alphaImportCompletionSuggestionsMetadata",
@@ -19983,6 +20387,24 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaListFilesResponse": {
+"description": "Response message for SessionService.ListFiles method.",
+"id": "GoogleCloudDiscoveryengineV1alphaListFilesResponse",
+"properties": {
+"files": {
+"description": "The FileMetadatas.",
+"items": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaFileMetadata"
+},
+"type": "array"
+},
+"nextPageToken": {
+"description": "A token to retrieve next page of results. Pass this value in the ListFilesRequest.page_token field in the subsequent call to `ListFiles` method to retrieve the next page of results.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaListIdentityMappingStoresResponse": {
 "description": "Response message for IdentityMappingStoreService.ListIdentityMappingStores",
 "id": "GoogleCloudDiscoveryengineV1alphaListIdentityMappingStoresResponse",
@@ -20096,7 +20518,7 @@
 "id": "GoogleCloudDiscoveryengineV1alphaListSessionsRequest",
 "properties": {
 "filter": {
-"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state, starred. Examples: \"user_pseudo_id = some_id\" \"starred = true\"",
+"description": "A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: \"user_pseudo_id = some_id\" \"display_name = \\\"some_name\\\"\" \"starred = true\" \"is_pinned=true AND (NOT labels:hidden)\" \"create_time > \\\"1970-01-01T12:00:00Z\\\"\"",
 "type": "string"
 },
 "orderBy": {
@@ -20461,6 +20883,21 @@
 "dataUseTermsVersion": {
 "description": "Required. The version of the [Terms for data use](https://cloud.google.com/retail/data-use-terms) that caller has read and would like to give consent to. Acceptable version is `2022-11-23`, and this may change over time.",
 "type": "string"
+},
+"saasParams": {
+"$ref": "GoogleCloudDiscoveryengineV1alphaProvisionProjectRequestSaasParams",
+"description": "Optional. Parameters for Agentspace."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaProvisionProjectRequestSaasParams": {
+"description": "Parameters for Agentspace.",
+"id": "GoogleCloudDiscoveryengineV1alphaProvisionProjectRequestSaasParams",
+"properties": {
+"acceptBizQos": {
+"description": "Optional. Set to `true` to specify that caller has read and would like to give consent to the [Terms for Agent Space quality of service].",
+"type": "boolean"
 }
 },
 "type": "object"
@@ -20825,7 +21262,7 @@
 "type": "string"
 },
 "records": {
-"description": "Required. A list of records to rank. At most 200 records to rank.",
+"description": "Required. A list of records to rank.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaRankingRecord"
 },
@@ -23839,10 +24276,6 @@ false
 "$ref": "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecImageGenerationSpec",
 "description": "Optional. Specification of the image generation tool."
 },
-"toolRegistry": {
-"description": "Optional. The name of the tool registry to use. Format: `projects/{project}/locations/{location}/toolRegistries/{tool_registry}`",
-"type": "string"
-},
 "vertexAiSearchSpec": {
 "$ref": "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecVertexAiSearchSpec",
 "description": "Optional. Specification of the Vertex AI Search tool."
@@ -23875,11 +24308,6 @@ false
 },
 "type": "array"
 },
-"disabled": {
-"deprecated": true,
-"description": "Optional. Deprecated. Please refrain from using this field. Whether the Vertex AI Search tool is disabled. Default value is false, the tool is enabled by default.",
-"type": "boolean"
-},
 "filter": {
 "description": "Optional. The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. Filter expression is case-sensitive. If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. Filtering in Vertex AI Search is done by mapping the LHS filter key to a key property defined in the Vertex AI Search backend -- this mapping is defined by the customer in their schema. For example a media customer might have a field 'name' in their schema. In this case the filter would look like this: filter --> name:'ANY(\"king kong\")' For more information about filtering including syntax and filter operators, see [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)",
 "type": "string"
@@ -23896,13 +24324,7 @@ false
 "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecWebGroundingSpec": {
 "description": "Specification of the web grounding tool.",
 "id": "GoogleCloudDiscoveryengineV1alphaStreamAssistRequestToolsSpecWebGroundingSpec",
-"properties": {
-"enabled": {
-"deprecated": true,
-"description": "Optional. Deprecated. Please refrain from using this field. Whether the web grounding tool is enabled.",
-"type": "boolean"
-}
-},
+"properties": {},
 "type": "object"
 },
 "GoogleCloudDiscoveryengineV1alphaStreamAssistResponse": {
@@ -24339,6 +24761,36 @@ false
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaUploadSessionFileRequest": {
+"description": "Request for the AssistantService.UploadSessionFile method.",
+"id": "GoogleCloudDiscoveryengineV1alphaUploadSessionFileRequest",
+"properties": {
+"blob": {
+"$ref": "GdataMedia",
+"description": "Information about the file being uploaded."
+},
+"mediaRequestInfo": {
+"$ref": "ApiservingMediaRequestInfo",
+"description": "Media upload request metadata."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1alphaUploadSessionFileResponse": {
+"description": "Response for the AssistantService.UploadSessionFile method.",
+"id": "GoogleCloudDiscoveryengineV1alphaUploadSessionFileResponse",
+"properties": {
+"fileId": {
+"description": "The ID of the uploaded file.",
+"type": "string"
+},
+"mediaResponseInfo": {
+"$ref": "ApiservingMediaResponseInfo",
+"description": "Media upload response metadata."
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaUserEvent": {
 "description": "UserEvent captures all metadata information Discovery Engine API needs to know about how end users interact with your website.",
 "id": "GoogleCloudDiscoveryengineV1alphaUserEvent",
@@ -24527,6 +24979,65 @@ false
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1alphaVideoCharacteristics": {
+"description": "Standard characteristics of a video media view.",
+"id": "GoogleCloudDiscoveryengineV1alphaVideoCharacteristics",
+"properties": {
+"audioBitrateKbps": {
+"description": "Output only. Bitrate of the audio in kbps.",
+"format": "int32",
+"readOnly": true,
+"type": "integer"
+},
+"audioCodecs": {
+"description": "Output only. Audio codecs used in the video.",
+"items": {
+"type": "string"
+},
+"readOnly": true,
+"type": "array"
+},
+"duration": {
+"description": "Output only. Video duration.",
+"format": "google-duration",
+"readOnly": true,
+"type": "string"
+},
+"frameRate": {
+"description": "Output only. Frame rate (frames per second).",
+"format": "double",
+"readOnly": true,
+"type": "number"
+},
+"height": {
+"description": "Output only. Video height in pixels.",
+"format": "int32",
+"readOnly": true,
+"type": "integer"
+},
+"videoBitrateKbps": {
+"description": "Output only. Bitrate of the video in kbps.",
+"format": "int32",
+"readOnly": true,
+"type": "integer"
+},
+"videoCodecs": {
+"description": "Output only. Video codecs used in the video.",
+"items": {
+"type": "string"
+},
+"readOnly": true,
+"type": "array"
+},
+"width": {
+"description": "Output only. Video width in pixels.",
+"format": "int32",
+"readOnly": true,
+"type": "integer"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1alphaWidgetConfig": {
 "description": "WidgetConfig captures configs at the Widget level.",
 "id": "GoogleCloudDiscoveryengineV1alphaWidgetConfig",
@@ -25403,11 +25914,12 @@ false
 "type": "boolean"
 },
 "kmsKey": {
-"description": "KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
+"description": "Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
 "type": "string"
 },
 "kmsKeyVersion": {
-"description": "KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"description": "Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"readOnly": true,
 "type": "string"
 },
 "lastRotationTimestampMicros": {
@@ -28735,6 +29247,145 @@ false
 },
 "type": "object"
 },
+"GoogleCloudNotebooklmV1alphaAgentspaceMetadata": {
+"description": "Metadata about an agentspace source.",
+"id": "GoogleCloudNotebooklmV1alphaAgentspaceMetadata",
+"properties": {
+"documentName": {
+"description": "Output only. The full document name in Agentspace.",
+"readOnly": true,
+"type": "string"
+},
+"documentTitle": {
+"description": "Output only. The title of the document.",
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudNotebooklmV1alphaBatchCreateSourcesRequest": {
+"description": "Request for SourceService.BatchCreateSources method.",
+"id": "GoogleCloudNotebooklmV1alphaBatchCreateSourcesRequest",
+"properties": {
+"userContents": {
+"description": "Required. The UserContents to be uploaded.",
+"items": {
+"$ref": "GoogleCloudNotebooklmV1alphaUserContent"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudNotebooklmV1alphaBatchCreateSourcesResponse": {
+"description": "Response for SourceService.BatchCreateSources method.",
+"id": "GoogleCloudNotebooklmV1alphaBatchCreateSourcesResponse",
+"properties": {
+"sources": {
+"description": "The Sources.",
+"items": {
+"$ref": "GoogleCloudNotebooklmV1alphaSource"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudNotebooklmV1alphaListRecentlyViewedNotebooksResponse": {
+"description": "Response for NotebookService.ListRecentlyViewedNotebooks method.",
+"id": "GoogleCloudNotebooklmV1alphaListRecentlyViewedNotebooksResponse",
+"properties": {
+"nextPageToken": {
+"description": "The page token, provide this to retrieve the subsequent page.",
+"type": "string"
+},
+"notebooks": {
+"description": "The list of recently viewed notebooks.",
+"items": {
+"$ref": "GoogleCloudNotebooklmV1alphaNotebook"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudNotebooklmV1alphaNotebook": {
+"description": "Notebook is a resource where users can store their content (as sources) and interacts with the content.",
+"id": "GoogleCloudNotebooklmV1alphaNotebook",
+"properties": {
+"emoji": {
+"description": "Output only. The emoji of the notebook.",
+"readOnly": true,
+"type": "string"
+},
+"metadata": {
+"$ref": "GoogleCloudNotebooklmV1alphaNotebookMetadata",
+"description": "The metadata of the notebook."
+},
+"name": {
+"description": "Identifier. The identifier of the notebook. Format: `projects/{project}/locations/{location}/notebooks/{notebook_id}`. This field must be a UTF-8 encoded string.",
+"type": "string"
+},
+"notebookId": {
+"description": "Optional. Notebook id, which is the last segment of the notebook's resource name. This is to make it similar with notebooklm API.",
+"type": "string"
+},
+"title": {
+"description": "Optional. The title of the notebook.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudNotebooklmV1alphaNotebookMetadata": {
+"description": "Metadata for a notebook.",
+"id": "GoogleCloudNotebooklmV1alphaNotebookMetadata",
+"properties": {
+"createTime": {
+"description": "The time at which this project was created.",
+"format": "google-datetime",
+"type": "string"
+},
+"isShareable": {
+"description": "True if the project is shareable.",
+"type": "boolean"
+},
+"isShared": {
+"description": "True if this project is currently shared with other people, false otherwise.",
+"type": "boolean"
+},
+"lastViewed": {
+"description": "A timestamp indicating the time that the current in session user has last viewed the project.",
+"format": "google-datetime",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudNotebooklmV1alphaSource": {
+"description": "Source represents a single source of content.",
+"id": "GoogleCloudNotebooklmV1alphaSource",
+"properties": {
+"metadata": {
+"$ref": "GoogleCloudNotebooklmV1alphaSourceMetadata",
+"description": "Metadata about the source."
+},
+"name": {
+"description": "Identifier. The full resource name of the source. Format: `projects/{project}/locations/{location}/notebooks/{notebook}/sources/{source_id}`. This field must be a UTF-8 encoded string with a length limit of 1024 characters.",
+"type": "string"
+},
+"sourceId": {
+"$ref": "GoogleCloudNotebooklmV1alphaSourceId",
+"description": "Optional. Source id, which is the last segment of the source's resource name. This is to make it similar with notebooklm API."
+},
+"title": {
+"description": "Optional. Title of the source.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudNotebooklmV1alphaSourceId": {
 "description": "SourceId is the last segment of the source's resource name.",
 "id": "GoogleCloudNotebooklmV1alphaSourceId",
@@ -28746,6 +29397,32 @@ false
 },
 "type": "object"
 },
+"GoogleCloudNotebooklmV1alphaSourceMetadata": {
+"description": "Represents the metadata of a source and some additional information.",
+"id": "GoogleCloudNotebooklmV1alphaSourceMetadata",
+"properties": {
+"agentspaceMetadata": {
+"$ref": "GoogleCloudNotebooklmV1alphaAgentspaceMetadata",
+"description": "Metadata for an agentspace source."
+},
+"sourceAddedTimestamp": {
+"description": "The timestamp the source was added.",
+"format": "google-datetime",
+"type": "string"
+},
+"tokenCount": {
+"description": "The number of tokens in the source.",
+"format": "int32",
+"type": "integer"
+},
+"wordCount": {
+"description": "The word count of the source.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "GoogleCloudNotebooklmV1alphaUploadSourceFileRequest": {
 "description": "Request for the SourceService.UploadSourceFile method.",
 "id": "GoogleCloudNotebooklmV1alphaUploadSourceFileRequest",
@@ -28780,6 +29457,36 @@ false
 },
 "type": "object"
 },
+"GoogleCloudNotebooklmV1alphaUserContent": {
+"description": "The \"Content\" messages refer to data the user wants to upload.",
+"id": "GoogleCloudNotebooklmV1alphaUserContent",
+"properties": {
+"agentspaceContent": {
+"$ref": "GoogleCloudNotebooklmV1alphaUserContentAgentspaceContent",
+"description": "Agentspace content uploaded as source."
+}
+},
+"type": "object"
+},
+"GoogleCloudNotebooklmV1alphaUserContentAgentspaceContent": {
+"description": "Agentspace content uploaded as source.",
+"id": "GoogleCloudNotebooklmV1alphaUserContentAgentspaceContent",
+"properties": {
+"documentName": {
+"description": "Optional. The full document name in Agentspace.",
+"type": "string"
+},
+"engineName": {
+"description": "Optional. Engine to verify the permission of the document.",
+"type": "string"
+},
+"ideaforgeIdeaName": {
+"description": "Optional. The full idea name for IdeaForge.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleLongrunningCancelOperationRequest": {
 "description": "The request message for Operations.CancelOperation.",
 "id": "GoogleLongrunningCancelOperationRequest",
diff --git a/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json b/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json
index dbd57808414..80a33bc5e1b 100644
--- a/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json
+++ b/googleapiclient/discovery_cache/documents/discoveryengine.v1beta.json
@@ -2320,7 +2320,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state, starred. Examples: \"user_pseudo_id = some_id\" \"starred = true\"",
+"description": "A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: \"user_pseudo_id = some_id\" \"display_name = \\\"some_name\\\"\" \"starred = true\" \"is_pinned=true AND (NOT labels:hidden)\" \"create_time > \\\"1970-01-01T12:00:00Z\\\"\"",
 "location": "query",
 "type": "string"
 },
@@ -3425,6 +3425,65 @@
 "resources": {
 "assistants": {
 "methods": {
+"get": {
+"description": "Gets an Assistant.",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}",
+"httpMethod": "GET",
+"id": "discoveryengine.projects.locations.collections.engines.assistants.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. Resource name of Assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}`",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta/{+name}",
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1betaAssistant"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"patch": {
+"description": "Updates an Assistant",
+"flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}",
+"httpMethod": "PATCH",
+"id": "discoveryengine.projects.locations.collections.engines.assistants.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "The list of fields to update.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1beta/{+name}",
+"request": {
+"$ref": "GoogleCloudDiscoveryengineV1betaAssistant"
+},
+"response": {
+"$ref": "GoogleCloudDiscoveryengineV1betaAssistant"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "streamAssist": {
 "description": "Assists the user with a query in a streaming fashion.",
 "flatPath": "v1beta/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}:streamAssist",
@@ -4272,7 +4331,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state, starred. Examples: \"user_pseudo_id = some_id\" \"starred = true\"",
+"description": "A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: \"user_pseudo_id = some_id\" \"display_name = \\\"some_name\\\"\" \"starred = true\" \"is_pinned=true AND (NOT labels:hidden)\" \"create_time > \\\"1970-01-01T12:00:00Z\\\"\"",
 "location": "query",
 "type": "string"
 },
@@ -6139,7 +6198,7 @@
 ],
 "parameters": {
 "filter": {
-"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state, starred. Examples: \"user_pseudo_id = some_id\" \"starred = true\"",
+"description": "A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: \"user_pseudo_id = some_id\" \"display_name = \\\"some_name\\\"\" \"starred = true\" \"is_pinned=true AND (NOT labels:hidden)\" \"create_time > \\\"1970-01-01T12:00:00Z\\\"\"",
 "location": "query",
 "type": "string"
 },
@@ -8047,7 +8106,7 @@
 }
 }
 },
-"revision": "20250716",
+"revision": "20250724",
 "rootUrl": "https://discoveryengine.googleapis.com/",
 "schemas": {
 "GoogleApiDistribution": {
@@ -8532,6 +8591,17 @@
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1Assistant": {
+"description": "Discovery Engine Assistant resource.",
+"id": "GoogleCloudDiscoveryengineV1Assistant",
+"properties": {
+"name": {
+"description": "Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata": {
 "description": "Metadata related to the progress of the SiteSearchEngineService.BatchCreateTargetSites operation. This will be returned by the google.longrunning.Operation.metadata field.",
 "id": "GoogleCloudDiscoveryengineV1BatchCreateTargetSiteMetadata",
@@ -8621,11 +8691,12 @@
 "type": "boolean"
 },
 "kmsKey": {
-"description": "KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
+"description": "Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
 "type": "string"
 },
 "kmsKeyVersion": {
-"description": "KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"description": "Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"readOnly": true,
 "type": "string"
 },
 "lastRotationTimestampMicros": {
@@ -11920,11 +11991,12 @@
 "type": "boolean"
 },
 "kmsKey": {
-"description": "KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
+"description": "Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
 "type": "string"
 },
 "kmsKeyVersion": {
-"description": "KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"description": "Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"readOnly": true,
 "type": "string"
 },
 "lastRotationTimestampMicros": {
@@ -14758,7 +14830,7 @@
 "id": "GoogleCloudDiscoveryengineV1alphaListSessionsRequest",
 "properties": {
 "filter": {
-"description": "A filter to apply on the list results. The supported features are: user_pseudo_id, state, starred. Examples: \"user_pseudo_id = some_id\" \"starred = true\"",
+"description": "A comma-separated list of fields to filter by, in EBNF grammar. The supported fields are: * `user_pseudo_id` * `state` * `display_name` * `starred` * `is_pinned` * `labels` * `create_time` * `update_time` Examples: \"user_pseudo_id = some_id\" \"display_name = \\\"some_name\\\"\" \"starred = true\" \"is_pinned=true AND (NOT labels:hidden)\" \"create_time > \\\"1970-01-01T12:00:00Z\\\"\"",
 "type": "string"
 },
 "orderBy": {
@@ -18605,6 +18677,10 @@ false
 },
 "type": "array"
 },
+"name": {
+"description": "Immutable. Identifier. Resource name of the `AssistAnswer`. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/assistAnswers/{assist_answer}` This field must be a UTF-8 encoded string with a length limit of 1024 characters.",
+"type": "string"
+},
 "replies": {
 "description": "Replies of the assistant.",
 "items": {
@@ -18659,6 +18735,17 @@ false
 },
 "type": "object"
 },
+"GoogleCloudDiscoveryengineV1betaAssistant": {
+"description": "Discovery Engine Assistant resource.",
+"id": "GoogleCloudDiscoveryengineV1betaAssistant",
+"properties": {
+"name": {
+"description": "Immutable. Resource name of the assistant. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/assistants/{assistant}` It must be a UTF-8 encoded string with a length limit of 1024 characters.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDiscoveryengineV1betaAssistantContent": {
 "description": "Multi-modal content.",
 "id": "GoogleCloudDiscoveryengineV1betaAssistantContent",
@@ -19601,11 +19688,12 @@ false
 "type": "boolean"
 },
 "kmsKey": {
-"description": "KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
+"description": "Required. KMS key resource name which will be used to encrypt resources `projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{keyId}`.",
 "type": "string"
 },
 "kmsKeyVersion": {
-"description": "KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"description": "Output only. KMS key version resource name which will be used to encrypt resources `/cryptoKeyVersions/{keyVersion}`.",
+"readOnly": true,
 "type": "string"
 },
 "lastRotationTimestampMicros": {
@@ -22956,6 +23044,21 @@ false
 "dataUseTermsVersion": {
 "description": "Required. The version of the [Terms for data use](https://cloud.google.com/retail/data-use-terms) that caller has read and would like to give consent to. Acceptable version is `2022-11-23`, and this may change over time.",
 "type": "string"
+},
+"saasParams": {
+"$ref": "GoogleCloudDiscoveryengineV1betaProvisionProjectRequestSaasParams",
+"description": "Optional. Parameters for Agentspace."
+}
+},
+"type": "object"
+},
+"GoogleCloudDiscoveryengineV1betaProvisionProjectRequestSaasParams": {
+"description": "Parameters for Agentspace.",
+"id": "GoogleCloudDiscoveryengineV1betaProvisionProjectRequestSaasParams",
+"properties": {
+"acceptBizQos": {
+"description": "Optional. Set to `true` to specify that caller has read and would like to give consent to the [Terms for Agent Space quality of service].",
+"type": "boolean"
 }
 },
 "type": "object"
@@ -23246,7 +23349,7 @@ false
 "type": "string"
 },
 "records": {
-"description": "Required. A list of records to rank. At most 200 records to rank.",
+"description": "Required. A list of records to rank.",
 "items": {
 "$ref": "GoogleCloudDiscoveryengineV1betaRankingRecord"
 },
@@ -25807,10 +25910,6 @@ false
 "$ref": "GoogleCloudDiscoveryengineV1betaStreamAssistRequestToolsSpecImageGenerationSpec",
 "description": "Optional. Specification of the image generation tool."
 },
-"toolRegistry": {
-"description": "Optional. The name of the tool registry to use. Format: `projects/{project}/locations/{location}/toolRegistries/{tool_registry}`",
-"type": "string"
-},
 "vertexAiSearchSpec": {
 "$ref": "GoogleCloudDiscoveryengineV1betaStreamAssistRequestToolsSpecVertexAiSearchSpec",
 "description": "Optional. Specification of the Vertex AI Search tool."
@@ -25843,11 +25942,6 @@ false
 },
 "type": "array"
 },
-"disabled": {
-"deprecated": true,
-"description": "Optional. Deprecated. Please refrain from using this field. Whether the Vertex AI Search tool is disabled. Default value is false, the tool is enabled by default.",
-"type": "boolean"
-},
 "filter": {
 "description": "Optional. The filter syntax consists of an expression language for constructing a predicate from one or more fields of the documents being filtered. Filter expression is case-sensitive. If this field is unrecognizable, an `INVALID_ARGUMENT` is returned. Filtering in Vertex AI Search is done by mapping the LHS filter key to a key property defined in the Vertex AI Search backend -- this mapping is defined by the customer in their schema. For example a media customer might have a field 'name' in their schema. In this case the filter would look like this: filter --> name:'ANY(\"king kong\")' For more information about filtering including syntax and filter operators, see [Filter](https://cloud.google.com/generative-ai-app-builder/docs/filter-search-metadata)",
 "type": "string"
@@ -25864,13 +25958,7 @@ false
 "GoogleCloudDiscoveryengineV1betaStreamAssistRequestToolsSpecWebGroundingSpec": {
 "description": "Specification of the web grounding tool.",
 "id": "GoogleCloudDiscoveryengineV1betaStreamAssistRequestToolsSpecWebGroundingSpec",
-"properties": {
-"enabled": {
-"deprecated": true,
-"description": "Optional. Deprecated. Please refrain from using this field. Whether the web grounding tool is enabled.",
-"type": "boolean"
-}
-},
+"properties": {},
 "type": "object"
 },
 "GoogleCloudDiscoveryengineV1betaStreamAssistResponse": {

From 0c96131a17c43cec022fedebaa4d4635d9eba1b7 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:12 +0000
Subject: [PATCH 12/36] feat(drive): update the api

#### drive:v3

The following keys were deleted:
- resources.operations.methods.cancel (Total Keys: 9)
- resources.operations.methods.delete (Total Keys: 9)
- resources.operations.methods.list (Total Keys: 16)
- schemas.ListOperationsResponse (Total Keys: 5)
---
 docs/dyn/drive_v3.changes.html                |   4 +-
 docs/dyn/drive_v3.files.html                  |  32 ++---
 docs/dyn/drive_v3.operations.html             |  95 ---------------
 .../discovery_cache/documents/drive.v3.json   | 112 +-----------------
 4 files changed, 21 insertions(+), 222 deletions(-)

diff --git a/docs/dyn/drive_v3.changes.html b/docs/dyn/drive_v3.changes.html
index 1d158b677d8..85e85af4be8 100644
--- a/docs/dyn/drive_v3.changes.html
+++ b/docs/dyn/drive_v3.changes.html
@@ -212,7 +212,7 @@ 
Method Details

           "canAddFolderFromAnotherDrive": True or False, # Output only. Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives.
           "canAddMyDriveParent": True or False, # Output only. Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files.
           "canChangeCopyRequiresWriterPermission": True or False, # Output only. Whether the current user can change the `copyRequiresWriterPermission` restriction of this file.
-          "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner-applied download restrictions of the file.
+          "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner or organizer-applied download restrictions of the file.
           "canChangeSecurityUpdateEnabled": True or False, # Output only. Whether the current user can change the securityUpdateEnabled field on link share metadata.
           "canChangeViewersCanCopyContent": True or False, # Deprecated: Output only.
           "canComment": True or False, # Output only. Whether the current user can comment on this file.
@@ -281,7 +281,7 @@ 
Method Details

         "createdTime": "A String", # The time at which the file was created (RFC 3339 date-time).
         "description": "A String", # A short description of the file.
         "downloadRestrictions": { # Download restrictions applied to the file. # Download restrictions applied on the file.
-          "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
+          "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # Output only. The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
             "restrictedForReaders": True or False, # Whether download and copy is restricted for readers.
             "restrictedForWriters": True or False, # Whether download and copy is restricted for writers. If true, download is also restricted for readers.
           },
diff --git a/docs/dyn/drive_v3.files.html b/docs/dyn/drive_v3.files.html
index a3ca58b888d..af90854c012 100644
--- a/docs/dyn/drive_v3.files.html
+++ b/docs/dyn/drive_v3.files.html
@@ -154,7 +154,7 @@ 
Method Details

     "canAddFolderFromAnotherDrive": True or False, # Output only. Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives.
     "canAddMyDriveParent": True or False, # Output only. Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files.
     "canChangeCopyRequiresWriterPermission": True or False, # Output only. Whether the current user can change the `copyRequiresWriterPermission` restriction of this file.
-    "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner-applied download restrictions of the file.
+    "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner or organizer-applied download restrictions of the file.
     "canChangeSecurityUpdateEnabled": True or False, # Output only. Whether the current user can change the securityUpdateEnabled field on link share metadata.
     "canChangeViewersCanCopyContent": True or False, # Deprecated: Output only.
     "canComment": True or False, # Output only. Whether the current user can comment on this file.
@@ -223,7 +223,7 @@ 
Method Details

   "createdTime": "A String", # The time at which the file was created (RFC 3339 date-time).
   "description": "A String", # A short description of the file.
   "downloadRestrictions": { # Download restrictions applied to the file. # Download restrictions applied on the file.
-    "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
+    "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # Output only. The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
       "restrictedForReaders": True or False, # Whether download and copy is restricted for readers.
       "restrictedForWriters": True or False, # Whether download and copy is restricted for writers. If true, download is also restricted for readers.
     },
@@ -465,7 +465,7 @@ 
Method Details

     "canAddFolderFromAnotherDrive": True or False, # Output only. Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives.
     "canAddMyDriveParent": True or False, # Output only. Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files.
     "canChangeCopyRequiresWriterPermission": True or False, # Output only. Whether the current user can change the `copyRequiresWriterPermission` restriction of this file.
-    "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner-applied download restrictions of the file.
+    "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner or organizer-applied download restrictions of the file.
     "canChangeSecurityUpdateEnabled": True or False, # Output only. Whether the current user can change the securityUpdateEnabled field on link share metadata.
     "canChangeViewersCanCopyContent": True or False, # Deprecated: Output only.
     "canComment": True or False, # Output only. Whether the current user can comment on this file.
@@ -534,7 +534,7 @@ 
Method Details

   "createdTime": "A String", # The time at which the file was created (RFC 3339 date-time).
   "description": "A String", # A short description of the file.
   "downloadRestrictions": { # Download restrictions applied to the file. # Download restrictions applied on the file.
-    "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
+    "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # Output only. The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
       "restrictedForReaders": True or False, # Whether download and copy is restricted for readers.
       "restrictedForWriters": True or False, # Whether download and copy is restricted for writers. If true, download is also restricted for readers.
     },
@@ -769,7 +769,7 @@ 
Method Details

     "canAddFolderFromAnotherDrive": True or False, # Output only. Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives.
     "canAddMyDriveParent": True or False, # Output only. Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files.
     "canChangeCopyRequiresWriterPermission": True or False, # Output only. Whether the current user can change the `copyRequiresWriterPermission` restriction of this file.
-    "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner-applied download restrictions of the file.
+    "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner or organizer-applied download restrictions of the file.
     "canChangeSecurityUpdateEnabled": True or False, # Output only. Whether the current user can change the securityUpdateEnabled field on link share metadata.
     "canChangeViewersCanCopyContent": True or False, # Deprecated: Output only.
     "canComment": True or False, # Output only. Whether the current user can comment on this file.
@@ -838,7 +838,7 @@ 
Method Details

   "createdTime": "A String", # The time at which the file was created (RFC 3339 date-time).
   "description": "A String", # A short description of the file.
   "downloadRestrictions": { # Download restrictions applied to the file. # Download restrictions applied on the file.
-    "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
+    "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # Output only. The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
       "restrictedForReaders": True or False, # Whether download and copy is restricted for readers.
       "restrictedForWriters": True or False, # Whether download and copy is restricted for writers. If true, download is also restricted for readers.
     },
@@ -1083,7 +1083,7 @@ 
Method Details

     "canAddFolderFromAnotherDrive": True or False, # Output only. Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives.
     "canAddMyDriveParent": True or False, # Output only. Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files.
     "canChangeCopyRequiresWriterPermission": True or False, # Output only. Whether the current user can change the `copyRequiresWriterPermission` restriction of this file.
-    "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner-applied download restrictions of the file.
+    "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner or organizer-applied download restrictions of the file.
     "canChangeSecurityUpdateEnabled": True or False, # Output only. Whether the current user can change the securityUpdateEnabled field on link share metadata.
     "canChangeViewersCanCopyContent": True or False, # Deprecated: Output only.
     "canComment": True or False, # Output only. Whether the current user can comment on this file.
@@ -1152,7 +1152,7 @@ 
Method Details

   "createdTime": "A String", # The time at which the file was created (RFC 3339 date-time).
   "description": "A String", # A short description of the file.
   "downloadRestrictions": { # Download restrictions applied to the file. # Download restrictions applied on the file.
-    "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
+    "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # Output only. The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
       "restrictedForReaders": True or False, # Whether download and copy is restricted for readers.
       "restrictedForWriters": True or False, # Whether download and copy is restricted for writers. If true, download is also restricted for readers.
     },
@@ -1518,7 +1518,7 @@ 
Method Details

     "canAddFolderFromAnotherDrive": True or False, # Output only. Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives.
     "canAddMyDriveParent": True or False, # Output only. Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files.
     "canChangeCopyRequiresWriterPermission": True or False, # Output only. Whether the current user can change the `copyRequiresWriterPermission` restriction of this file.
-    "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner-applied download restrictions of the file.
+    "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner or organizer-applied download restrictions of the file.
     "canChangeSecurityUpdateEnabled": True or False, # Output only. Whether the current user can change the securityUpdateEnabled field on link share metadata.
     "canChangeViewersCanCopyContent": True or False, # Deprecated: Output only.
     "canComment": True or False, # Output only. Whether the current user can comment on this file.
@@ -1587,7 +1587,7 @@ 
Method Details

   "createdTime": "A String", # The time at which the file was created (RFC 3339 date-time).
   "description": "A String", # A short description of the file.
   "downloadRestrictions": { # Download restrictions applied to the file. # Download restrictions applied on the file.
-    "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
+    "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # Output only. The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
       "restrictedForReaders": True or False, # Whether download and copy is restricted for readers.
       "restrictedForWriters": True or False, # Whether download and copy is restricted for writers. If true, download is also restricted for readers.
     },
@@ -1869,7 +1869,7 @@ 
Method Details

         "canAddFolderFromAnotherDrive": True or False, # Output only. Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives.
         "canAddMyDriveParent": True or False, # Output only. Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files.
         "canChangeCopyRequiresWriterPermission": True or False, # Output only. Whether the current user can change the `copyRequiresWriterPermission` restriction of this file.
-        "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner-applied download restrictions of the file.
+        "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner or organizer-applied download restrictions of the file.
         "canChangeSecurityUpdateEnabled": True or False, # Output only. Whether the current user can change the securityUpdateEnabled field on link share metadata.
         "canChangeViewersCanCopyContent": True or False, # Deprecated: Output only.
         "canComment": True or False, # Output only. Whether the current user can comment on this file.
@@ -1938,7 +1938,7 @@ 
Method Details

       "createdTime": "A String", # The time at which the file was created (RFC 3339 date-time).
       "description": "A String", # A short description of the file.
       "downloadRestrictions": { # Download restrictions applied to the file. # Download restrictions applied on the file.
-        "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
+        "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # Output only. The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
           "restrictedForReaders": True or False, # Whether download and copy is restricted for readers.
           "restrictedForWriters": True or False, # Whether download and copy is restricted for writers. If true, download is also restricted for readers.
         },
@@ -2356,7 +2356,7 @@ 
Method Details

     "canAddFolderFromAnotherDrive": True or False, # Output only. Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives.
     "canAddMyDriveParent": True or False, # Output only. Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files.
     "canChangeCopyRequiresWriterPermission": True or False, # Output only. Whether the current user can change the `copyRequiresWriterPermission` restriction of this file.
-    "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner-applied download restrictions of the file.
+    "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner or organizer-applied download restrictions of the file.
     "canChangeSecurityUpdateEnabled": True or False, # Output only. Whether the current user can change the securityUpdateEnabled field on link share metadata.
     "canChangeViewersCanCopyContent": True or False, # Deprecated: Output only.
     "canComment": True or False, # Output only. Whether the current user can comment on this file.
@@ -2425,7 +2425,7 @@ 
Method Details

   "createdTime": "A String", # The time at which the file was created (RFC 3339 date-time).
   "description": "A String", # A short description of the file.
   "downloadRestrictions": { # Download restrictions applied to the file. # Download restrictions applied on the file.
-    "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
+    "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # Output only. The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
       "restrictedForReaders": True or False, # Whether download and copy is restricted for readers.
       "restrictedForWriters": True or False, # Whether download and copy is restricted for writers. If true, download is also restricted for readers.
     },
@@ -2671,7 +2671,7 @@ 
Method Details

     "canAddFolderFromAnotherDrive": True or False, # Output only. Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives.
     "canAddMyDriveParent": True or False, # Output only. Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files.
     "canChangeCopyRequiresWriterPermission": True or False, # Output only. Whether the current user can change the `copyRequiresWriterPermission` restriction of this file.
-    "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner-applied download restrictions of the file.
+    "canChangeItemDownloadRestriction": True or False, # Output only. Whether the current user can change the owner or organizer-applied download restrictions of the file.
     "canChangeSecurityUpdateEnabled": True or False, # Output only. Whether the current user can change the securityUpdateEnabled field on link share metadata.
     "canChangeViewersCanCopyContent": True or False, # Deprecated: Output only.
     "canComment": True or False, # Output only. Whether the current user can comment on this file.
@@ -2740,7 +2740,7 @@ 
Method Details

   "createdTime": "A String", # The time at which the file was created (RFC 3339 date-time).
   "description": "A String", # A short description of the file.
   "downloadRestrictions": { # Download restrictions applied to the file. # Download restrictions applied on the file.
-    "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
+    "effectiveDownloadRestrictionWithContext": { # A restriction for copy and download of the file. # Output only. The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
       "restrictedForReaders": True or False, # Whether download and copy is restricted for readers.
       "restrictedForWriters": True or False, # Whether download and copy is restricted for writers. If true, download is also restricted for readers.
     },
diff --git a/docs/dyn/drive_v3.operations.html b/docs/dyn/drive_v3.operations.html
index ddd0a714900..57eeea18844 100644
--- a/docs/dyn/drive_v3.operations.html
+++ b/docs/dyn/drive_v3.operations.html
@@ -74,56 +74,18 @@
 
 
Google Drive API . operations

 
Instance Methods

-

-  cancel(name, x__xgafv=None)

-
Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.

 

   close()

 
Close httplib2 connections.

-

-  delete(name, x__xgafv=None)

-
Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.

 

   get(name, x__xgafv=None)

 
Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.

-

-  list(filter=None, name=None, pageSize=None, pageToken=None, x__xgafv=None)

-
Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.

-

-  list_next()

-
Retrieves the next page of results.

 
Method Details

-

-    cancel(name, x__xgafv=None)
-  
Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.
-
-Args:
-  name: string, The name of the operation resource to be cancelled. (required)
-  x__xgafv: string, V1 error format.
-    Allowed values
-      1 - v1 error format
-      2 - v2 error format
-

-

-
 

     close()
   
Close httplib2 connections.

 

 
-

-    delete(name, x__xgafv=None)
-  
Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.
-
-Args:
-  name: string, The name of the operation resource to be deleted. (required)
-  x__xgafv: string, V1 error format.
-    Allowed values
-      1 - v1 error format
-      2 - v2 error format
-

-

-
 

     get(name, x__xgafv=None)
   
Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.
@@ -159,61 +121,4 @@ 
Method Details

 }

 

 
-

-    list(filter=None, name=None, pageSize=None, pageToken=None, x__xgafv=None)
-  
Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.
-
-Args:
-  filter: string, The standard list filter.
-  name: string, The name of the operation's parent resource.
-  pageSize: integer, The standard list page size.
-  pageToken: string, The standard list page token.
-  x__xgafv: string, V1 error format.
-    Allowed values
-      1 - v1 error format
-      2 - v2 error format
-
-Returns:
-  An object of the form:
-
-    { # The response message for Operations.ListOperations.
-  "nextPageToken": "A String", # The standard List next-page token.
-  "operations": [ # A list of operations that matches the specified filter in the request.
-    { # 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.
-      },
-    },
-  ],
-}

-

-
-

-    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.
-        

-

-
 
\ No newline at end of file
diff --git a/googleapiclient/discovery_cache/documents/drive.v3.json b/googleapiclient/discovery_cache/documents/drive.v3.json
index cad779be899..64f38dac9ba 100644
--- a/googleapiclient/discovery_cache/documents/drive.v3.json
+++ b/googleapiclient/discovery_cache/documents/drive.v3.json
@@ -1816,54 +1816,6 @@
 },
 "operations": {
 "methods": {
-"cancel": {
-"description": "Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.",
-"flatPath": "operations/{name}:cancel",
-"httpMethod": "POST",
-"id": "drive.operations.cancel",
-"parameterOrder": [
-"name"
-],
-"parameters": {
-"name": {
-"description": "The name of the operation resource to be cancelled.",
-"location": "path",
-"required": true,
-"type": "string"
-}
-},
-"path": "operations/{name}:cancel",
-"scopes": [
-"https://www.googleapis.com/auth/drive",
-"https://www.googleapis.com/auth/drive.file",
-"https://www.googleapis.com/auth/drive.meet.readonly",
-"https://www.googleapis.com/auth/drive.readonly"
-]
-},
-"delete": {
-"description": "Deletes a long-running operation. This method indicates that the client is no longer interested in the operation result. It does not cancel the operation. If the server doesn't support this method, it returns `google.rpc.Code.UNIMPLEMENTED`.",
-"flatPath": "operations/{name}",
-"httpMethod": "DELETE",
-"id": "drive.operations.delete",
-"parameterOrder": [
-"name"
-],
-"parameters": {
-"name": {
-"description": "The name of the operation resource to be deleted.",
-"location": "path",
-"required": true,
-"type": "string"
-}
-},
-"path": "operations/{name}",
-"scopes": [
-"https://www.googleapis.com/auth/drive",
-"https://www.googleapis.com/auth/drive.file",
-"https://www.googleapis.com/auth/drive.meet.readonly",
-"https://www.googleapis.com/auth/drive.readonly"
-]
-},
 "get": {
 "description": "Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.",
 "flatPath": "operations/{name}",
@@ -1890,46 +1842,6 @@
 "https://www.googleapis.com/auth/drive.meet.readonly",
 "https://www.googleapis.com/auth/drive.readonly"
 ]
-},
-"list": {
-"description": "Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns `UNIMPLEMENTED`.",
-"flatPath": "operations",
-"httpMethod": "GET",
-"id": "drive.operations.list",
-"parameterOrder": [],
-"parameters": {
-"filter": {
-"description": "The standard list filter.",
-"location": "query",
-"type": "string"
-},
-"name": {
-"description": "The name of the operation's parent resource.",
-"location": "query",
-"type": "string"
-},
-"pageSize": {
-"description": "The standard list page size.",
-"format": "int32",
-"location": "query",
-"type": "integer"
-},
-"pageToken": {
-"description": "The standard list page token.",
-"location": "query",
-"type": "string"
-}
-},
-"path": "operations",
-"response": {
-"$ref": "ListOperationsResponse"
-},
-"scopes": [
-"https://www.googleapis.com/auth/drive",
-"https://www.googleapis.com/auth/drive.file",
-"https://www.googleapis.com/auth/drive.meet.readonly",
-"https://www.googleapis.com/auth/drive.readonly"
-]
 }
 }
 },
@@ -2806,7 +2718,7 @@
 }
 }
 },
-"revision": "20250701",
+"revision": "20250723",
 "rootUrl": "https://www.googleapis.com/",
 "schemas": {
 "About": {
@@ -3464,7 +3376,7 @@
 "properties": {
 "effectiveDownloadRestrictionWithContext": {
 "$ref": "DownloadRestriction",
-"description": "The effective download restriction applied to this file. This considers all restriction settings and DLP rules."
+"description": "Output only. The effective download restriction applied to this file. This considers all restriction settings and DLP rules."
 },
 "itemDownloadRestriction": {
 "$ref": "DownloadRestriction",
@@ -3721,7 +3633,7 @@
 "type": "boolean"
 },
 "canChangeItemDownloadRestriction": {
-"description": "Output only. Whether the current user can change the owner-applied download restrictions of the file.",
+"description": "Output only. Whether the current user can change the owner or organizer-applied download restrictions of the file.",
 "type": "boolean"
 },
 "canChangeSecurityUpdateEnabled": {
@@ -4620,24 +4532,6 @@
 },
 "type": "object"
 },
-"ListOperationsResponse": {
-"description": "The response message for Operations.ListOperations.",
-"id": "ListOperationsResponse",
-"properties": {
-"nextPageToken": {
-"description": "The standard List next-page token.",
-"type": "string"
-},
-"operations": {
-"description": "A list of operations that matches the specified filter in the request.",
-"items": {
-"$ref": "Operation"
-},
-"type": "array"
-}
-},
-"type": "object"
-},
 "ModifyLabelsRequest": {
 "description": "A request to modify the set of labels on a file. This request may contain many modifications that will either all succeed or all fail atomically.",
 "id": "ModifyLabelsRequest",

From 5d62480663574271f061eb8b9b34f7dcde872380 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:12 +0000
Subject: [PATCH 13/36] feat(file): update the api

#### file:v1

The following keys were added:
- schemas.ReplicaConfig.properties.stateUpdateTime (Total Keys: 3)

#### file:v1beta1

The following keys were added:
- schemas.ReplicaConfig.properties.stateUpdateTime (Total Keys: 3)
---
 docs/dyn/file_v1.projects.locations.instances.html        | 4 ++++
 docs/dyn/file_v1beta1.projects.locations.instances.html   | 4 ++++
 googleapiclient/discovery_cache/documents/file.v1.json    | 8 +++++++-
 .../discovery_cache/documents/file.v1beta1.json           | 8 +++++++-
 4 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/docs/dyn/file_v1.projects.locations.instances.html b/docs/dyn/file_v1.projects.locations.instances.html
index b14c9710f56..b049ce28a95 100644
--- a/docs/dyn/file_v1.projects.locations.instances.html
+++ b/docs/dyn/file_v1.projects.locations.instances.html
@@ -192,6 +192,7 @@ 
Method Details

         "stateReasons": [ # Output only. Additional information about the replication state, if available.
           "A String",
         ],
+        "stateUpdateTime": "A String", # Output only. The time when the replica state was updated.
       },
     ],
     "role": "A String", # Optional. The replication role.
@@ -357,6 +358,7 @@ 
Method Details

         "stateReasons": [ # Output only. Additional information about the replication state, if available.
           "A String",
         ],
+        "stateUpdateTime": "A String", # Output only. The time when the replica state was updated.
       },
     ],
     "role": "A String", # Optional. The replication role.
@@ -463,6 +465,7 @@ 
Method Details

             "stateReasons": [ # Output only. Additional information about the replication state, if available.
               "A String",
             ],
+            "stateUpdateTime": "A String", # Output only. The time when the replica state was updated.
           },
         ],
         "role": "A String", # Optional. The replication role.
@@ -578,6 +581,7 @@ 
Method Details

         "stateReasons": [ # Output only. Additional information about the replication state, if available.
           "A String",
         ],
+        "stateUpdateTime": "A String", # Output only. The time when the replica state was updated.
       },
     ],
     "role": "A String", # Optional. The replication role.
diff --git a/docs/dyn/file_v1beta1.projects.locations.instances.html b/docs/dyn/file_v1beta1.projects.locations.instances.html
index 63ee69807b1..ab3953861ec 100644
--- a/docs/dyn/file_v1beta1.projects.locations.instances.html
+++ b/docs/dyn/file_v1beta1.projects.locations.instances.html
@@ -223,6 +223,7 @@ 
Method Details

         "stateReasons": [ # Output only. Additional information about the replication state, if available.
           "A String",
         ],
+        "stateUpdateTime": "A String", # Output only. The time when the replica state was updated.
       },
     ],
     "role": "A String", # Output only. The replication role.
@@ -414,6 +415,7 @@ 
Method Details

         "stateReasons": [ # Output only. Additional information about the replication state, if available.
           "A String",
         ],
+        "stateUpdateTime": "A String", # Output only. The time when the replica state was updated.
       },
     ],
     "role": "A String", # Output only. The replication role.
@@ -546,6 +548,7 @@ 
Method Details

             "stateReasons": [ # Output only. Additional information about the replication state, if available.
               "A String",
             ],
+            "stateUpdateTime": "A String", # Output only. The time when the replica state was updated.
           },
         ],
         "role": "A String", # Output only. The replication role.
@@ -687,6 +690,7 @@ 
Method Details

         "stateReasons": [ # Output only. Additional information about the replication state, if available.
           "A String",
         ],
+        "stateUpdateTime": "A String", # Output only. The time when the replica state was updated.
       },
     ],
     "role": "A String", # Output only. The replication role.
diff --git a/googleapiclient/discovery_cache/documents/file.v1.json b/googleapiclient/discovery_cache/documents/file.v1.json
index a7f994e59fa..80c84f9106d 100644
--- a/googleapiclient/discovery_cache/documents/file.v1.json
+++ b/googleapiclient/discovery_cache/documents/file.v1.json
@@ -908,7 +908,7 @@
 }
 }
 },
-"revision": "20250421",
+"revision": "20250716",
 "rootUrl": "https://file.googleapis.com/",
 "schemas": {
 "Backup": {
@@ -2143,6 +2143,12 @@
 },
 "readOnly": true,
 "type": "array"
+},
+"stateUpdateTime": {
+"description": "Output only. The time when the replica state was updated.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
 }
 },
 "type": "object"
diff --git a/googleapiclient/discovery_cache/documents/file.v1beta1.json b/googleapiclient/discovery_cache/documents/file.v1beta1.json
index 30166e3cd13..e17b7dccc0b 100644
--- a/googleapiclient/discovery_cache/documents/file.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/file.v1beta1.json
@@ -1075,7 +1075,7 @@
 }
 }
 },
-"revision": "20250421",
+"revision": "20250716",
 "rootUrl": "https://file.googleapis.com/",
 "schemas": {
 "Backup": {
@@ -2460,6 +2460,12 @@
 "type": "string"
 },
 "type": "array"
+},
+"stateUpdateTime": {
+"description": "Output only. The time when the replica state was updated.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
 }
 },
 "type": "object"

From 538d1d3ab016afdb870d546941effe2f4b47675c Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:12 +0000
Subject: [PATCH 14/36] feat(firebaseml): update the api

#### firebaseml:v2beta

The following keys were deleted:
- schemas.GoogleCloudAiplatformV1beta1Tool.properties.computerUse.$ref (Total Keys: 1)
- schemas.GoogleCloudAiplatformV1beta1ToolComputerUse (Total Keys: 3)

The following keys were added:
- schemas.GoogleCloudAiplatformV1beta1GroundingChunkMaps.properties.placeAnswerSources.$ref (Total Keys: 1)
- schemas.GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSources (Total Keys: 16)
- schemas.GoogleCloudAiplatformV1beta1VideoMetadata.properties.fps (Total Keys: 2)
---
 ....projects.locations.publishers.models.html | 49 ++++++++--
 .../documents/firebaseml.v2beta.json          | 98 ++++++++++++++-----
 2 files changed, 114 insertions(+), 33 deletions(-)

diff --git a/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html b/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html
index 2341d6a351e..48ae8e10745 100644
--- a/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html
+++ b/docs/dyn/firebaseml_v2beta.projects.locations.publishers.models.html
@@ -143,6 +143,7 @@ 
Method Details

           "thoughtSignature": "A String", # Optional. An opaque signature for the thought so it can be reused in subsequent requests.
           "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.
+            "fps": 3.14, # Optional. The frame rate of the video sent to the model. If not specified, the default value will be 1.0. The fps range is (0.0, 24.0].
             "startOffset": "A String", # Optional. The start offset of the video.
           },
         },
@@ -279,6 +280,7 @@ 
Method Details

         "thoughtSignature": "A String", # Optional. An opaque signature for the thought so it can be reused in subsequent requests.
         "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.
+          "fps": 3.14, # Optional. The frame rate of the video sent to the model. If not specified, the default value will be 1.0. The fps range is (0.0, 24.0].
           "startOffset": "A String", # Optional. The start offset of the video.
         },
       },
@@ -289,9 +291,6 @@ 
Method Details

     { # 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).
       "codeExecution": { # Tool that executes code generated by the model, and automatically returns the result to the model. See also [ExecutableCode]and [CodeExecutionResult] which are input and output to this tool. # Optional. CodeExecution tool type. Enables the model to execute code as part of generation.
       },
-      "computerUse": { # Tool to support computer use. # Optional. Tool to support the model interacting directly with the computer. If enabled, it automatically populates computer-use specific Function Declarations.
-        "environment": "A String", # Required. The environment being operated.
-      },
       "enterpriseWebSearch": { # Tool to search public web data, powered by Vertex AI Search and Sec4 compliance. # Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance.
       },
       "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 512 function declarations can be provided.
@@ -587,6 +586,7 @@ 
Method Details

           "thoughtSignature": "A String", # Optional. An opaque signature for the thought so it can be reused in subsequent requests.
           "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.
+            "fps": 3.14, # Optional. The frame rate of the video sent to the model. If not specified, the default value will be 1.0. The fps range is (0.0, 24.0].
             "startOffset": "A String", # Optional. The start offset of the video.
           },
         },
@@ -729,6 +729,7 @@ 
Method Details

         "thoughtSignature": "A String", # Optional. An opaque signature for the thought so it can be reused in subsequent requests.
         "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.
+          "fps": 3.14, # Optional. The frame rate of the video sent to the model. If not specified, the default value will be 1.0. The fps range is (0.0, 24.0].
           "startOffset": "A String", # Optional. The start offset of the video.
         },
       },
@@ -754,9 +755,6 @@ 
Method Details

     { # 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).
       "codeExecution": { # Tool that executes code generated by the model, and automatically returns the result to the model. See also [ExecutableCode]and [CodeExecutionResult] which are input and output to this tool. # Optional. CodeExecution tool type. Enables the model to execute code as part of generation.
       },
-      "computerUse": { # Tool to support computer use. # Optional. Tool to support the model interacting directly with the computer. If enabled, it automatically populates computer-use specific Function Declarations.
-        "environment": "A String", # Required. The environment being operated.
-      },
       "enterpriseWebSearch": { # Tool to search public web data, powered by Vertex AI Search and Sec4 compliance. # Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance.
       },
       "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 512 function declarations can be provided.
@@ -1048,6 +1046,7 @@ 
Method Details

             "thoughtSignature": "A String", # Optional. An opaque signature for the thought so it can be reused in subsequent requests.
             "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.
+              "fps": 3.14, # Optional. The frame rate of the video sent to the model. If not specified, the default value will be 1.0. The fps range is (0.0, 24.0].
               "startOffset": "A String", # Optional. The start offset of the video.
             },
           },
@@ -1061,6 +1060,22 @@ 
Method Details

         "groundingChunks": [ # List of supporting references retrieved from specified grounding source.
           { # Grounding chunk.
             "maps": { # Chunk from Google Maps. # Grounding chunk from Google Maps.
+              "placeAnswerSources": { # Sources used to generate the place answer. # Sources used to generate the place answer. This includes review snippets and photos that were used to generate the answer, as well as uris to flag content.
+                "flagContentUri": "A String", # A link where users can flag a problem with the generated answer.
+                "reviewSnippets": [ # Snippets of reviews that are used to generate the answer.
+                  { # Encapsulates a review snippet.
+                    "authorAttribution": { # Author attribution for a photo or review. # This review's author.
+                      "displayName": "A String", # Name of the author of the Photo or Review.
+                      "photoUri": "A String", # Profile photo URI of the author of the Photo or Review.
+                      "uri": "A String", # URI of the author of the Photo or Review.
+                    },
+                    "flagContentUri": "A String", # A link where users can flag a problem with the review.
+                    "googleMapsUri": "A String", # A link to show the review on Google Maps.
+                    "relativePublishTimeDescription": "A String", # A string of formatted recent time, expressing the review time relative to the current time in a form appropriate for the language and country.
+                    "review": "A String", # A reference representing this place review which may be used to look up this place review again.
+                  },
+                ],
+              },
               "placeId": "A String", # This Place's resource name, in `places/{place_id}` format. Can be used to look up the Place.
               "text": "A String", # Text of the chunk.
               "title": "A String", # Title of the chunk.
@@ -1263,6 +1278,7 @@ 
Method Details

           "thoughtSignature": "A String", # Optional. An opaque signature for the thought so it can be reused in subsequent requests.
           "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.
+            "fps": 3.14, # Optional. The frame rate of the video sent to the model. If not specified, the default value will be 1.0. The fps range is (0.0, 24.0].
             "startOffset": "A String", # Optional. The start offset of the video.
           },
         },
@@ -1405,6 +1421,7 @@ 
Method Details

         "thoughtSignature": "A String", # Optional. An opaque signature for the thought so it can be reused in subsequent requests.
         "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.
+          "fps": 3.14, # Optional. The frame rate of the video sent to the model. If not specified, the default value will be 1.0. The fps range is (0.0, 24.0].
           "startOffset": "A String", # Optional. The start offset of the video.
         },
       },
@@ -1430,9 +1447,6 @@ 
Method Details

     { # 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).
       "codeExecution": { # Tool that executes code generated by the model, and automatically returns the result to the model. See also [ExecutableCode]and [CodeExecutionResult] which are input and output to this tool. # Optional. CodeExecution tool type. Enables the model to execute code as part of generation.
       },
-      "computerUse": { # Tool to support computer use. # Optional. Tool to support the model interacting directly with the computer. If enabled, it automatically populates computer-use specific Function Declarations.
-        "environment": "A String", # Required. The environment being operated.
-      },
       "enterpriseWebSearch": { # Tool to search public web data, powered by Vertex AI Search and Sec4 compliance. # Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance.
       },
       "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 512 function declarations can be provided.
@@ -1724,6 +1738,7 @@ 
Method Details

             "thoughtSignature": "A String", # Optional. An opaque signature for the thought so it can be reused in subsequent requests.
             "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.
+              "fps": 3.14, # Optional. The frame rate of the video sent to the model. If not specified, the default value will be 1.0. The fps range is (0.0, 24.0].
               "startOffset": "A String", # Optional. The start offset of the video.
             },
           },
@@ -1737,6 +1752,22 @@ 
Method Details

         "groundingChunks": [ # List of supporting references retrieved from specified grounding source.
           { # Grounding chunk.
             "maps": { # Chunk from Google Maps. # Grounding chunk from Google Maps.
+              "placeAnswerSources": { # Sources used to generate the place answer. # Sources used to generate the place answer. This includes review snippets and photos that were used to generate the answer, as well as uris to flag content.
+                "flagContentUri": "A String", # A link where users can flag a problem with the generated answer.
+                "reviewSnippets": [ # Snippets of reviews that are used to generate the answer.
+                  { # Encapsulates a review snippet.
+                    "authorAttribution": { # Author attribution for a photo or review. # This review's author.
+                      "displayName": "A String", # Name of the author of the Photo or Review.
+                      "photoUri": "A String", # Profile photo URI of the author of the Photo or Review.
+                      "uri": "A String", # URI of the author of the Photo or Review.
+                    },
+                    "flagContentUri": "A String", # A link where users can flag a problem with the review.
+                    "googleMapsUri": "A String", # A link to show the review on Google Maps.
+                    "relativePublishTimeDescription": "A String", # A string of formatted recent time, expressing the review time relative to the current time in a form appropriate for the language and country.
+                    "review": "A String", # A reference representing this place review which may be used to look up this place review again.
+                  },
+                ],
+              },
               "placeId": "A String", # This Place's resource name, in `places/{place_id}` format. Can be used to look up the Place.
               "text": "A String", # Text of the chunk.
               "title": "A String", # Title of the chunk.
diff --git a/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json b/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json
index 1991f6befaf..0bf1755a52a 100644
--- a/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json
+++ b/googleapiclient/discovery_cache/documents/firebaseml.v2beta.json
@@ -206,7 +206,7 @@
 }
 }
 },
-"revision": "20250715",
+"revision": "20250723",
 "rootUrl": "https://firebaseml.googleapis.com/",
 "schemas": {
 "Date": {
@@ -1415,6 +1415,10 @@
 "description": "Chunk from Google Maps.",
 "id": "GoogleCloudAiplatformV1beta1GroundingChunkMaps",
 "properties": {
+"placeAnswerSources": {
+"$ref": "GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSources",
+"description": "Sources used to generate the place answer. This includes review snippets and photos that were used to generate the answer, as well as uris to flag content."
+},
 "placeId": {
 "description": "This Place's resource name, in `places/{place_id}` format. Can be used to look up the Place.",
 "type": "string"
@@ -1434,6 +1438,70 @@
 },
 "type": "object"
 },
+"GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSources": {
+"description": "Sources used to generate the place answer.",
+"id": "GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSources",
+"properties": {
+"flagContentUri": {
+"description": "A link where users can flag a problem with the generated answer.",
+"type": "string"
+},
+"reviewSnippets": {
+"description": "Snippets of reviews that are used to generate the answer.",
+"items": {
+"$ref": "GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSourcesReviewSnippet"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
+"GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution": {
+"description": "Author attribution for a photo or review.",
+"id": "GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution",
+"properties": {
+"displayName": {
+"description": "Name of the author of the Photo or Review.",
+"type": "string"
+},
+"photoUri": {
+"description": "Profile photo URI of the author of the Photo or Review.",
+"type": "string"
+},
+"uri": {
+"description": "URI of the author of the Photo or Review.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSourcesReviewSnippet": {
+"description": "Encapsulates a review snippet.",
+"id": "GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSourcesReviewSnippet",
+"properties": {
+"authorAttribution": {
+"$ref": "GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSourcesAuthorAttribution",
+"description": "This review's author."
+},
+"flagContentUri": {
+"description": "A link where users can flag a problem with the review.",
+"type": "string"
+},
+"googleMapsUri": {
+"description": "A link to show the review on Google Maps.",
+"type": "string"
+},
+"relativePublishTimeDescription": {
+"description": "A string of formatted recent time, expressing the review time relative to the current time in a form appropriate for the language and country.",
+"type": "string"
+},
+"review": {
+"description": "A reference representing this place review which may be used to look up this place review again.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudAiplatformV1beta1GroundingChunkRetrievedContext": {
 "description": "Chunk from context retrieved by the retrieval tools.",
 "id": "GoogleCloudAiplatformV1beta1GroundingChunkRetrievedContext",
@@ -2303,10 +2371,6 @@ false
 "$ref": "GoogleCloudAiplatformV1beta1ToolCodeExecution",
 "description": "Optional. CodeExecution tool type. Enables the model to execute code as part of generation."
 },
-"computerUse": {
-"$ref": "GoogleCloudAiplatformV1beta1ToolComputerUse",
-"description": "Optional. Tool to support the model interacting directly with the computer. If enabled, it automatically populates computer-use specific Function Declarations."
-},
 "enterpriseWebSearch": {
 "$ref": "GoogleCloudAiplatformV1beta1EnterpriseWebSearch",
 "description": "Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance."
@@ -2347,25 +2411,6 @@ false
 "properties": {},
 "type": "object"
 },
-"GoogleCloudAiplatformV1beta1ToolComputerUse": {
-"description": "Tool to support computer use.",
-"id": "GoogleCloudAiplatformV1beta1ToolComputerUse",
-"properties": {
-"environment": {
-"description": "Required. The environment being operated.",
-"enum": [
-"ENVIRONMENT_UNSPECIFIED",
-"ENVIRONMENT_BROWSER"
-],
-"enumDescriptions": [
-"Defaults to browser.",
-"Operates in a web browser."
-],
-"type": "string"
-}
-},
-"type": "object"
-},
 "GoogleCloudAiplatformV1beta1ToolConfig": {
 "description": "Tool config. This config is shared for all tools provided in the request.",
 "id": "GoogleCloudAiplatformV1beta1ToolConfig",
@@ -2548,6 +2593,11 @@ false
 "format": "google-duration",
 "type": "string"
 },
+"fps": {
+"description": "Optional. The frame rate of the video sent to the model. If not specified, the default value will be 1.0. The fps range is (0.0, 24.0].",
+"format": "double",
+"type": "number"
+},
 "startOffset": {
 "description": "Optional. The start offset of the video.",
 "format": "google-duration",

From d3cb250280a3df42670d1feb4639dac6e62d938d Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:12 +0000
Subject: [PATCH 15/36] feat(iam): update the api

#### iam:v1

The following keys were added:
- resources.locations.resources.workforcePools.resources.providers.resources.scimTenants.methods.create (Total Keys: 14)
- resources.locations.resources.workforcePools.resources.providers.resources.scimTenants.methods.delete (Total Keys: 11)
- resources.locations.resources.workforcePools.resources.providers.resources.scimTenants.methods.get (Total Keys: 11)
- resources.locations.resources.workforcePools.resources.providers.resources.scimTenants.methods.list (Total Keys: 18)
- resources.locations.resources.workforcePools.resources.providers.resources.scimTenants.methods.patch (Total Keys: 15)
- resources.locations.resources.workforcePools.resources.providers.resources.scimTenants.methods.undelete (Total Keys: 12)
- resources.locations.resources.workforcePools.resources.providers.resources.scimTenants.resources.tokens.methods.create (Total Keys: 14)
- resources.locations.resources.workforcePools.resources.providers.resources.scimTenants.resources.tokens.methods.delete (Total Keys: 11)
- resources.locations.resources.workforcePools.resources.providers.resources.scimTenants.resources.tokens.methods.get (Total Keys: 11)
- resources.locations.resources.workforcePools.resources.providers.resources.scimTenants.resources.tokens.methods.list (Total Keys: 18)
- resources.locations.resources.workforcePools.resources.providers.resources.scimTenants.resources.tokens.methods.patch (Total Keys: 15)
- resources.locations.resources.workforcePools.resources.providers.resources.scimTenants.resources.tokens.methods.undelete (Total Keys: 12)
- schemas.ListWorkforcePoolProviderScimTenantsResponse (Total Keys: 6)
- schemas.ListWorkforcePoolProviderScimTokensResponse (Total Keys: 6)
- schemas.UndeleteWorkforcePoolProviderScimTenantRequest (Total Keys: 2)
- schemas.UndeleteWorkforcePoolProviderScimTokenRequest (Total Keys: 2)
- schemas.WorkforcePoolProvider.properties.extendedAttributesOauth2Client.$ref (Total Keys: 1)
- schemas.WorkforcePoolProviderScimTenant (Total Keys: 13)
- schemas.WorkforcePoolProviderScimToken (Total Keys: 8)
---
 ...v1.locations.workforcePools.providers.html |  61 ++
 ....workforcePools.providers.scimTenants.html | 334 +++++++++++
 ...rcePools.providers.scimTenants.tokens.html | 289 ++++++++++
 .../discovery_cache/documents/iam.v1.json     | 525 +++++++++++++++++-
 4 files changed, 1208 insertions(+), 1 deletion(-)
 create mode 100644 docs/dyn/iam_v1.locations.workforcePools.providers.scimTenants.html
 create mode 100644 docs/dyn/iam_v1.locations.workforcePools.providers.scimTenants.tokens.html

diff --git a/docs/dyn/iam_v1.locations.workforcePools.providers.html b/docs/dyn/iam_v1.locations.workforcePools.providers.html
index 197325254f1..cfeaf3885ad 100644
--- a/docs/dyn/iam_v1.locations.workforcePools.providers.html
+++ b/docs/dyn/iam_v1.locations.workforcePools.providers.html
@@ -84,6 +84,11 @@ 
Instance Methods

 

 
Returns the operations Resource.

 
+

+  scimTenants()
+

+
Returns the scimTenants Resource.

+
 

   close()

 
Close httplib2 connections.

@@ -133,6 +138,20 @@ 
Method Details

   "disabled": True or False, # Optional. Disables the workforce pool provider. You cannot use a disabled provider to exchange tokens. However, existing tokens still grant access.
   "displayName": "A String", # Optional. A user-specified display name for the provider. Cannot exceed 32 characters.
   "expireTime": "A String", # Output only. Time after which the workload pool provider will be permanently purged and cannot be recovered.
+  "extendedAttributesOauth2Client": { # Represents the OAuth 2.0 client credential configuration for retrieving additional user attributes that are not present in the initial authentication credentials from the identity provider, e.g. groups. See https://datatracker.ietf.org/doc/html/rfc6749#section-4.4 for more details on client credentials grant flow. # Optional. The configuration for OAuth 2.0 client used to get the extended group memberships for user identities. Only the `AZURE_AD_GROUPS_ID` attribute type is supported. Extended groups supports a subset of Google Cloud services. When the user accesses these services, extended group memberships override the mapped `google.groups` attribute. Extended group memberships cannot be used in attribute mapping or attribute condition expressions. To keep extended group memberships up to date, extended groups are retrieved when the user signs in and at regular intervals during the user's active session. Each user identity in the workforce identity pool must map to a specific, unique Microsoft Entra ID user.
+    "attributesType": "A String", # Required. Represents the IdP and type of claims that should be fetched.
+    "clientId": "A String", # Required. The OAuth 2.0 client ID for retrieving extra attributes from the identity provider. Required to get the Access Token using client credentials grant flow.
+    "clientSecret": { # Representation of a client secret configured for the OIDC provider. # Required. The OAuth 2.0 client secret for retrieving extra attributes from the identity provider. Required to get the Access Token using client credentials grant flow.
+      "value": { # Representation of the value of the client secret. # The value of the client secret.
+        "plainText": "A String", # Optional. Input only. The plain text of the client secret value. For security reasons, this field is only used for input and will never be populated in any response.
+        "thumbprint": "A String", # Output only. A thumbprint to represent the current client secret value.
+      },
+    },
+    "issuerUri": "A String", # Required. The OIDC identity provider's issuer URI. Must be a valid URI using the `https` scheme. Required to get the OIDC discovery document.
+    "queryParameters": { # Represents the parameters to control which claims are fetched from an IdP. # Optional. Represents the parameters to control which claims are fetched from an IdP.
+      "filter": "A String", # Optional. The filter used to request specific records from the IdP. By default, all of the groups that are associated with a user are fetched. For Microsoft Entra ID, you can add `$search` query parameters using [Keyword Query Language] (https://learn.microsoft.com/en-us/sharepoint/dev/general-development/keyword-query-language-kql-syntax-reference). To learn more about `$search` querying in Microsoft Entra ID, see [Use the `$search` query parameter] (https://learn.microsoft.com/en-us/graph/search-query-parameter). Additionally, Workforce Identity Federation automatically adds the following [`$filter` query parameters] (https://learn.microsoft.com/en-us/graph/filter-query-parameter), based on the value of `attributes_type`. Values passed to `filter` are converted to `$search` query parameters. Additional `$filter` query parameters cannot be added using this field. * `AZURE_AD_GROUPS_MAIL`: `mailEnabled` and `securityEnabled` filters are applied. * `AZURE_AD_GROUPS_ID`: `securityEnabled` filter is applied.
+    },
+  },
   "extraAttributesOauth2Client": { # Represents the OAuth 2.0 client credential configuration for retrieving additional user attributes that are not present in the initial authentication credentials from the identity provider, e.g. groups. See https://datatracker.ietf.org/doc/html/rfc6749#section-4.4 for more details on client credentials grant flow. # Optional. The configuration for OAuth 2.0 client used to get the additional user attributes. This should be used when users can't get the desired claims in authentication credentials. Currently this configuration is only supported with OIDC protocol.
     "attributesType": "A String", # Required. Represents the IdP and type of claims that should be fetched.
     "clientId": "A String", # Required. The OAuth 2.0 client ID for retrieving extra attributes from the identity provider. Required to get the Access Token using client credentials grant flow.
@@ -261,6 +280,20 @@ 
Method Details

   "disabled": True or False, # Optional. Disables the workforce pool provider. You cannot use a disabled provider to exchange tokens. However, existing tokens still grant access.
   "displayName": "A String", # Optional. A user-specified display name for the provider. Cannot exceed 32 characters.
   "expireTime": "A String", # Output only. Time after which the workload pool provider will be permanently purged and cannot be recovered.
+  "extendedAttributesOauth2Client": { # Represents the OAuth 2.0 client credential configuration for retrieving additional user attributes that are not present in the initial authentication credentials from the identity provider, e.g. groups. See https://datatracker.ietf.org/doc/html/rfc6749#section-4.4 for more details on client credentials grant flow. # Optional. The configuration for OAuth 2.0 client used to get the extended group memberships for user identities. Only the `AZURE_AD_GROUPS_ID` attribute type is supported. Extended groups supports a subset of Google Cloud services. When the user accesses these services, extended group memberships override the mapped `google.groups` attribute. Extended group memberships cannot be used in attribute mapping or attribute condition expressions. To keep extended group memberships up to date, extended groups are retrieved when the user signs in and at regular intervals during the user's active session. Each user identity in the workforce identity pool must map to a specific, unique Microsoft Entra ID user.
+    "attributesType": "A String", # Required. Represents the IdP and type of claims that should be fetched.
+    "clientId": "A String", # Required. The OAuth 2.0 client ID for retrieving extra attributes from the identity provider. Required to get the Access Token using client credentials grant flow.
+    "clientSecret": { # Representation of a client secret configured for the OIDC provider. # Required. The OAuth 2.0 client secret for retrieving extra attributes from the identity provider. Required to get the Access Token using client credentials grant flow.
+      "value": { # Representation of the value of the client secret. # The value of the client secret.
+        "plainText": "A String", # Optional. Input only. The plain text of the client secret value. For security reasons, this field is only used for input and will never be populated in any response.
+        "thumbprint": "A String", # Output only. A thumbprint to represent the current client secret value.
+      },
+    },
+    "issuerUri": "A String", # Required. The OIDC identity provider's issuer URI. Must be a valid URI using the `https` scheme. Required to get the OIDC discovery document.
+    "queryParameters": { # Represents the parameters to control which claims are fetched from an IdP. # Optional. Represents the parameters to control which claims are fetched from an IdP.
+      "filter": "A String", # Optional. The filter used to request specific records from the IdP. By default, all of the groups that are associated with a user are fetched. For Microsoft Entra ID, you can add `$search` query parameters using [Keyword Query Language] (https://learn.microsoft.com/en-us/sharepoint/dev/general-development/keyword-query-language-kql-syntax-reference). To learn more about `$search` querying in Microsoft Entra ID, see [Use the `$search` query parameter] (https://learn.microsoft.com/en-us/graph/search-query-parameter). Additionally, Workforce Identity Federation automatically adds the following [`$filter` query parameters] (https://learn.microsoft.com/en-us/graph/filter-query-parameter), based on the value of `attributes_type`. Values passed to `filter` are converted to `$search` query parameters. Additional `$filter` query parameters cannot be added using this field. * `AZURE_AD_GROUPS_MAIL`: `mailEnabled` and `securityEnabled` filters are applied. * `AZURE_AD_GROUPS_ID`: `securityEnabled` filter is applied.
+    },
+  },
   "extraAttributesOauth2Client": { # Represents the OAuth 2.0 client credential configuration for retrieving additional user attributes that are not present in the initial authentication credentials from the identity provider, e.g. groups. See https://datatracker.ietf.org/doc/html/rfc6749#section-4.4 for more details on client credentials grant flow. # Optional. The configuration for OAuth 2.0 client used to get the additional user attributes. This should be used when users can't get the desired claims in authentication credentials. Currently this configuration is only supported with OIDC protocol.
     "attributesType": "A String", # Required. Represents the IdP and type of claims that should be fetched.
     "clientId": "A String", # Required. The OAuth 2.0 client ID for retrieving extra attributes from the identity provider. Required to get the Access Token using client credentials grant flow.
@@ -331,6 +364,20 @@ 
Method Details

       "disabled": True or False, # Optional. Disables the workforce pool provider. You cannot use a disabled provider to exchange tokens. However, existing tokens still grant access.
       "displayName": "A String", # Optional. A user-specified display name for the provider. Cannot exceed 32 characters.
       "expireTime": "A String", # Output only. Time after which the workload pool provider will be permanently purged and cannot be recovered.
+      "extendedAttributesOauth2Client": { # Represents the OAuth 2.0 client credential configuration for retrieving additional user attributes that are not present in the initial authentication credentials from the identity provider, e.g. groups. See https://datatracker.ietf.org/doc/html/rfc6749#section-4.4 for more details on client credentials grant flow. # Optional. The configuration for OAuth 2.0 client used to get the extended group memberships for user identities. Only the `AZURE_AD_GROUPS_ID` attribute type is supported. Extended groups supports a subset of Google Cloud services. When the user accesses these services, extended group memberships override the mapped `google.groups` attribute. Extended group memberships cannot be used in attribute mapping or attribute condition expressions. To keep extended group memberships up to date, extended groups are retrieved when the user signs in and at regular intervals during the user's active session. Each user identity in the workforce identity pool must map to a specific, unique Microsoft Entra ID user.
+        "attributesType": "A String", # Required. Represents the IdP and type of claims that should be fetched.
+        "clientId": "A String", # Required. The OAuth 2.0 client ID for retrieving extra attributes from the identity provider. Required to get the Access Token using client credentials grant flow.
+        "clientSecret": { # Representation of a client secret configured for the OIDC provider. # Required. The OAuth 2.0 client secret for retrieving extra attributes from the identity provider. Required to get the Access Token using client credentials grant flow.
+          "value": { # Representation of the value of the client secret. # The value of the client secret.
+            "plainText": "A String", # Optional. Input only. The plain text of the client secret value. For security reasons, this field is only used for input and will never be populated in any response.
+            "thumbprint": "A String", # Output only. A thumbprint to represent the current client secret value.
+          },
+        },
+        "issuerUri": "A String", # Required. The OIDC identity provider's issuer URI. Must be a valid URI using the `https` scheme. Required to get the OIDC discovery document.
+        "queryParameters": { # Represents the parameters to control which claims are fetched from an IdP. # Optional. Represents the parameters to control which claims are fetched from an IdP.
+          "filter": "A String", # Optional. The filter used to request specific records from the IdP. By default, all of the groups that are associated with a user are fetched. For Microsoft Entra ID, you can add `$search` query parameters using [Keyword Query Language] (https://learn.microsoft.com/en-us/sharepoint/dev/general-development/keyword-query-language-kql-syntax-reference). To learn more about `$search` querying in Microsoft Entra ID, see [Use the `$search` query parameter] (https://learn.microsoft.com/en-us/graph/search-query-parameter). Additionally, Workforce Identity Federation automatically adds the following [`$filter` query parameters] (https://learn.microsoft.com/en-us/graph/filter-query-parameter), based on the value of `attributes_type`. Values passed to `filter` are converted to `$search` query parameters. Additional `$filter` query parameters cannot be added using this field. * `AZURE_AD_GROUPS_MAIL`: `mailEnabled` and `securityEnabled` filters are applied. * `AZURE_AD_GROUPS_ID`: `securityEnabled` filter is applied.
+        },
+      },
       "extraAttributesOauth2Client": { # Represents the OAuth 2.0 client credential configuration for retrieving additional user attributes that are not present in the initial authentication credentials from the identity provider, e.g. groups. See https://datatracker.ietf.org/doc/html/rfc6749#section-4.4 for more details on client credentials grant flow. # Optional. The configuration for OAuth 2.0 client used to get the additional user attributes. This should be used when users can't get the desired claims in authentication credentials. Currently this configuration is only supported with OIDC protocol.
         "attributesType": "A String", # Required. Represents the IdP and type of claims that should be fetched.
         "clientId": "A String", # Required. The OAuth 2.0 client ID for retrieving extra attributes from the identity provider. Required to get the Access Token using client credentials grant flow.
@@ -406,6 +453,20 @@ 
Method Details

   "disabled": True or False, # Optional. Disables the workforce pool provider. You cannot use a disabled provider to exchange tokens. However, existing tokens still grant access.
   "displayName": "A String", # Optional. A user-specified display name for the provider. Cannot exceed 32 characters.
   "expireTime": "A String", # Output only. Time after which the workload pool provider will be permanently purged and cannot be recovered.
+  "extendedAttributesOauth2Client": { # Represents the OAuth 2.0 client credential configuration for retrieving additional user attributes that are not present in the initial authentication credentials from the identity provider, e.g. groups. See https://datatracker.ietf.org/doc/html/rfc6749#section-4.4 for more details on client credentials grant flow. # Optional. The configuration for OAuth 2.0 client used to get the extended group memberships for user identities. Only the `AZURE_AD_GROUPS_ID` attribute type is supported. Extended groups supports a subset of Google Cloud services. When the user accesses these services, extended group memberships override the mapped `google.groups` attribute. Extended group memberships cannot be used in attribute mapping or attribute condition expressions. To keep extended group memberships up to date, extended groups are retrieved when the user signs in and at regular intervals during the user's active session. Each user identity in the workforce identity pool must map to a specific, unique Microsoft Entra ID user.
+    "attributesType": "A String", # Required. Represents the IdP and type of claims that should be fetched.
+    "clientId": "A String", # Required. The OAuth 2.0 client ID for retrieving extra attributes from the identity provider. Required to get the Access Token using client credentials grant flow.
+    "clientSecret": { # Representation of a client secret configured for the OIDC provider. # Required. The OAuth 2.0 client secret for retrieving extra attributes from the identity provider. Required to get the Access Token using client credentials grant flow.
+      "value": { # Representation of the value of the client secret. # The value of the client secret.
+        "plainText": "A String", # Optional. Input only. The plain text of the client secret value. For security reasons, this field is only used for input and will never be populated in any response.
+        "thumbprint": "A String", # Output only. A thumbprint to represent the current client secret value.
+      },
+    },
+    "issuerUri": "A String", # Required. The OIDC identity provider's issuer URI. Must be a valid URI using the `https` scheme. Required to get the OIDC discovery document.
+    "queryParameters": { # Represents the parameters to control which claims are fetched from an IdP. # Optional. Represents the parameters to control which claims are fetched from an IdP.
+      "filter": "A String", # Optional. The filter used to request specific records from the IdP. By default, all of the groups that are associated with a user are fetched. For Microsoft Entra ID, you can add `$search` query parameters using [Keyword Query Language] (https://learn.microsoft.com/en-us/sharepoint/dev/general-development/keyword-query-language-kql-syntax-reference). To learn more about `$search` querying in Microsoft Entra ID, see [Use the `$search` query parameter] (https://learn.microsoft.com/en-us/graph/search-query-parameter). Additionally, Workforce Identity Federation automatically adds the following [`$filter` query parameters] (https://learn.microsoft.com/en-us/graph/filter-query-parameter), based on the value of `attributes_type`. Values passed to `filter` are converted to `$search` query parameters. Additional `$filter` query parameters cannot be added using this field. * `AZURE_AD_GROUPS_MAIL`: `mailEnabled` and `securityEnabled` filters are applied. * `AZURE_AD_GROUPS_ID`: `securityEnabled` filter is applied.
+    },
+  },
   "extraAttributesOauth2Client": { # Represents the OAuth 2.0 client credential configuration for retrieving additional user attributes that are not present in the initial authentication credentials from the identity provider, e.g. groups. See https://datatracker.ietf.org/doc/html/rfc6749#section-4.4 for more details on client credentials grant flow. # Optional. The configuration for OAuth 2.0 client used to get the additional user attributes. This should be used when users can't get the desired claims in authentication credentials. Currently this configuration is only supported with OIDC protocol.
     "attributesType": "A String", # Required. Represents the IdP and type of claims that should be fetched.
     "clientId": "A String", # Required. The OAuth 2.0 client ID for retrieving extra attributes from the identity provider. Required to get the Access Token using client credentials grant flow.
diff --git a/docs/dyn/iam_v1.locations.workforcePools.providers.scimTenants.html b/docs/dyn/iam_v1.locations.workforcePools.providers.scimTenants.html
new file mode 100644
index 00000000000..39c34bb96e5
--- /dev/null
+++ b/docs/dyn/iam_v1.locations.workforcePools.providers.scimTenants.html
@@ -0,0 +1,334 @@
+
+
+
+
Identity and Access Management (IAM) API . locations . workforcePools . providers . scimTenants

+
Instance Methods

+

+  tokens()
+

+
Returns the tokens Resource.

+
+

+  close()

+
Close httplib2 connections.

+

+  create(parent, body=None, workforcePoolProviderScimTenantId=None, x__xgafv=None)

+
Creates a new WorkforcePoolProviderScimTenant in a WorkforcePoolProvider. You cannot reuse the name of a deleted scim tenant until 30 days after deletion.

+

+  delete(name, x__xgafv=None)

+
Deletes a WorkforcePoolProviderScimTenant. You can undelete a scim tenant for 30 days. After 30 days, deletion is permanent. You cannot update deleted scim tenants. However, you can view and list them.

+

+  get(name, x__xgafv=None)

+
Gets an individual WorkforcePoolProviderScimTenant.

+

+  list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

+
Lists all non-deleted WorkforcePoolProviderScimTenants in a WorkforcePoolProvider. If `show_deleted` is set to `true`, then deleted scim tenants are also listed.

+

+  list_next()

+
Retrieves the next page of results.

+

+  patch(name, body=None, updateMask=None, x__xgafv=None)

+
Updates an existing WorkforcePoolProviderScimTenant.

+

+  undelete(name, body=None, x__xgafv=None)

+
Undeletes a WorkforcePoolProviderScimTenant, as long as it was deleted fewer than 30 days ago.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    create(parent, body=None, workforcePoolProviderScimTenantId=None, x__xgafv=None)
+  
Creates a new WorkforcePoolProviderScimTenant in a WorkforcePoolProvider. You cannot reuse the name of a deleted scim tenant until 30 days after deletion.
+
+Args:
+  parent: string, Required. The parent to create scim tenant. Format: 'locations/{location}/workforcePools/{workforce_pool}/providers/{provider}' (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a scim tenant. Used for provisioning and managing identity data (such as Users and Groups) in cross-domain environments.
+  "baseUri": "A String", # Output only. Represents the base URI as defined in [RFC 7644, Section 1.3](https://datatracker.ietf.org/doc/html/rfc7644#section-1.3). Clients must use this as the root address for managing resources under the tenant. Format: https://iamscim.googleapis.com/{version}/{tenant_id}/
+  "claimMapping": { # Optional. Maps BYOID claims to SCIM claims.
+    "a_key": "A String",
+  },
+  "description": "A String", # Optional. The user-specified description of the scim tenant. Cannot exceed 256 characters.
+  "displayName": "A String", # Optional. The user-specified display name of the scim tenant. Cannot exceed 32 characters.
+  "name": "A String", # Identifier. The resource name of the SCIM Tenant. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}`
+  "purgeTime": "A String", # Output only. The timestamp when the scim tenant is going to be purged.
+  "state": "A String", # Output only. The state of the tenant.
+}
+
+  workforcePoolProviderScimTenantId: string, Required. The ID to use for the scim tenant, which becomes the final component of the resource name. This value should be 4-32 characters, and may contain the characters [a-z0-9-].
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a scim tenant. Used for provisioning and managing identity data (such as Users and Groups) in cross-domain environments.
+  "baseUri": "A String", # Output only. Represents the base URI as defined in [RFC 7644, Section 1.3](https://datatracker.ietf.org/doc/html/rfc7644#section-1.3). Clients must use this as the root address for managing resources under the tenant. Format: https://iamscim.googleapis.com/{version}/{tenant_id}/
+  "claimMapping": { # Optional. Maps BYOID claims to SCIM claims.
+    "a_key": "A String",
+  },
+  "description": "A String", # Optional. The user-specified description of the scim tenant. Cannot exceed 256 characters.
+  "displayName": "A String", # Optional. The user-specified display name of the scim tenant. Cannot exceed 32 characters.
+  "name": "A String", # Identifier. The resource name of the SCIM Tenant. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}`
+  "purgeTime": "A String", # Output only. The timestamp when the scim tenant is going to be purged.
+  "state": "A String", # Output only. The state of the tenant.
+}

+

+
+

+    delete(name, x__xgafv=None)
+  
Deletes a WorkforcePoolProviderScimTenant. You can undelete a scim tenant for 30 days. After 30 days, deletion is permanent. You cannot update deleted scim tenants. However, you can view and list them.
+
+Args:
+  name: string, Required. The name of the scim tenant to delete. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/{provider}/scimTenants/{scim_tenant}` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a scim tenant. Used for provisioning and managing identity data (such as Users and Groups) in cross-domain environments.
+  "baseUri": "A String", # Output only. Represents the base URI as defined in [RFC 7644, Section 1.3](https://datatracker.ietf.org/doc/html/rfc7644#section-1.3). Clients must use this as the root address for managing resources under the tenant. Format: https://iamscim.googleapis.com/{version}/{tenant_id}/
+  "claimMapping": { # Optional. Maps BYOID claims to SCIM claims.
+    "a_key": "A String",
+  },
+  "description": "A String", # Optional. The user-specified description of the scim tenant. Cannot exceed 256 characters.
+  "displayName": "A String", # Optional. The user-specified display name of the scim tenant. Cannot exceed 32 characters.
+  "name": "A String", # Identifier. The resource name of the SCIM Tenant. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}`
+  "purgeTime": "A String", # Output only. The timestamp when the scim tenant is going to be purged.
+  "state": "A String", # Output only. The state of the tenant.
+}

+

+
+

+    get(name, x__xgafv=None)
+  
Gets an individual WorkforcePoolProviderScimTenant.
+
+Args:
+  name: string, Required. The name of the scim tenant to retrieve. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/{provider}/scimTenants/{scim_tenant}` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a scim tenant. Used for provisioning and managing identity data (such as Users and Groups) in cross-domain environments.
+  "baseUri": "A String", # Output only. Represents the base URI as defined in [RFC 7644, Section 1.3](https://datatracker.ietf.org/doc/html/rfc7644#section-1.3). Clients must use this as the root address for managing resources under the tenant. Format: https://iamscim.googleapis.com/{version}/{tenant_id}/
+  "claimMapping": { # Optional. Maps BYOID claims to SCIM claims.
+    "a_key": "A String",
+  },
+  "description": "A String", # Optional. The user-specified description of the scim tenant. Cannot exceed 256 characters.
+  "displayName": "A String", # Optional. The user-specified display name of the scim tenant. Cannot exceed 32 characters.
+  "name": "A String", # Identifier. The resource name of the SCIM Tenant. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}`
+  "purgeTime": "A String", # Output only. The timestamp when the scim tenant is going to be purged.
+  "state": "A String", # Output only. The state of the tenant.
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)
+  
Lists all non-deleted WorkforcePoolProviderScimTenants in a WorkforcePoolProvider. If `show_deleted` is set to `true`, then deleted scim tenants are also listed.
+
+Args:
+  parent: string, Required. The parent to list scim tenants. Format: 'locations/{location}/workforcePools/{workforce_pool}/providers/{provider}' (required)
+  pageSize: integer, Optional. The maximum number of scim tenants to return. If unspecified, at most 1 scim tenant will be returned.
+  pageToken: string, Optional. A page token, received from a previous `ListScimTenants` call. Provide this to retrieve the subsequent page.
+  showDeleted: boolean, Optional. Whether to return soft-deleted scim tenants.
+  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 ListWorkforcePoolProviderScimTenants.
+  "nextPageToken": "A String", # Optional. A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+  "workforcePoolProviderScimTenants": [ # Output only. A list of scim tenants.
+    { # Represents a scim tenant. Used for provisioning and managing identity data (such as Users and Groups) in cross-domain environments.
+      "baseUri": "A String", # Output only. Represents the base URI as defined in [RFC 7644, Section 1.3](https://datatracker.ietf.org/doc/html/rfc7644#section-1.3). Clients must use this as the root address for managing resources under the tenant. Format: https://iamscim.googleapis.com/{version}/{tenant_id}/
+      "claimMapping": { # Optional. Maps BYOID claims to SCIM claims.
+        "a_key": "A String",
+      },
+      "description": "A String", # Optional. The user-specified description of the scim tenant. Cannot exceed 256 characters.
+      "displayName": "A String", # Optional. The user-specified display name of the scim tenant. Cannot exceed 32 characters.
+      "name": "A String", # Identifier. The resource name of the SCIM Tenant. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}`
+      "purgeTime": "A String", # Output only. The timestamp when the scim tenant is going to be purged.
+      "state": "A String", # Output only. The state of the tenant.
+    },
+  ],
+}

+

+
+

+    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 an existing WorkforcePoolProviderScimTenant.
+
+Args:
+  name: string, Identifier. The resource name of the SCIM Tenant. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a scim tenant. Used for provisioning and managing identity data (such as Users and Groups) in cross-domain environments.
+  "baseUri": "A String", # Output only. Represents the base URI as defined in [RFC 7644, Section 1.3](https://datatracker.ietf.org/doc/html/rfc7644#section-1.3). Clients must use this as the root address for managing resources under the tenant. Format: https://iamscim.googleapis.com/{version}/{tenant_id}/
+  "claimMapping": { # Optional. Maps BYOID claims to SCIM claims.
+    "a_key": "A String",
+  },
+  "description": "A String", # Optional. The user-specified description of the scim tenant. Cannot exceed 256 characters.
+  "displayName": "A String", # Optional. The user-specified display name of the scim tenant. Cannot exceed 32 characters.
+  "name": "A String", # Identifier. The resource name of the SCIM Tenant. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}`
+  "purgeTime": "A String", # Output only. The timestamp when the scim tenant is going to be purged.
+  "state": "A String", # Output only. The state of the tenant.
+}
+
+  updateMask: string, Optional. The list of fields to update.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a scim tenant. Used for provisioning and managing identity data (such as Users and Groups) in cross-domain environments.
+  "baseUri": "A String", # Output only. Represents the base URI as defined in [RFC 7644, Section 1.3](https://datatracker.ietf.org/doc/html/rfc7644#section-1.3). Clients must use this as the root address for managing resources under the tenant. Format: https://iamscim.googleapis.com/{version}/{tenant_id}/
+  "claimMapping": { # Optional. Maps BYOID claims to SCIM claims.
+    "a_key": "A String",
+  },
+  "description": "A String", # Optional. The user-specified description of the scim tenant. Cannot exceed 256 characters.
+  "displayName": "A String", # Optional. The user-specified display name of the scim tenant. Cannot exceed 32 characters.
+  "name": "A String", # Identifier. The resource name of the SCIM Tenant. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}`
+  "purgeTime": "A String", # Output only. The timestamp when the scim tenant is going to be purged.
+  "state": "A String", # Output only. The state of the tenant.
+}

+

+
+

+    undelete(name, body=None, x__xgafv=None)
+  
Undeletes a WorkforcePoolProviderScimTenant, as long as it was deleted fewer than 30 days ago.
+
+Args:
+  name: string, Required. The name of the scim tenant to undelete. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/{provider}/scimTenants/{scim_tenant}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for UndeleteWorkforcePoolProviderScimTenant.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a scim tenant. Used for provisioning and managing identity data (such as Users and Groups) in cross-domain environments.
+  "baseUri": "A String", # Output only. Represents the base URI as defined in [RFC 7644, Section 1.3](https://datatracker.ietf.org/doc/html/rfc7644#section-1.3). Clients must use this as the root address for managing resources under the tenant. Format: https://iamscim.googleapis.com/{version}/{tenant_id}/
+  "claimMapping": { # Optional. Maps BYOID claims to SCIM claims.
+    "a_key": "A String",
+  },
+  "description": "A String", # Optional. The user-specified description of the scim tenant. Cannot exceed 256 characters.
+  "displayName": "A String", # Optional. The user-specified display name of the scim tenant. Cannot exceed 32 characters.
+  "name": "A String", # Identifier. The resource name of the SCIM Tenant. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}`
+  "purgeTime": "A String", # Output only. The timestamp when the scim tenant is going to be purged.
+  "state": "A String", # Output only. The state of the tenant.
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/iam_v1.locations.workforcePools.providers.scimTenants.tokens.html b/docs/dyn/iam_v1.locations.workforcePools.providers.scimTenants.tokens.html
new file mode 100644
index 00000000000..514fa58d866
--- /dev/null
+++ b/docs/dyn/iam_v1.locations.workforcePools.providers.scimTenants.tokens.html
@@ -0,0 +1,289 @@
+
+
+
+
Identity and Access Management (IAM) API . locations . workforcePools . providers . scimTenants . tokens

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  create(parent, body=None, workforcePoolProviderScimTokenId=None, x__xgafv=None)

+
Creates a new WorkforcePoolProviderScimToken in a WorkforcePoolProviderScimTenant. You cannot reuse the name of a deleted SCIM token until 30 days after deletion.

+

+  delete(name, x__xgafv=None)

+
Deletes a WorkforcePoolProviderScimToken. You can undelete a scim token for 30 days. After 30 days, deletion is permanent. You cannot update deleted scim tokens. However, you can view and list them.

+

+  get(name, x__xgafv=None)

+
Gets an individual WorkforcePoolProviderScimToken.

+

+  list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)

+
Lists all non-deleted WorkforcePoolProviderScimTokenss in a WorkforcePoolProviderScimTenant. If `show_deleted` is set to `true`, then deleted SCIM tokens are also listed.

+

+  list_next()

+
Retrieves the next page of results.

+

+  patch(name, body=None, updateMask=None, x__xgafv=None)

+
Updates an existing WorkforcePoolProviderScimToken.

+

+  undelete(name, body=None, x__xgafv=None)

+
Undeletes a WorkforcePoolProviderScimToken, as long as it was deleted fewer than 30 days ago.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    create(parent, body=None, workforcePoolProviderScimTokenId=None, x__xgafv=None)
+  
Creates a new WorkforcePoolProviderScimToken in a WorkforcePoolProviderScimTenant. You cannot reuse the name of a deleted SCIM token until 30 days after deletion.
+
+Args:
+  parent: string, Required. The parent tenant to create scim token. Format: 'locations/{location}/workforcePools/{workforce_pool}/providers/{provider}/scimTenants/{scim_tenant}' (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a token for the WorkforcePoolProviderScimTenant. Used for authenticating SCIM Provisioning requests.
+  "displayName": "A String", # Optional. The user-specified display name of the scim token. Cannot exceed 32 characters.
+  "name": "A String", # Identifier. The resource name of the SCIM Token. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}/tokens/{token}`
+  "securityToken": "A String", # Output only. The token string. Provide this to the IdP for authentication. Will be set only during creation.
+  "state": "A String", # Output only. The state of the token.
+}
+
+  workforcePoolProviderScimTokenId: string, Required. The ID to use for the scim token, which becomes the final component of the resource name. This value should be 4-32 characters and follow this pattern: "([a-z]([a-z0-9\\-]{2,30}[a-z0-9]))"
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a token for the WorkforcePoolProviderScimTenant. Used for authenticating SCIM Provisioning requests.
+  "displayName": "A String", # Optional. The user-specified display name of the scim token. Cannot exceed 32 characters.
+  "name": "A String", # Identifier. The resource name of the SCIM Token. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}/tokens/{token}`
+  "securityToken": "A String", # Output only. The token string. Provide this to the IdP for authentication. Will be set only during creation.
+  "state": "A String", # Output only. The state of the token.
+}

+

+
+

+    delete(name, x__xgafv=None)
+  
Deletes a WorkforcePoolProviderScimToken. You can undelete a scim token for 30 days. After 30 days, deletion is permanent. You cannot update deleted scim tokens. However, you can view and list them.
+
+Args:
+  name: string, Required. The name of the scim token to delete. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/{provider}/scimTenants/{scim_tenant}/tokens/{token}` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a token for the WorkforcePoolProviderScimTenant. Used for authenticating SCIM Provisioning requests.
+  "displayName": "A String", # Optional. The user-specified display name of the scim token. Cannot exceed 32 characters.
+  "name": "A String", # Identifier. The resource name of the SCIM Token. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}/tokens/{token}`
+  "securityToken": "A String", # Output only. The token string. Provide this to the IdP for authentication. Will be set only during creation.
+  "state": "A String", # Output only. The state of the token.
+}

+

+
+

+    get(name, x__xgafv=None)
+  
Gets an individual WorkforcePoolProviderScimToken.
+
+Args:
+  name: string, Required. The name of the scim token to retrieve. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/{provider}/scimTenants/{scim_tenant}/tokens/{token}` (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a token for the WorkforcePoolProviderScimTenant. Used for authenticating SCIM Provisioning requests.
+  "displayName": "A String", # Optional. The user-specified display name of the scim token. Cannot exceed 32 characters.
+  "name": "A String", # Identifier. The resource name of the SCIM Token. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}/tokens/{token}`
+  "securityToken": "A String", # Output only. The token string. Provide this to the IdP for authentication. Will be set only during creation.
+  "state": "A String", # Output only. The state of the token.
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, showDeleted=None, x__xgafv=None)
+  
Lists all non-deleted WorkforcePoolProviderScimTokenss in a WorkforcePoolProviderScimTenant. If `show_deleted` is set to `true`, then deleted SCIM tokens are also listed.
+
+Args:
+  parent: string, Required. The parent to list scim tokens. Format: 'locations/{location}/workforcePools/{workforce_pool}/providers/{provider}/scimTenants/{scim_tenant}' (required)
+  pageSize: integer, Optional. The maximum number of scim tokens to return. If unspecified, at most 2 scim tokens will be returned.
+  pageToken: string, Optional. A page token, received from a previous `ListWorkforcePoolProviderScimTokens` call. Provide this to retrieve the subsequent page.
+  showDeleted: boolean, Optional. Whether to return soft-deleted scim tokens.
+  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 ListWorkforcePoolProviderScimTokens.
+  "nextPageToken": "A String", # Optional. A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
+  "workforcePoolProviderScimTokens": [ # Output only. A list of scim tokens.
+    { # Represents a token for the WorkforcePoolProviderScimTenant. Used for authenticating SCIM Provisioning requests.
+      "displayName": "A String", # Optional. The user-specified display name of the scim token. Cannot exceed 32 characters.
+      "name": "A String", # Identifier. The resource name of the SCIM Token. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}/tokens/{token}`
+      "securityToken": "A String", # Output only. The token string. Provide this to the IdP for authentication. Will be set only during creation.
+      "state": "A String", # Output only. The state of the token.
+    },
+  ],
+}

+

+
+

+    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 an existing WorkforcePoolProviderScimToken.
+
+Args:
+  name: string, Identifier. The resource name of the SCIM Token. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}/tokens/{token}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Represents a token for the WorkforcePoolProviderScimTenant. Used for authenticating SCIM Provisioning requests.
+  "displayName": "A String", # Optional. The user-specified display name of the scim token. Cannot exceed 32 characters.
+  "name": "A String", # Identifier. The resource name of the SCIM Token. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}/tokens/{token}`
+  "securityToken": "A String", # Output only. The token string. Provide this to the IdP for authentication. Will be set only during creation.
+  "state": "A String", # Output only. The state of the token.
+}
+
+  updateMask: string, Optional. The list of fields to update.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a token for the WorkforcePoolProviderScimTenant. Used for authenticating SCIM Provisioning requests.
+  "displayName": "A String", # Optional. The user-specified display name of the scim token. Cannot exceed 32 characters.
+  "name": "A String", # Identifier. The resource name of the SCIM Token. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}/tokens/{token}`
+  "securityToken": "A String", # Output only. The token string. Provide this to the IdP for authentication. Will be set only during creation.
+  "state": "A String", # Output only. The state of the token.
+}

+

+
+

+    undelete(name, body=None, x__xgafv=None)
+  
Undeletes a WorkforcePoolProviderScimToken, as long as it was deleted fewer than 30 days ago.
+
+Args:
+  name: string, Required. The name of the scim token to undelete. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/{provider}/scimTenants/{scim_tenant}/tokens/{token}` (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request message for UndeleteWorkforcePoolProviderScimToken.
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a token for the WorkforcePoolProviderScimTenant. Used for authenticating SCIM Provisioning requests.
+  "displayName": "A String", # Optional. The user-specified display name of the scim token. Cannot exceed 32 characters.
+  "name": "A String", # Identifier. The resource name of the SCIM Token. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}/tokens/{token}`
+  "securityToken": "A String", # Output only. The token string. Provide this to the IdP for authentication. Will be set only during creation.
+  "state": "A String", # Output only. The state of the token.
+}

+

+
+
\ No newline at end of file
diff --git a/googleapiclient/discovery_cache/documents/iam.v1.json b/googleapiclient/discovery_cache/documents/iam.v1.json
index 8907fbe7e6c..301bff8cc7b 100644
--- a/googleapiclient/discovery_cache/documents/iam.v1.json
+++ b/googleapiclient/discovery_cache/documents/iam.v1.json
@@ -860,6 +860,388 @@
 ]
 }
 }
+},
+"scimTenants": {
+"methods": {
+"create": {
+"description": "Creates a new WorkforcePoolProviderScimTenant in a WorkforcePoolProvider. You cannot reuse the name of a deleted scim tenant until 30 days after deletion.",
+"flatPath": "v1/locations/{locationsId}/workforcePools/{workforcePoolsId}/providers/{providersId}/scimTenants",
+"httpMethod": "POST",
+"id": "iam.locations.workforcePools.providers.scimTenants.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The parent to create scim tenant. Format: 'locations/{location}/workforcePools/{workforce_pool}/providers/{provider}'",
+"location": "path",
+"pattern": "^locations/[^/]+/workforcePools/[^/]+/providers/[^/]+$",
+"required": true,
+"type": "string"
+},
+"workforcePoolProviderScimTenantId": {
+"description": "Required. The ID to use for the scim tenant, which becomes the final component of the resource name. This value should be 4-32 characters, and may contain the characters [a-z0-9-].",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1/{+parent}/scimTenants",
+"request": {
+"$ref": "WorkforcePoolProviderScimTenant"
+},
+"response": {
+"$ref": "WorkforcePoolProviderScimTenant"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"delete": {
+"description": "Deletes a WorkforcePoolProviderScimTenant. You can undelete a scim tenant for 30 days. After 30 days, deletion is permanent. You cannot update deleted scim tenants. However, you can view and list them.",
+"flatPath": "v1/locations/{locationsId}/workforcePools/{workforcePoolsId}/providers/{providersId}/scimTenants/{scimTenantsId}",
+"httpMethod": "DELETE",
+"id": "iam.locations.workforcePools.providers.scimTenants.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the scim tenant to delete. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/{provider}/scimTenants/{scim_tenant}`",
+"location": "path",
+"pattern": "^locations/[^/]+/workforcePools/[^/]+/providers/[^/]+/scimTenants/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"response": {
+"$ref": "WorkforcePoolProviderScimTenant"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"get": {
+"description": "Gets an individual WorkforcePoolProviderScimTenant.",
+"flatPath": "v1/locations/{locationsId}/workforcePools/{workforcePoolsId}/providers/{providersId}/scimTenants/{scimTenantsId}",
+"httpMethod": "GET",
+"id": "iam.locations.workforcePools.providers.scimTenants.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the scim tenant to retrieve. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/{provider}/scimTenants/{scim_tenant}`",
+"location": "path",
+"pattern": "^locations/[^/]+/workforcePools/[^/]+/providers/[^/]+/scimTenants/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"response": {
+"$ref": "WorkforcePoolProviderScimTenant"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists all non-deleted WorkforcePoolProviderScimTenants in a WorkforcePoolProvider. If `show_deleted` is set to `true`, then deleted scim tenants are also listed.",
+"flatPath": "v1/locations/{locationsId}/workforcePools/{workforcePoolsId}/providers/{providersId}/scimTenants",
+"httpMethod": "GET",
+"id": "iam.locations.workforcePools.providers.scimTenants.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of scim tenants to return. If unspecified, at most 1 scim tenant will be returned.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A page token, received from a previous `ListScimTenants` call. Provide this to retrieve the subsequent page.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent to list scim tenants. Format: 'locations/{location}/workforcePools/{workforce_pool}/providers/{provider}'",
+"location": "path",
+"pattern": "^locations/[^/]+/workforcePools/[^/]+/providers/[^/]+$",
+"required": true,
+"type": "string"
+},
+"showDeleted": {
+"description": "Optional. Whether to return soft-deleted scim tenants.",
+"location": "query",
+"type": "boolean"
+}
+},
+"path": "v1/{+parent}/scimTenants",
+"response": {
+"$ref": "ListWorkforcePoolProviderScimTenantsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"patch": {
+"description": "Updates an existing WorkforcePoolProviderScimTenant.",
+"flatPath": "v1/locations/{locationsId}/workforcePools/{workforcePoolsId}/providers/{providersId}/scimTenants/{scimTenantsId}",
+"httpMethod": "PATCH",
+"id": "iam.locations.workforcePools.providers.scimTenants.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Identifier. The resource name of the SCIM Tenant. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}`",
+"location": "path",
+"pattern": "^locations/[^/]+/workforcePools/[^/]+/providers/[^/]+/scimTenants/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. The list of fields to update.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"request": {
+"$ref": "WorkforcePoolProviderScimTenant"
+},
+"response": {
+"$ref": "WorkforcePoolProviderScimTenant"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"undelete": {
+"description": "Undeletes a WorkforcePoolProviderScimTenant, as long as it was deleted fewer than 30 days ago.",
+"flatPath": "v1/locations/{locationsId}/workforcePools/{workforcePoolsId}/providers/{providersId}/scimTenants/{scimTenantsId}:undelete",
+"httpMethod": "POST",
+"id": "iam.locations.workforcePools.providers.scimTenants.undelete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the scim tenant to undelete. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/{provider}/scimTenants/{scim_tenant}`",
+"location": "path",
+"pattern": "^locations/[^/]+/workforcePools/[^/]+/providers/[^/]+/scimTenants/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}:undelete",
+"request": {
+"$ref": "UndeleteWorkforcePoolProviderScimTenantRequest"
+},
+"response": {
+"$ref": "WorkforcePoolProviderScimTenant"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+},
+"resources": {
+"tokens": {
+"methods": {
+"create": {
+"description": "Creates a new WorkforcePoolProviderScimToken in a WorkforcePoolProviderScimTenant. You cannot reuse the name of a deleted SCIM token until 30 days after deletion.",
+"flatPath": "v1/locations/{locationsId}/workforcePools/{workforcePoolsId}/providers/{providersId}/scimTenants/{scimTenantsId}/tokens",
+"httpMethod": "POST",
+"id": "iam.locations.workforcePools.providers.scimTenants.tokens.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The parent tenant to create scim token. Format: 'locations/{location}/workforcePools/{workforce_pool}/providers/{provider}/scimTenants/{scim_tenant}'",
+"location": "path",
+"pattern": "^locations/[^/]+/workforcePools/[^/]+/providers/[^/]+/scimTenants/[^/]+$",
+"required": true,
+"type": "string"
+},
+"workforcePoolProviderScimTokenId": {
+"description": "Required. The ID to use for the scim token, which becomes the final component of the resource name. This value should be 4-32 characters and follow this pattern: \"([a-z]([a-z0-9\\\\-]{2,30}[a-z0-9]))\"",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1/{+parent}/tokens",
+"request": {
+"$ref": "WorkforcePoolProviderScimToken"
+},
+"response": {
+"$ref": "WorkforcePoolProviderScimToken"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"delete": {
+"description": "Deletes a WorkforcePoolProviderScimToken. You can undelete a scim token for 30 days. After 30 days, deletion is permanent. You cannot update deleted scim tokens. However, you can view and list them.",
+"flatPath": "v1/locations/{locationsId}/workforcePools/{workforcePoolsId}/providers/{providersId}/scimTenants/{scimTenantsId}/tokens/{tokensId}",
+"httpMethod": "DELETE",
+"id": "iam.locations.workforcePools.providers.scimTenants.tokens.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the scim token to delete. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/{provider}/scimTenants/{scim_tenant}/tokens/{token}`",
+"location": "path",
+"pattern": "^locations/[^/]+/workforcePools/[^/]+/providers/[^/]+/scimTenants/[^/]+/tokens/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"response": {
+"$ref": "WorkforcePoolProviderScimToken"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"get": {
+"description": "Gets an individual WorkforcePoolProviderScimToken.",
+"flatPath": "v1/locations/{locationsId}/workforcePools/{workforcePoolsId}/providers/{providersId}/scimTenants/{scimTenantsId}/tokens/{tokensId}",
+"httpMethod": "GET",
+"id": "iam.locations.workforcePools.providers.scimTenants.tokens.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the scim token to retrieve. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/{provider}/scimTenants/{scim_tenant}/tokens/{token}`",
+"location": "path",
+"pattern": "^locations/[^/]+/workforcePools/[^/]+/providers/[^/]+/scimTenants/[^/]+/tokens/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"response": {
+"$ref": "WorkforcePoolProviderScimToken"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists all non-deleted WorkforcePoolProviderScimTokenss in a WorkforcePoolProviderScimTenant. If `show_deleted` is set to `true`, then deleted SCIM tokens are also listed.",
+"flatPath": "v1/locations/{locationsId}/workforcePools/{workforcePoolsId}/providers/{providersId}/scimTenants/{scimTenantsId}/tokens",
+"httpMethod": "GET",
+"id": "iam.locations.workforcePools.providers.scimTenants.tokens.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. The maximum number of scim tokens to return. If unspecified, at most 2 scim tokens will be returned.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A page token, received from a previous `ListWorkforcePoolProviderScimTokens` call. Provide this to retrieve the subsequent page.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. The parent to list scim tokens. Format: 'locations/{location}/workforcePools/{workforce_pool}/providers/{provider}/scimTenants/{scim_tenant}'",
+"location": "path",
+"pattern": "^locations/[^/]+/workforcePools/[^/]+/providers/[^/]+/scimTenants/[^/]+$",
+"required": true,
+"type": "string"
+},
+"showDeleted": {
+"description": "Optional. Whether to return soft-deleted scim tokens.",
+"location": "query",
+"type": "boolean"
+}
+},
+"path": "v1/{+parent}/tokens",
+"response": {
+"$ref": "ListWorkforcePoolProviderScimTokensResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"patch": {
+"description": "Updates an existing WorkforcePoolProviderScimToken.",
+"flatPath": "v1/locations/{locationsId}/workforcePools/{workforcePoolsId}/providers/{providersId}/scimTenants/{scimTenantsId}/tokens/{tokensId}",
+"httpMethod": "PATCH",
+"id": "iam.locations.workforcePools.providers.scimTenants.tokens.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Identifier. The resource name of the SCIM Token. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}/tokens/{token}`",
+"location": "path",
+"pattern": "^locations/[^/]+/workforcePools/[^/]+/providers/[^/]+/scimTenants/[^/]+/tokens/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. The list of fields to update.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1/{+name}",
+"request": {
+"$ref": "WorkforcePoolProviderScimToken"
+},
+"response": {
+"$ref": "WorkforcePoolProviderScimToken"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"undelete": {
+"description": "Undeletes a WorkforcePoolProviderScimToken, as long as it was deleted fewer than 30 days ago.",
+"flatPath": "v1/locations/{locationsId}/workforcePools/{workforcePoolsId}/providers/{providersId}/scimTenants/{scimTenantsId}/tokens/{tokensId}:undelete",
+"httpMethod": "POST",
+"id": "iam.locations.workforcePools.providers.scimTenants.tokens.undelete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The name of the scim token to undelete. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/{provider}/scimTenants/{scim_tenant}/tokens/{token}`",
+"location": "path",
+"pattern": "^locations/[^/]+/workforcePools/[^/]+/providers/[^/]+/scimTenants/[^/]+/tokens/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+name}:undelete",
+"request": {
+"$ref": "UndeleteWorkforcePoolProviderScimTokenRequest"
+},
+"response": {
+"$ref": "WorkforcePoolProviderScimToken"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+}
+}
 }
 }
 },
@@ -3773,7 +4155,7 @@
 }
 }
 },
-"revision": "20250627",
+"revision": "20250718",
 "rootUrl": "https://iam.googleapis.com/",
 "schemas": {
 "AccessRestrictions": {
@@ -4630,6 +5012,44 @@
 },
 "type": "object"
 },
+"ListWorkforcePoolProviderScimTenantsResponse": {
+"description": "Response message for ListWorkforcePoolProviderScimTenants.",
+"id": "ListWorkforcePoolProviderScimTenantsResponse",
+"properties": {
+"nextPageToken": {
+"description": "Optional. A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.",
+"type": "string"
+},
+"workforcePoolProviderScimTenants": {
+"description": "Output only. A list of scim tenants.",
+"items": {
+"$ref": "WorkforcePoolProviderScimTenant"
+},
+"readOnly": true,
+"type": "array"
+}
+},
+"type": "object"
+},
+"ListWorkforcePoolProviderScimTokensResponse": {
+"description": "Response message for ListWorkforcePoolProviderScimTokens.",
+"id": "ListWorkforcePoolProviderScimTokensResponse",
+"properties": {
+"nextPageToken": {
+"description": "Optional. A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.",
+"type": "string"
+},
+"workforcePoolProviderScimTokens": {
+"description": "Output only. A list of scim tokens.",
+"items": {
+"$ref": "WorkforcePoolProviderScimToken"
+},
+"readOnly": true,
+"type": "array"
+}
+},
+"type": "object"
+},
 "ListWorkforcePoolProvidersResponse": {
 "description": "Response message for ListWorkforcePoolProviders.",
 "id": "ListWorkforcePoolProvidersResponse",
@@ -5747,6 +6167,18 @@ false
 "properties": {},
 "type": "object"
 },
+"UndeleteWorkforcePoolProviderScimTenantRequest": {
+"description": "Request message for UndeleteWorkforcePoolProviderScimTenant.",
+"id": "UndeleteWorkforcePoolProviderScimTenantRequest",
+"properties": {},
+"type": "object"
+},
+"UndeleteWorkforcePoolProviderScimTokenRequest": {
+"description": "Request message for UndeleteWorkforcePoolProviderScimToken.",
+"id": "UndeleteWorkforcePoolProviderScimTokenRequest",
+"properties": {},
+"type": "object"
+},
 "UndeleteWorkforcePoolRequest": {
 "description": "Request message for UndeleteWorkforcePool.",
 "id": "UndeleteWorkforcePoolRequest",
@@ -5895,6 +6327,10 @@ false
 "readOnly": true,
 "type": "string"
 },
+"extendedAttributesOauth2Client": {
+"$ref": "GoogleIamAdminV1WorkforcePoolProviderExtraAttributesOAuth2Client",
+"description": "Optional. The configuration for OAuth 2.0 client used to get the extended group memberships for user identities. Only the `AZURE_AD_GROUPS_ID` attribute type is supported. Extended groups supports a subset of Google Cloud services. When the user accesses these services, extended group memberships override the mapped `google.groups` attribute. Extended group memberships cannot be used in attribute mapping or attribute condition expressions. To keep extended group memberships up to date, extended groups are retrieved when the user signs in and at regular intervals during the user's active session. Each user identity in the workforce identity pool must map to a specific, unique Microsoft Entra ID user."
+},
 "extraAttributesOauth2Client": {
 "$ref": "GoogleIamAdminV1WorkforcePoolProviderExtraAttributesOAuth2Client",
 "description": "Optional. The configuration for OAuth 2.0 client used to get the additional user attributes. This should be used when users can't get the desired claims in authentication credentials. Currently this configuration is only supported with OIDC protocol."
@@ -5977,6 +6413,93 @@ false
 },
 "type": "object"
 },
+"WorkforcePoolProviderScimTenant": {
+"description": "Represents a scim tenant. Used for provisioning and managing identity data (such as Users and Groups) in cross-domain environments.",
+"id": "WorkforcePoolProviderScimTenant",
+"properties": {
+"baseUri": {
+"description": "Output only. Represents the base URI as defined in [RFC 7644, Section 1.3](https://datatracker.ietf.org/doc/html/rfc7644#section-1.3). Clients must use this as the root address for managing resources under the tenant. Format: https://iamscim.googleapis.com/{version}/{tenant_id}/",
+"readOnly": true,
+"type": "string"
+},
+"claimMapping": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Optional. Maps BYOID claims to SCIM claims.",
+"type": "object"
+},
+"description": {
+"description": "Optional. The user-specified description of the scim tenant. Cannot exceed 256 characters.",
+"type": "string"
+},
+"displayName": {
+"description": "Optional. The user-specified display name of the scim tenant. Cannot exceed 32 characters.",
+"type": "string"
+},
+"name": {
+"description": "Identifier. The resource name of the SCIM Tenant. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}`",
+"type": "string"
+},
+"purgeTime": {
+"description": "Output only. The timestamp when the scim tenant is going to be purged.",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"state": {
+"description": "Output only. The state of the tenant.",
+"enum": [
+"STATE_UNSPECIFIED",
+"ACTIVE",
+"DELETED"
+],
+"enumDescriptions": [
+"State unspecified.",
+"The tenant is active and may be used to provision users and groups.",
+"The tenant is soft-deleted. Soft-deleted tenants are permanently deleted after approximately 30 days."
+],
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
+"WorkforcePoolProviderScimToken": {
+"description": "Represents a token for the WorkforcePoolProviderScimTenant. Used for authenticating SCIM Provisioning requests.",
+"id": "WorkforcePoolProviderScimToken",
+"properties": {
+"displayName": {
+"description": "Optional. The user-specified display name of the scim token. Cannot exceed 32 characters.",
+"type": "string"
+},
+"name": {
+"description": "Identifier. The resource name of the SCIM Token. Format: `locations/{location}/workforcePools/{workforce_pool}/providers/ {workforce_pool_provider}/scimTenants/{scim_tenant}/tokens/{token}`",
+"type": "string"
+},
+"securityToken": {
+"description": "Output only. The token string. Provide this to the IdP for authentication. Will be set only during creation.",
+"readOnly": true,
+"type": "string"
+},
+"state": {
+"description": "Output only. The state of the token.",
+"enum": [
+"STATE_UNSPECIFIED",
+"ACTIVE",
+"DELETED"
+],
+"enumDescriptions": [
+"State unspecified.",
+"The tenant is active and may be used to provision users and groups.",
+"The tenant is soft-deleted. Soft-deleted tenants are permanently deleted after approximately 30 days."
+],
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
 "WorkloadIdentityPool": {
 "description": "Represents a collection of workload identities. You can define IAM policies to grant these identities access to Google Cloud resources.",
 "id": "WorkloadIdentityPool",

From 6b8c658ee38785fce3e766237f726565fa3b7935 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:12 +0000
Subject: [PATCH 16/36] fix(iamcredentials): update the api

#### iamcredentials:v1

The following keys were changed:
- endpoints (Total Keys: 1)
---
 .../documents/iamcredentials.v1.json          | 22 ++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/googleapiclient/discovery_cache/documents/iamcredentials.v1.json b/googleapiclient/discovery_cache/documents/iamcredentials.v1.json
index 8cec0af539b..64870a6b311 100644
--- a/googleapiclient/discovery_cache/documents/iamcredentials.v1.json
+++ b/googleapiclient/discovery_cache/documents/iamcredentials.v1.json
@@ -18,6 +18,26 @@
 "endpoints": [
 {
 "description": "Regional Endpoint",
+"endpointUrl": "https://iamcredentials.asia-east1.rep.googleapis.com/",
+"location": "asia-east1"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://iamcredentials.europe-west1.rep.googleapis.com/",
+"location": "europe-west1"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://iamcredentials.us-central1.rep.googleapis.com/",
+"location": "us-central1"
+},
+{
+"description": "Regional Endpoint",
+"endpointUrl": "https://iamcredentials.us-east1.rep.googleapis.com/",
+"location": "us-east1"
+},
+{
+"description": "Regional Endpoint",
 "endpointUrl": "https://iamcredentials.us-east7.rep.googleapis.com/",
 "location": "us-east7"
 }
@@ -315,7 +335,7 @@
 }
 }
 },
-"revision": "20250417",
+"revision": "20250717",
 "rootUrl": "https://iamcredentials.googleapis.com/",
 "schemas": {
 "GenerateAccessTokenRequest": {

From 8d580600922b9632c801573f5ecfd5594eeef81e Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:12 +0000
Subject: [PATCH 17/36] feat(integrations): update the api

#### integrations:v1

The following keys were deleted:
- resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.resources.agentFlows.methods.create (Total Keys: 12)
- resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.resources.agentFlows.methods.delete (Total Keys: 11)
- resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.resources.agentFlows.methods.generate (Total Keys: 24)
- resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.resources.agentFlows.methods.get (Total Keys: 11)
- resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.resources.agentFlows.methods.list (Total Keys: 23)
- resources.projects.resources.locations.resources.collections.resources.engines.resources.assistants.resources.agentFlows.methods.patch (Total Keys: 15)
- schemas.GoogleCloudIntegrationsV1alphaAgentFlow (Total Keys: 14)
- schemas.GoogleCloudIntegrationsV1alphaGenerateAgentFlowRequest (Total Keys: 5)
- schemas.GoogleCloudIntegrationsV1alphaGenerateAgentFlowResponse (Total Keys: 4)
- schemas.GoogleCloudIntegrationsV1alphaGenerateAndUpdateAgentFlowRequest (Total Keys: 4)
- schemas.GoogleCloudIntegrationsV1alphaGenerateAndUpdateAgentFlowResponse (Total Keys: 4)
- schemas.GoogleCloudIntegrationsV1alphaListAgentFlowsResponse (Total Keys: 7)
---
 .../integrations_v1.projects.locations.html   |   5 -
 .../documents/integrations.v1.json            | 364 +-----------------
 2 files changed, 1 insertion(+), 368 deletions(-)

diff --git a/docs/dyn/integrations_v1.projects.locations.html b/docs/dyn/integrations_v1.projects.locations.html
index e143b35d3ea..25f31b5b4d8 100644
--- a/docs/dyn/integrations_v1.projects.locations.html
+++ b/docs/dyn/integrations_v1.projects.locations.html
@@ -99,11 +99,6 @@ 
Instance Methods

 

 
Returns the cloudFunctions Resource.

 
-

-  collections()
-

-
Returns the collections Resource.

-
 

   connections()
 

diff --git a/googleapiclient/discovery_cache/documents/integrations.v1.json b/googleapiclient/discovery_cache/documents/integrations.v1.json
index 762337725fe..3d6a382dcb8 100644
--- a/googleapiclient/discovery_cache/documents/integrations.v1.json
+++ b/googleapiclient/discovery_cache/documents/integrations.v1.json
@@ -943,242 +943,6 @@
 }
 }
 },
-"collections": {
-"resources": {
-"engines": {
-"resources": {
-"assistants": {
-"resources": {
-"agentFlows": {
-"methods": {
-"create": {
-"description": "Request to create a new AgentFlow with user-provided flow configuration.",
-"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agentFlows",
-"httpMethod": "POST",
-"id": "integrations.projects.locations.collections.engines.assistants.agentFlows.create",
-"parameterOrder": [
-"parent"
-],
-"parameters": {
-"parent": {
-"description": "Required. Parent resource name where this AgentFlow will be created.",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+$",
-"required": true,
-"type": "string"
-}
-},
-"path": "v1/{+parent}/agentFlows",
-"request": {
-"$ref": "GoogleCloudIntegrationsV1alphaAgentFlow"
-},
-"response": {
-"$ref": "GoogleCloudIntegrationsV1alphaAgentFlow"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
-},
-"delete": {
-"description": "Deletes an existing AgentFlow.",
-"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agentFlows/{agentFlowsId}",
-"httpMethod": "DELETE",
-"id": "integrations.projects.locations.collections.engines.assistants.agentFlows.delete",
-"parameterOrder": [
-"name"
-],
-"parameters": {
-"name": {
-"description": "Required. The resource name of the AgentFlow to delete.",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agentFlows/[^/]+$",
-"required": true,
-"type": "string"
-}
-},
-"path": "v1/{+name}",
-"response": {
-"$ref": "GoogleProtobufEmpty"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
-},
-"generate": {
-"description": "Uses Natural Language (NL) to generate an AgentFlow configuration and create a new AgentFlow.",
-"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agentFlows:generate",
-"httpMethod": "POST",
-"id": "integrations.projects.locations.collections.engines.assistants.agentFlows.generate",
-"parameterOrder": [
-"parent"
-],
-"parameters": {
-"parent": {
-"description": "Required. Parent resource name where this AgentFlow will be created.",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+$",
-"required": true,
-"type": "string"
-}
-},
-"path": "v1/{+parent}/agentFlows:generate",
-"request": {
-"$ref": "GoogleCloudIntegrationsV1alphaGenerateAgentFlowRequest"
-},
-"response": {
-"$ref": "GoogleCloudIntegrationsV1alphaGenerateAgentFlowResponse"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
-},
-"generateAndUpdate": {
-"description": "Uses Natural Language (NL) to generate an AgentFlow configuration and update an existing AgentFlow.",
-"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agentFlows/{agentFlowsId}:generateAndUpdate",
-"httpMethod": "POST",
-"id": "integrations.projects.locations.collections.engines.assistants.agentFlows.generateAndUpdate",
-"parameterOrder": [
-"name"
-],
-"parameters": {
-"name": {
-"description": "Required. The resource name of the AgentFlow to update.",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agentFlows/[^/]+$",
-"required": true,
-"type": "string"
-}
-},
-"path": "v1/{+name}:generateAndUpdate",
-"request": {
-"$ref": "GoogleCloudIntegrationsV1alphaGenerateAndUpdateAgentFlowRequest"
-},
-"response": {
-"$ref": "GoogleCloudIntegrationsV1alphaGenerateAndUpdateAgentFlowResponse"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
-},
-"get": {
-"description": "Gets an existing AgentFlow.",
-"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agentFlows/{agentFlowsId}",
-"httpMethod": "GET",
-"id": "integrations.projects.locations.collections.engines.assistants.agentFlows.get",
-"parameterOrder": [
-"name"
-],
-"parameters": {
-"name": {
-"description": "Required. The resource name of the AgentFlow to get.",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agentFlows/[^/]+$",
-"required": true,
-"type": "string"
-}
-},
-"path": "v1/{+name}",
-"response": {
-"$ref": "GoogleCloudIntegrationsV1alphaAgentFlow"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
-},
-"list": {
-"description": "Lists all AgentFlows.",
-"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agentFlows",
-"httpMethod": "GET",
-"id": "integrations.projects.locations.collections.engines.assistants.agentFlows.list",
-"parameterOrder": [
-"parent"
-],
-"parameters": {
-"filter": {
-"description": "Optional. Standard filter field. Filtering as supported in https://developers.google.com/authorized-buyers/apis/guides/list-filters.",
-"location": "query",
-"type": "string"
-},
-"orderBy": {
-"description": "Optional. The results would be returned in order specified here. Currently supported sort keys are: Descending sort order for \"create_time\", \"update_time\". Ascending sort order for \"agent_flow_id\", \"display_name\".",
-"location": "query",
-"type": "string"
-},
-"pageSize": {
-"description": "Optional. The maximum number of AgentFlows to return. The service may return fewer than this value. If unspecified, at most 100 AgentFlows will be returned.",
-"format": "int32",
-"location": "query",
-"type": "integer"
-},
-"pageToken": {
-"description": "Optional. A page token, received from a previous `ListAgentFlows` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListAgentFlows` must match the call that provided the page token.",
-"location": "query",
-"type": "string"
-},
-"parent": {
-"description": "Required. The parent resource where this AgentFlow was created.",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+$",
-"required": true,
-"type": "string"
-},
-"readMask": {
-"description": "Optional. The mask which specifies fields that need to be returned in the AgentFlow's response.",
-"format": "google-fieldmask",
-"location": "query",
-"type": "string"
-}
-},
-"path": "v1/{+parent}/agentFlows",
-"response": {
-"$ref": "GoogleCloudIntegrationsV1alphaListAgentFlowsResponse"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
-},
-"patch": {
-"description": "Updates an existing AgentFlow.",
-"flatPath": "v1/projects/{projectsId}/locations/{locationsId}/collections/{collectionsId}/engines/{enginesId}/assistants/{assistantsId}/agentFlows/{agentFlowsId}",
-"httpMethod": "PATCH",
-"id": "integrations.projects.locations.collections.engines.assistants.agentFlows.patch",
-"parameterOrder": [
-"name"
-],
-"parameters": {
-"name": {
-"description": "Required. Resource name of the agent flow.",
-"location": "path",
-"pattern": "^projects/[^/]+/locations/[^/]+/collections/[^/]+/engines/[^/]+/assistants/[^/]+/agentFlows/[^/]+$",
-"required": true,
-"type": "string"
-},
-"updateMask": {
-"description": "Optional. Field mask specifying the fields in the above AgentFlow that have been modified and need to be updated.",
-"format": "google-fieldmask",
-"location": "query",
-"type": "string"
-}
-},
-"path": "v1/{+name}",
-"request": {
-"$ref": "GoogleCloudIntegrationsV1alphaAgentFlow"
-},
-"response": {
-"$ref": "GoogleCloudIntegrationsV1alphaAgentFlow"
-},
-"scopes": [
-"https://www.googleapis.com/auth/cloud-platform"
-]
-}
-}
-}
-}
-}
-}
-}
-}
-},
 "connections": {
 "methods": {
 "getConnectionSchemaMetadata": {
@@ -4876,7 +4640,7 @@
 }
 }
 },
-"revision": "20250627",
+"revision": "20250720",
 "rootUrl": "https://integrations.googleapis.com/",
 "schemas": {
 "CrmlogErrorCode": {
@@ -10670,50 +10434,6 @@ false
 },
 "type": "object"
 },
-"GoogleCloudIntegrationsV1alphaAgentFlow": {
-"description": "AgentFlow configurations.",
-"id": "GoogleCloudIntegrationsV1alphaAgentFlow",
-"properties": {
-"createTime": {
-"description": "Output only. The timestamp when the agent flow was created.",
-"format": "google-datetime",
-"readOnly": true,
-"type": "string"
-},
-"creator": {
-"description": "Output only. The user who created the agent flow.",
-"readOnly": true,
-"type": "string"
-},
-"description": {
-"description": "Optional. Description of the agent flow.",
-"type": "string"
-},
-"displayName": {
-"description": "Optional. Display name of the agent flow.",
-"type": "string"
-},
-"flowConfig": {
-"description": "Required. The flow configuration, represented as a string.",
-"type": "string"
-},
-"name": {
-"description": "Required. Resource name of the agent flow.",
-"type": "string"
-},
-"noCodeAgent": {
-"description": "Optional. Name of the NoCodeAgent.",
-"type": "string"
-},
-"updateTime": {
-"description": "Output only. The timestamp when the agent flow was last updated.",
-"format": "google-datetime",
-"readOnly": true,
-"type": "string"
-}
-},
-"type": "object"
-},
 "GoogleCloudIntegrationsV1alphaApiTriggerResource": {
 "description": "List of API triggerID and their workflow resource name.",
 "id": "GoogleCloudIntegrationsV1alphaApiTriggerResource",
@@ -12213,68 +11933,6 @@ false
 },
 "type": "object"
 },
-"GoogleCloudIntegrationsV1alphaGenerateAgentFlowRequest": {
-"description": "Request message for GenerateAgentFlow.",
-"id": "GoogleCloudIntegrationsV1alphaGenerateAgentFlowRequest",
-"properties": {
-"creator": {
-"description": "Optional. The creator id;",
-"type": "string"
-},
-"description": {
-"description": "Optional. The description of the AgentFlow to be generated.",
-"type": "string"
-},
-"displayName": {
-"description": "Optional. The display name of the AgentFlow to be generated.",
-"type": "string"
-},
-"intent": {
-"description": "Required. The intent, described in natural language, for the AgentFlow to generate.",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudIntegrationsV1alphaGenerateAgentFlowResponse": {
-"description": "Response message for GenerateAgentFlow.",
-"id": "GoogleCloudIntegrationsV1alphaGenerateAgentFlowResponse",
-"properties": {
-"agentFlow": {
-"$ref": "GoogleCloudIntegrationsV1alphaAgentFlow",
-"description": "Output only. AgentFlow that gets generated.",
-"readOnly": true
-}
-},
-"type": "object"
-},
-"GoogleCloudIntegrationsV1alphaGenerateAndUpdateAgentFlowRequest": {
-"description": "Request message for GenerateAndUpdateAgentFlow.",
-"id": "GoogleCloudIntegrationsV1alphaGenerateAndUpdateAgentFlowRequest",
-"properties": {
-"intent": {
-"description": "Required. The intent, described in natural language, for the AgentFlow to update.",
-"type": "string"
-},
-"updater": {
-"description": "Optional. The updater id;",
-"type": "string"
-}
-},
-"type": "object"
-},
-"GoogleCloudIntegrationsV1alphaGenerateAndUpdateAgentFlowResponse": {
-"description": "Response message for GenerateAndUpdateAgentFlow.",
-"id": "GoogleCloudIntegrationsV1alphaGenerateAndUpdateAgentFlowResponse",
-"properties": {
-"agentFlow": {
-"$ref": "GoogleCloudIntegrationsV1alphaAgentFlow",
-"description": "Output only. AgentFlow that gets updated.",
-"readOnly": true
-}
-},
-"type": "object"
-},
 "GoogleCloudIntegrationsV1alphaGenerateOpenApiSpecRequest": {
 "description": "Request for GenerateOpenApiSpec.",
 "id": "GoogleCloudIntegrationsV1alphaGenerateOpenApiSpecRequest",
@@ -12953,26 +12611,6 @@ false
 },
 "type": "object"
 },
-"GoogleCloudIntegrationsV1alphaListAgentFlowsResponse": {
-"description": "Response for ListAgentFlows.",
-"id": "GoogleCloudIntegrationsV1alphaListAgentFlowsResponse",
-"properties": {
-"agentFlows": {
-"description": "Output only. The AgentFlows from the specified collection.",
-"items": {
-"$ref": "GoogleCloudIntegrationsV1alphaAgentFlow"
-},
-"readOnly": true,
-"type": "array"
-},
-"nextPageToken": {
-"description": "Output only. A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.",
-"readOnly": true,
-"type": "string"
-}
-},
-"type": "object"
-},
 "GoogleCloudIntegrationsV1alphaListAuthConfigsResponse": {
 "description": "Response to list AuthConfigs.",
 "id": "GoogleCloudIntegrationsV1alphaListAuthConfigsResponse",

From 421df255b7d2c79331727d0f44e8d09c5aff620e Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:12 +0000
Subject: [PATCH 18/36] feat(looker): update the api

#### looker:v1

The following keys were added:
- schemas.Instance.properties.classType.type (Total Keys: 1)
---
 .../looker_v1.projects.locations.instances.html  |  4 ++++
 .../discovery_cache/documents/looker.v1.json     | 16 +++++++++++++++-
 2 files changed, 19 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/looker_v1.projects.locations.instances.html b/docs/dyn/looker_v1.projects.locations.instances.html
index be6c62b5d1c..ce8ab177681 100644
--- a/docs/dyn/looker_v1.projects.locations.instances.html
+++ b/docs/dyn/looker_v1.projects.locations.instances.html
@@ -133,6 +133,7 @@ 
Method Details

       "A String",
     ],
   },
+  "classType": "A String", # Optional. Storage class of the instance.
   "consumerNetwork": "A String", # Network name in the consumer project. Format: `projects/{project}/global/networks/{network}`. Note that the consumer network may be in a different GCP project than the consumer project that is hosting the Looker Instance.
   "createTime": "A String", # Output only. The time when the Looker instance provisioning was first requested.
   "customDomain": { # Custom domain information. # Custom domain configuration for the instance.
@@ -369,6 +370,7 @@ 
Method Details

       "A String",
     ],
   },
+  "classType": "A String", # Optional. Storage class of the instance.
   "consumerNetwork": "A String", # Network name in the consumer project. Format: `projects/{project}/global/networks/{network}`. Note that the consumer network may be in a different GCP project than the consumer project that is hosting the Looker Instance.
   "createTime": "A String", # Output only. The time when the Looker instance provisioning was first requested.
   "customDomain": { # Custom domain information. # Custom domain configuration for the instance.
@@ -541,6 +543,7 @@ 
Method Details

           "A String",
         ],
       },
+      "classType": "A String", # Optional. Storage class of the instance.
       "consumerNetwork": "A String", # Network name in the consumer project. Format: `projects/{project}/global/networks/{network}`. Note that the consumer network may be in a different GCP project than the consumer project that is hosting the Looker Instance.
       "createTime": "A String", # Output only. The time when the Looker instance provisioning was first requested.
       "customDomain": { # Custom domain information. # Custom domain configuration for the instance.
@@ -682,6 +685,7 @@ 
Method Details

       "A String",
     ],
   },
+  "classType": "A String", # Optional. Storage class of the instance.
   "consumerNetwork": "A String", # Network name in the consumer project. Format: `projects/{project}/global/networks/{network}`. Note that the consumer network may be in a different GCP project than the consumer project that is hosting the Looker Instance.
   "createTime": "A String", # Output only. The time when the Looker instance provisioning was first requested.
   "customDomain": { # Custom domain information. # Custom domain configuration for the instance.
diff --git a/googleapiclient/discovery_cache/documents/looker.v1.json b/googleapiclient/discovery_cache/documents/looker.v1.json
index d96ee87b9f3..f4226ef0516 100644
--- a/googleapiclient/discovery_cache/documents/looker.v1.json
+++ b/googleapiclient/discovery_cache/documents/looker.v1.json
@@ -710,7 +710,7 @@
 }
 }
 },
-"revision": "20250615",
+"revision": "20250721",
 "rootUrl": "https://looker.googleapis.com/",
 "schemas": {
 "AdminSettings": {
@@ -952,6 +952,20 @@
 "$ref": "AdminSettings",
 "description": "Looker Instance Admin settings."
 },
+"classType": {
+"description": "Optional. Storage class of the instance.",
+"enum": [
+"CLASS_TYPE_UNSPECIFIED",
+"R1",
+"P1"
+],
+"enumDescriptions": [
+"Unspecified storage class.",
+"Filestore.",
+"PD SSD."
+],
+"type": "string"
+},
 "consumerNetwork": {
 "description": "Network name in the consumer project. Format: `projects/{project}/global/networks/{network}`. Note that the consumer network may be in a different GCP project than the consumer project that is hosting the Looker Instance.",
 "type": "string"

From d3f14151833a7cacd5ff6a4b86a27321b1bea455 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:13 +0000
Subject: [PATCH 19/36] feat(merchantapi): update the api

#### merchantapi:accounts_v1beta

The following keys were deleted:
- resources.accounts.methods.getDeveloperRegistration (Total Keys: 11)
- schemas.RegisterGCPRequest (Total Keys: 3)
- schemas.UnregisterGCPRequest (Total Keys: 2)

The following keys were added:
- resources.accounts.resources.developerRegistration.methods.getDeveloperRegistration (Total Keys: 11)
- schemas.RegisterGcpRequest (Total Keys: 3)
- schemas.UnregisterGcpRequest (Total Keys: 2)

The following keys were changed:
- resources.accounts.resources.developerRegistration.methods.registerGcp.request.$ref (Total Keys: 1)
- resources.accounts.resources.developerRegistration.methods.unregisterGcp.request.$ref (Total Keys: 1)

#### merchantapi:inventories_v1beta

The following keys were added:
- schemas.LocalInventory.properties.customAttributes.deprecated (Total Keys: 1)
- schemas.RegionalInventory.properties.customAttributes.deprecated (Total Keys: 1)
---
 ...v1beta.accounts.developerRegistration.html | 25 ++++++++
 .../merchantapi_accounts_v1beta.accounts.html | 25 --------
 ...roducts_v1beta.accounts.productInputs.html | 16 ++---
 ...api_products_v1beta.accounts.products.html |  8 +--
 .../merchantapi.accounts_v1beta.json          | 64 +++++++++----------
 .../merchantapi.datasources_v1beta.json       |  4 +-
 .../merchantapi.inventories_v1beta.json       |  4 +-
 .../merchantapi.products_v1beta.json          |  6 +-
 8 files changed, 77 insertions(+), 75 deletions(-)

diff --git a/docs/dyn/merchantapi_accounts_v1beta.accounts.developerRegistration.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.developerRegistration.html
index d6971531777..568ce4ca5ce 100644
--- a/docs/dyn/merchantapi_accounts_v1beta.accounts.developerRegistration.html
+++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.developerRegistration.html
@@ -77,6 +77,9 @@ 
Instance Methods

 

   close()

 
Close httplib2 connections.

+

+  getDeveloperRegistration(name, x__xgafv=None)

+
Retrieves a developer registration for a merchant.

 

   registerGcp(name, body=None, x__xgafv=None)

 
Registers the GCP used for the API call to the shopping account passed in the request. Will create a user with an "API developer" and add the "developer_email" as a contact with "API notifications" email preference on.

@@ -89,6 +92,28 @@ 
Method Details

   
Close httplib2 connections.

 

 
+

+    getDeveloperRegistration(name, x__xgafv=None)
+  
Retrieves a developer registration for a merchant.
+
+Args:
+  name: string, Required. The `name` (ID) of the developer registration. (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Represents a developer registration owned by a Merchant account.
+  "gcpIds": [ # Output only. The GCP ids attached to this developer registration
+    "A String",
+  ],
+  "name": "A String", # Identifier. The `name` (ID) of the developer registration. Generated by the Content API upon creation of a new `DeveloperRegistration`. The `account` represents the merchant ID of the merchant that owns the registration.
+}

+

+
 

     registerGcp(name, body=None, x__xgafv=None)
   
Registers the GCP used for the API call to the shopping account passed in the request. Will create a user with an "API developer" and add the "developer_email" as a contact with "API notifications" email preference on.
diff --git a/docs/dyn/merchantapi_accounts_v1beta.accounts.html b/docs/dyn/merchantapi_accounts_v1beta.accounts.html
index d2491f029c7..7aa3171bbd5 100644
--- a/docs/dyn/merchantapi_accounts_v1beta.accounts.html
+++ b/docs/dyn/merchantapi_accounts_v1beta.accounts.html
@@ -176,9 +176,6 @@ 
Instance Methods

 

   get(name, x__xgafv=None)

 
Retrieves an account from your Merchant Center account. After inserting, updating, or deleting an account, it may take several minutes before changes take effect.

-

-  getDeveloperRegistration(name, x__xgafv=None)

-
Retrieves a developer registration for a merchant.

 

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

 
Note: For the `accounts.list` method, quota and limits usage are charged for each user, and not for the Merchant Center ID or the advanced account ID. To list several sub-accounts, you should use the `accounts.listSubaccounts` method, which is more suitable for advanced accounts use case.

@@ -324,28 +321,6 @@ 
Method Details

 }

 

 
-

-    getDeveloperRegistration(name, x__xgafv=None)
-  
Retrieves a developer registration for a merchant.
-
-Args:
-  name: string, Required. The `name` (ID) of the developer registration. (required)
-  x__xgafv: string, V1 error format.
-    Allowed values
-      1 - v1 error format
-      2 - v2 error format
-
-Returns:
-  An object of the form:
-
-    { # Represents a developer registration owned by a Merchant account.
-  "gcpIds": [ # Output only. The GCP ids attached to this developer registration
-    "A String",
-  ],
-  "name": "A String", # Identifier. The `name` (ID) of the developer registration. Generated by the Content API upon creation of a new `DeveloperRegistration`. The `account` represents the merchant ID of the merchant that owns the registration.
-}

-

-
 

     list(filter=None, pageSize=None, pageToken=None, x__xgafv=None)
   
Note: For the `accounts.list` method, quota and limits usage are charged for each user, and not for the Merchant Center ID or the advanced account ID. To list several sub-accounts, you should use the `accounts.listSubaccounts` method, which is more suitable for advanced accounts use case.
diff --git a/docs/dyn/merchantapi_products_v1beta.accounts.productInputs.html b/docs/dyn/merchantapi_products_v1beta.accounts.productInputs.html
index c969a0ecb69..e9a9765d4fa 100644
--- a/docs/dyn/merchantapi_products_v1beta.accounts.productInputs.html
+++ b/docs/dyn/merchantapi_products_v1beta.accounts.productInputs.html
@@ -187,7 +187,7 @@ 
Method Details

     "displayAdsTitle": "A String", # Title of an item for dynamic remarketing campaigns.
     "displayAdsValue": 3.14, # Offer margin for dynamic remarketing campaigns. For more information, see [Display ads attribute](https://support.google.com/merchants/answer/6069387).
     "energyEfficiencyClass": "A String", # The energy efficiency class as defined in EU directive 2010/30/EU.
-    "excludedDestinations": [ # The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
+    "excludedDestinations": [ # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
       "A String",
     ],
     "expirationDate": "A String", # Date on which the item should expire, as specified upon insertion, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. The actual expiration date is exposed in `productstatuses` as [googleExpirationDate](https://support.google.com/merchants/answer/6324499) and might be earlier if `expirationDate` is too far in the future.
@@ -211,7 +211,7 @@ 
Method Details

     ],
     "identifierExists": True or False, # Set this value to false when the item does not have unique product identifiers appropriate to its category, such as GTIN, MPN, and brand. Defaults to true, if not provided.
     "imageLink": "A String", # URL of an image of the item.
-    "includedDestinations": [ # The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
+    "includedDestinations": [ # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
       "A String",
     ],
     "installment": { # A message that represents installment. # Number and amount of installments to pay for an item.
@@ -506,7 +506,7 @@ 
Method Details

     "displayAdsTitle": "A String", # Title of an item for dynamic remarketing campaigns.
     "displayAdsValue": 3.14, # Offer margin for dynamic remarketing campaigns. For more information, see [Display ads attribute](https://support.google.com/merchants/answer/6069387).
     "energyEfficiencyClass": "A String", # The energy efficiency class as defined in EU directive 2010/30/EU.
-    "excludedDestinations": [ # The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
+    "excludedDestinations": [ # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
       "A String",
     ],
     "expirationDate": "A String", # Date on which the item should expire, as specified upon insertion, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. The actual expiration date is exposed in `productstatuses` as [googleExpirationDate](https://support.google.com/merchants/answer/6324499) and might be earlier if `expirationDate` is too far in the future.
@@ -530,7 +530,7 @@ 
Method Details

     ],
     "identifierExists": True or False, # Set this value to false when the item does not have unique product identifiers appropriate to its category, such as GTIN, MPN, and brand. Defaults to true, if not provided.
     "imageLink": "A String", # URL of an image of the item.
-    "includedDestinations": [ # The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
+    "includedDestinations": [ # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
       "A String",
     ],
     "installment": { # A message that represents installment. # Number and amount of installments to pay for an item.
@@ -826,7 +826,7 @@ 
Method Details

     "displayAdsTitle": "A String", # Title of an item for dynamic remarketing campaigns.
     "displayAdsValue": 3.14, # Offer margin for dynamic remarketing campaigns. For more information, see [Display ads attribute](https://support.google.com/merchants/answer/6069387).
     "energyEfficiencyClass": "A String", # The energy efficiency class as defined in EU directive 2010/30/EU.
-    "excludedDestinations": [ # The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
+    "excludedDestinations": [ # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
       "A String",
     ],
     "expirationDate": "A String", # Date on which the item should expire, as specified upon insertion, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. The actual expiration date is exposed in `productstatuses` as [googleExpirationDate](https://support.google.com/merchants/answer/6324499) and might be earlier if `expirationDate` is too far in the future.
@@ -850,7 +850,7 @@ 
Method Details

     ],
     "identifierExists": True or False, # Set this value to false when the item does not have unique product identifiers appropriate to its category, such as GTIN, MPN, and brand. Defaults to true, if not provided.
     "imageLink": "A String", # URL of an image of the item.
-    "includedDestinations": [ # The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
+    "includedDestinations": [ # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
       "A String",
     ],
     "installment": { # A message that represents installment. # Number and amount of installments to pay for an item.
@@ -1146,7 +1146,7 @@ 
Method Details

     "displayAdsTitle": "A String", # Title of an item for dynamic remarketing campaigns.
     "displayAdsValue": 3.14, # Offer margin for dynamic remarketing campaigns. For more information, see [Display ads attribute](https://support.google.com/merchants/answer/6069387).
     "energyEfficiencyClass": "A String", # The energy efficiency class as defined in EU directive 2010/30/EU.
-    "excludedDestinations": [ # The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
+    "excludedDestinations": [ # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
       "A String",
     ],
     "expirationDate": "A String", # Date on which the item should expire, as specified upon insertion, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. The actual expiration date is exposed in `productstatuses` as [googleExpirationDate](https://support.google.com/merchants/answer/6324499) and might be earlier if `expirationDate` is too far in the future.
@@ -1170,7 +1170,7 @@ 
Method Details

     ],
     "identifierExists": True or False, # Set this value to false when the item does not have unique product identifiers appropriate to its category, such as GTIN, MPN, and brand. Defaults to true, if not provided.
     "imageLink": "A String", # URL of an image of the item.
-    "includedDestinations": [ # The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
+    "includedDestinations": [ # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
       "A String",
     ],
     "installment": { # A message that represents installment. # Number and amount of installments to pay for an item.
diff --git a/docs/dyn/merchantapi_products_v1beta.accounts.products.html b/docs/dyn/merchantapi_products_v1beta.accounts.products.html
index 3baed065169..e806cede6fd 100644
--- a/docs/dyn/merchantapi_products_v1beta.accounts.products.html
+++ b/docs/dyn/merchantapi_products_v1beta.accounts.products.html
@@ -173,7 +173,7 @@ 
Method Details

     "displayAdsTitle": "A String", # Title of an item for dynamic remarketing campaigns.
     "displayAdsValue": 3.14, # Offer margin for dynamic remarketing campaigns. For more information, see [Display ads attribute](https://support.google.com/merchants/answer/6069387).
     "energyEfficiencyClass": "A String", # The energy efficiency class as defined in EU directive 2010/30/EU.
-    "excludedDestinations": [ # The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
+    "excludedDestinations": [ # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
       "A String",
     ],
     "expirationDate": "A String", # Date on which the item should expire, as specified upon insertion, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. The actual expiration date is exposed in `productstatuses` as [googleExpirationDate](https://support.google.com/merchants/answer/6324499) and might be earlier if `expirationDate` is too far in the future.
@@ -197,7 +197,7 @@ 
Method Details

     ],
     "identifierExists": True or False, # Set this value to false when the item does not have unique product identifiers appropriate to its category, such as GTIN, MPN, and brand. Defaults to true, if not provided.
     "imageLink": "A String", # URL of an image of the item.
-    "includedDestinations": [ # The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
+    "includedDestinations": [ # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
       "A String",
     ],
     "installment": { # A message that represents installment. # Number and amount of installments to pay for an item.
@@ -551,7 +551,7 @@ 
Method Details

         "displayAdsTitle": "A String", # Title of an item for dynamic remarketing campaigns.
         "displayAdsValue": 3.14, # Offer margin for dynamic remarketing campaigns. For more information, see [Display ads attribute](https://support.google.com/merchants/answer/6069387).
         "energyEfficiencyClass": "A String", # The energy efficiency class as defined in EU directive 2010/30/EU.
-        "excludedDestinations": [ # The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
+        "excludedDestinations": [ # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
           "A String",
         ],
         "expirationDate": "A String", # Date on which the item should expire, as specified upon insertion, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. The actual expiration date is exposed in `productstatuses` as [googleExpirationDate](https://support.google.com/merchants/answer/6324499) and might be earlier if `expirationDate` is too far in the future.
@@ -575,7 +575,7 @@ 
Method Details

         ],
         "identifierExists": True or False, # Set this value to false when the item does not have unique product identifiers appropriate to its category, such as GTIN, MPN, and brand. Defaults to true, if not provided.
         "imageLink": "A String", # URL of an image of the item.
-        "includedDestinations": [ # The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
+        "includedDestinations": [ # Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.
           "A String",
         ],
         "installment": { # A message that represents installment. # Number and amount of installments to pay for an item.
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json b/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json
index 9a64e31b233..ba552462560 100644
--- a/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json
+++ b/googleapiclient/discovery_cache/documents/merchantapi.accounts_v1beta.json
@@ -180,31 +180,6 @@
 "https://www.googleapis.com/auth/content"
 ]
 },
-"getDeveloperRegistration": {
-"description": "Retrieves a developer registration for a merchant.",
-"flatPath": "accounts/v1beta/accounts/{accountsId}/developerRegistration",
-"httpMethod": "GET",
-"id": "merchantapi.accounts.getDeveloperRegistration",
-"parameterOrder": [
-"name"
-],
-"parameters": {
-"name": {
-"description": "Required. The `name` (ID) of the developer registration.",
-"location": "path",
-"pattern": "^accounts/[^/]+/developerRegistration$",
-"required": true,
-"type": "string"
-}
-},
-"path": "accounts/v1beta/{+name}",
-"response": {
-"$ref": "DeveloperRegistration"
-},
-"scopes": [
-"https://www.googleapis.com/auth/content"
-]
-},
 "list": {
 "description": "Note: For the `accounts.list` method, quota and limits usage are charged for each user, and not for the Merchant Center ID or the advanced account ID. To list several sub-accounts, you should use the `accounts.listSubaccounts` method, which is more suitable for advanced accounts use case.",
 "flatPath": "accounts/v1beta/accounts",
@@ -563,6 +538,31 @@
 },
 "developerRegistration": {
 "methods": {
+"getDeveloperRegistration": {
+"description": "Retrieves a developer registration for a merchant.",
+"flatPath": "accounts/v1beta/accounts/{accountsId}/developerRegistration",
+"httpMethod": "GET",
+"id": "merchantapi.accounts.developerRegistration.getDeveloperRegistration",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. The `name` (ID) of the developer registration.",
+"location": "path",
+"pattern": "^accounts/[^/]+/developerRegistration$",
+"required": true,
+"type": "string"
+}
+},
+"path": "accounts/v1beta/{+name}",
+"response": {
+"$ref": "DeveloperRegistration"
+},
+"scopes": [
+"https://www.googleapis.com/auth/content"
+]
+},
 "registerGcp": {
 "description": "Registers the GCP used for the API call to the shopping account passed in the request. Will create a user with an \"API developer\" and add the \"developer_email\" as a contact with \"API notifications\" email preference on.",
 "flatPath": "accounts/v1beta/accounts/{accountsId}/developerRegistration:registerGcp",
@@ -582,7 +582,7 @@
 },
 "path": "accounts/v1beta/{+name}:registerGcp",
 "request": {
-"$ref": "RegisterGCPRequest"
+"$ref": "RegisterGcpRequest"
 },
 "response": {
 "$ref": "DeveloperRegistration"
@@ -610,7 +610,7 @@
 },
 "path": "accounts/v1beta/{+name}:unregisterGcp",
 "request": {
-"$ref": "UnregisterGCPRequest"
+"$ref": "UnregisterGcpRequest"
 },
 "response": {
 "$ref": "Empty"
@@ -2311,7 +2311,7 @@
 }
 }
 },
-"revision": "20250715",
+"revision": "20250721",
 "rootUrl": "https://merchantapi.googleapis.com/",
 "schemas": {
 "About": {
@@ -4766,9 +4766,9 @@ false
 },
 "type": "object"
 },
-"RegisterGCPRequest": {
+"RegisterGcpRequest": {
 "description": "Request message for the RegisterGCP method.",
-"id": "RegisterGCPRequest",
+"id": "RegisterGcpRequest",
 "properties": {
 "developerEmail": {
 "description": "Immutable. If the developer email provided is associated with a user in the merchant account provided, the user will be updated to have \"API developer\" access type and the email preference corresponding to that user will be updated to have the new \"API notifications\" preference. If the developer email provided is not associated with any user we will just add it as a contact. The email preference corresponding to that contact will have the new \"API notifications\" preference",
@@ -5268,9 +5268,9 @@ false
 "properties": {},
 "type": "object"
 },
-"UnregisterGCPRequest": {
+"UnregisterGcpRequest": {
 "description": "Request message for the UnregisterGCP method.",
-"id": "UnregisterGCPRequest",
+"id": "UnregisterGcpRequest",
 "properties": {},
 "type": "object"
 },
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.datasources_v1beta.json b/googleapiclient/discovery_cache/documents/merchantapi.datasources_v1beta.json
index 0365c05dfb2..4b74f227978 100644
--- a/googleapiclient/discovery_cache/documents/merchantapi.datasources_v1beta.json
+++ b/googleapiclient/discovery_cache/documents/merchantapi.datasources_v1beta.json
@@ -321,7 +321,7 @@
 }
 }
 },
-"revision": "20250710",
+"revision": "20250721",
 "rootUrl": "https://merchantapi.googleapis.com/",
 "schemas": {
 "DataSource": {
@@ -592,7 +592,7 @@
 "File input type unspecified.",
 "The file is uploaded through SFTP, Google Cloud Storage or manually in the Merchant Center.",
 "The file is fetched from the configured fetch_uri.",
-"The file is fetched from Google Sheets specified in the fetch_uri."
+"The file is fetched from Google Sheets specified in the fetch_uri. However, you can't set up `GOOGLE_SHEETS` as a data source through the API. To add `GOOGLE_SHEETS` as a data source through the Merchant Center, see [Add products to Merchant Center](https://support.google.com/merchants/answer/12158053)."
 ],
 "readOnly": true,
 "type": "string"
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.inventories_v1beta.json b/googleapiclient/discovery_cache/documents/merchantapi.inventories_v1beta.json
index fedf21f9fb7..23489f298e2 100644
--- a/googleapiclient/discovery_cache/documents/merchantapi.inventories_v1beta.json
+++ b/googleapiclient/discovery_cache/documents/merchantapi.inventories_v1beta.json
@@ -300,7 +300,7 @@
 }
 }
 },
-"revision": "20250623",
+"revision": "20250721",
 "rootUrl": "https://merchantapi.googleapis.com/",
 "schemas": {
 "CustomAttribute": {
@@ -399,6 +399,7 @@
 "type": "string"
 },
 "customAttributes": {
+"deprecated": true,
 "description": "A list of custom (merchant-provided) attributes. You can also use `CustomAttribute` to submit any attribute of the data specification in its generic form.",
 "items": {
 "$ref": "CustomAttribute"
@@ -627,6 +628,7 @@ false
 "type": "string"
 },
 "customAttributes": {
+"deprecated": true,
 "description": "A list of custom (merchant-provided) attributes. You can also use `CustomAttribute` to submit any attribute of the data specification in its generic form.",
 "items": {
 "$ref": "CustomAttribute"
diff --git a/googleapiclient/discovery_cache/documents/merchantapi.products_v1beta.json b/googleapiclient/discovery_cache/documents/merchantapi.products_v1beta.json
index aedc653e551..0cd592c2deb 100644
--- a/googleapiclient/discovery_cache/documents/merchantapi.products_v1beta.json
+++ b/googleapiclient/discovery_cache/documents/merchantapi.products_v1beta.json
@@ -281,7 +281,7 @@
 }
 }
 },
-"revision": "20250716",
+"revision": "20250724",
 "rootUrl": "https://merchantapi.googleapis.com/",
 "schemas": {
 "Attributes": {
@@ -423,7 +423,7 @@
 "type": "string"
 },
 "excludedDestinations": {
-"description": "The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.",
+"description": "Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center). For more information, see [Excluded destination](https://support.google.com/merchants/answer/6324486). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.",
 "items": {
 "type": "string"
 },
@@ -477,7 +477,7 @@
 "type": "string"
 },
 "includedDestinations": {
-"description": "The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.",
+"description": "Destinations also known as [Marketing methods](https://support.google.com/merchants/answer/15130232) selections. The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. For more information, see [Included destination](https://support.google.com/merchants/answer/7501026). Note: We recommend setting destinations on datasources level for most use cases. Use this field within products to only setup exceptions.",
 "items": {
 "type": "string"
 },

From bc72a5e3f7fd087f800fc3a2ced23bcf62471b5c Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:13 +0000
Subject: [PATCH 20/36] fix(migrationcenter): update the api

#### migrationcenter:v1alpha1

The following keys were changed:
- schemas.OutputFile.properties.fileSizeBytes (Total Keys: 2)
---
 ...center_v1alpha1.projects.locations.assetsExportJobs.html | 6 +++---
 .../discovery_cache/documents/migrationcenter.v1alpha1.json | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/dyn/migrationcenter_v1alpha1.projects.locations.assetsExportJobs.html b/docs/dyn/migrationcenter_v1alpha1.projects.locations.assetsExportJobs.html
index d13fbe11ba0..7134397da97 100644
--- a/docs/dyn/migrationcenter_v1alpha1.projects.locations.assetsExportJobs.html
+++ b/docs/dyn/migrationcenter_v1alpha1.projects.locations.assetsExportJobs.html
@@ -154,7 +154,7 @@ 
Method Details

                   "uri": "A String", # Output only. Download URI for the file.
                 },
               },
-              "fileSizeBytes": 42, # Output only. File size in bytes.
+              "fileSizeBytes": "A String", # Output only. File size in bytes.
               "xlsxOutputFile": { # Contains a single output file of type XLSX. # Output only. XLSX output file.
                 "signedUri": { # Contains a signed URI. # Output only. Signed URI destination.
                   "file": "A String", # Output only. Name of the file the Signed URI references.
@@ -307,7 +307,7 @@ 
Method Details

                   "uri": "A String", # Output only. Download URI for the file.
                 },
               },
-              "fileSizeBytes": 42, # Output only. File size in bytes.
+              "fileSizeBytes": "A String", # Output only. File size in bytes.
               "xlsxOutputFile": { # Contains a single output file of type XLSX. # Output only. XLSX output file.
                 "signedUri": { # Contains a signed URI. # Output only. Signed URI destination.
                   "file": "A String", # Output only. Name of the file the Signed URI references.
@@ -399,7 +399,7 @@ 
Method Details

                       "uri": "A String", # Output only. Download URI for the file.
                     },
                   },
-                  "fileSizeBytes": 42, # Output only. File size in bytes.
+                  "fileSizeBytes": "A String", # Output only. File size in bytes.
                   "xlsxOutputFile": { # Contains a single output file of type XLSX. # Output only. XLSX output file.
                     "signedUri": { # Contains a signed URI. # Output only. Signed URI destination.
                       "file": "A String", # Output only. Name of the file the Signed URI references.
diff --git a/googleapiclient/discovery_cache/documents/migrationcenter.v1alpha1.json b/googleapiclient/discovery_cache/documents/migrationcenter.v1alpha1.json
index 7b5f9b4d995..f31cc8b37c9 100644
--- a/googleapiclient/discovery_cache/documents/migrationcenter.v1alpha1.json
+++ b/googleapiclient/discovery_cache/documents/migrationcenter.v1alpha1.json
@@ -2554,7 +2554,7 @@
 }
 }
 },
-"revision": "20250710",
+"revision": "20250724",
 "rootUrl": "https://migrationcenter.googleapis.com/",
 "schemas": {
 "AddAssetsToGroupRequest": {
@@ -6874,9 +6874,9 @@ false
 },
 "fileSizeBytes": {
 "description": "Output only. File size in bytes.",
-"format": "int32",
+"format": "int64",
 "readOnly": true,
-"type": "integer"
+"type": "string"
 },
 "xlsxOutputFile": {
 "$ref": "XlsxOutputFile",

From d6444351b59d618a78da998e0bdc0812be63c37b Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:13 +0000
Subject: [PATCH 21/36] feat(mybusinessbusinessinformation): update the api

#### mybusinessbusinessinformation:v1

The following keys were added:
- schemas.Metadata.properties.isParticularlyPersonalPlace (Total Keys: 2)
---
 ...ybusinessbusinessinformation_v1.accounts.locations.html | 3 +++
 .../mybusinessbusinessinformation_v1.googleLocations.html  | 2 ++
 docs/dyn/mybusinessbusinessinformation_v1.locations.html   | 4 ++++
 .../documents/mybusinessbusinessinformation.v1.json        | 7 ++++++-
 4 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/mybusinessbusinessinformation_v1.accounts.locations.html b/docs/dyn/mybusinessbusinessinformation_v1.accounts.locations.html
index b7e1382c44e..92a09e6114a 100644
--- a/docs/dyn/mybusinessbusinessinformation_v1.accounts.locations.html
+++ b/docs/dyn/mybusinessbusinessinformation_v1.accounts.locations.html
@@ -163,6 +163,7 @@ 
Method Details

     "hasGoogleUpdated": True or False, # Output only. Indicates whether the place ID associated with this location has updates that need to be updated or rejected by the client. If this boolean is set, you should call the `getGoogleUpdated` method to lookup information that's needs to be verified.
     "hasPendingEdits": True or False, # Output only. Indicates whether any of this Location's properties are in the edit pending state.
     "hasVoiceOfMerchant": True or False, # Output only. Indicates if the listing has Voice of Merchant. If this boolean is false, you should call the locations.getVoiceOfMerchantState API to get details as to why they do not have Voice of Merchant.
+    "isParticularlyPersonalPlace": True or False, # Output only.
     "mapsUri": "A String", # Output only. A link to the location on Maps.
     "newReviewUri": "A String", # Output only. A link to the page on Google Search where a customer can leave a review for the location.
     "placeId": "A String", # Output only. If this locationappears on Google Maps, this field is populated with the place ID for the location. This ID can be used in various Places APIs. This field can be set during Create calls, but not for Update.
@@ -398,6 +399,7 @@ 
Method Details

     "hasGoogleUpdated": True or False, # Output only. Indicates whether the place ID associated with this location has updates that need to be updated or rejected by the client. If this boolean is set, you should call the `getGoogleUpdated` method to lookup information that's needs to be verified.
     "hasPendingEdits": True or False, # Output only. Indicates whether any of this Location's properties are in the edit pending state.
     "hasVoiceOfMerchant": True or False, # Output only. Indicates if the listing has Voice of Merchant. If this boolean is false, you should call the locations.getVoiceOfMerchantState API to get details as to why they do not have Voice of Merchant.
+    "isParticularlyPersonalPlace": True or False, # Output only.
     "mapsUri": "A String", # Output only. A link to the location on Maps.
     "newReviewUri": "A String", # Output only. A link to the page on Google Search where a customer can leave a review for the location.
     "placeId": "A String", # Output only. If this locationappears on Google Maps, this field is populated with the place ID for the location. This ID can be used in various Places APIs. This field can be set during Create calls, but not for Update.
@@ -645,6 +647,7 @@ 
Method Details

         "hasGoogleUpdated": True or False, # Output only. Indicates whether the place ID associated with this location has updates that need to be updated or rejected by the client. If this boolean is set, you should call the `getGoogleUpdated` method to lookup information that's needs to be verified.
         "hasPendingEdits": True or False, # Output only. Indicates whether any of this Location's properties are in the edit pending state.
         "hasVoiceOfMerchant": True or False, # Output only. Indicates if the listing has Voice of Merchant. If this boolean is false, you should call the locations.getVoiceOfMerchantState API to get details as to why they do not have Voice of Merchant.
+        "isParticularlyPersonalPlace": True or False, # Output only.
         "mapsUri": "A String", # Output only. A link to the location on Maps.
         "newReviewUri": "A String", # Output only. A link to the page on Google Search where a customer can leave a review for the location.
         "placeId": "A String", # Output only. If this locationappears on Google Maps, this field is populated with the place ID for the location. This ID can be used in various Places APIs. This field can be set during Create calls, but not for Update.
diff --git a/docs/dyn/mybusinessbusinessinformation_v1.googleLocations.html b/docs/dyn/mybusinessbusinessinformation_v1.googleLocations.html
index 7703a95df1e..09e4a9817fa 100644
--- a/docs/dyn/mybusinessbusinessinformation_v1.googleLocations.html
+++ b/docs/dyn/mybusinessbusinessinformation_v1.googleLocations.html
@@ -157,6 +157,7 @@ 
Method Details

       "hasGoogleUpdated": True or False, # Output only. Indicates whether the place ID associated with this location has updates that need to be updated or rejected by the client. If this boolean is set, you should call the `getGoogleUpdated` method to lookup information that's needs to be verified.
       "hasPendingEdits": True or False, # Output only. Indicates whether any of this Location's properties are in the edit pending state.
       "hasVoiceOfMerchant": True or False, # Output only. Indicates if the listing has Voice of Merchant. If this boolean is false, you should call the locations.getVoiceOfMerchantState API to get details as to why they do not have Voice of Merchant.
+      "isParticularlyPersonalPlace": True or False, # Output only.
       "mapsUri": "A String", # Output only. A link to the location on Maps.
       "newReviewUri": "A String", # Output only. A link to the page on Google Search where a customer can leave a review for the location.
       "placeId": "A String", # Output only. If this locationappears on Google Maps, this field is populated with the place ID for the location. This ID can be used in various Places APIs. This field can be set during Create calls, but not for Update.
@@ -396,6 +397,7 @@ 
Method Details

           "hasGoogleUpdated": True or False, # Output only. Indicates whether the place ID associated with this location has updates that need to be updated or rejected by the client. If this boolean is set, you should call the `getGoogleUpdated` method to lookup information that's needs to be verified.
           "hasPendingEdits": True or False, # Output only. Indicates whether any of this Location's properties are in the edit pending state.
           "hasVoiceOfMerchant": True or False, # Output only. Indicates if the listing has Voice of Merchant. If this boolean is false, you should call the locations.getVoiceOfMerchantState API to get details as to why they do not have Voice of Merchant.
+          "isParticularlyPersonalPlace": True or False, # Output only.
           "mapsUri": "A String", # Output only. A link to the location on Maps.
           "newReviewUri": "A String", # Output only. A link to the page on Google Search where a customer can leave a review for the location.
           "placeId": "A String", # Output only. If this locationappears on Google Maps, this field is populated with the place ID for the location. This ID can be used in various Places APIs. This field can be set during Create calls, but not for Update.
diff --git a/docs/dyn/mybusinessbusinessinformation_v1.locations.html b/docs/dyn/mybusinessbusinessinformation_v1.locations.html
index 03a7e38ea4e..f4c78e214d5 100644
--- a/docs/dyn/mybusinessbusinessinformation_v1.locations.html
+++ b/docs/dyn/mybusinessbusinessinformation_v1.locations.html
@@ -201,6 +201,7 @@ 
Method Details

     "hasGoogleUpdated": True or False, # Output only. Indicates whether the place ID associated with this location has updates that need to be updated or rejected by the client. If this boolean is set, you should call the `getGoogleUpdated` method to lookup information that's needs to be verified.
     "hasPendingEdits": True or False, # Output only. Indicates whether any of this Location's properties are in the edit pending state.
     "hasVoiceOfMerchant": True or False, # Output only. Indicates if the listing has Voice of Merchant. If this boolean is false, you should call the locations.getVoiceOfMerchantState API to get details as to why they do not have Voice of Merchant.
+    "isParticularlyPersonalPlace": True or False, # Output only.
     "mapsUri": "A String", # Output only. A link to the location on Maps.
     "newReviewUri": "A String", # Output only. A link to the page on Google Search where a customer can leave a review for the location.
     "placeId": "A String", # Output only. If this locationappears on Google Maps, this field is populated with the place ID for the location. This ID can be used in various Places APIs. This field can be set during Create calls, but not for Update.
@@ -485,6 +486,7 @@ 
Method Details

       "hasGoogleUpdated": True or False, # Output only. Indicates whether the place ID associated with this location has updates that need to be updated or rejected by the client. If this boolean is set, you should call the `getGoogleUpdated` method to lookup information that's needs to be verified.
       "hasPendingEdits": True or False, # Output only. Indicates whether any of this Location's properties are in the edit pending state.
       "hasVoiceOfMerchant": True or False, # Output only. Indicates if the listing has Voice of Merchant. If this boolean is false, you should call the locations.getVoiceOfMerchantState API to get details as to why they do not have Voice of Merchant.
+      "isParticularlyPersonalPlace": True or False, # Output only.
       "mapsUri": "A String", # Output only. A link to the location on Maps.
       "newReviewUri": "A String", # Output only. A link to the page on Google Search where a customer can leave a review for the location.
       "placeId": "A String", # Output only. If this locationappears on Google Maps, this field is populated with the place ID for the location. This ID can be used in various Places APIs. This field can be set during Create calls, but not for Update.
@@ -722,6 +724,7 @@ 
Method Details

     "hasGoogleUpdated": True or False, # Output only. Indicates whether the place ID associated with this location has updates that need to be updated or rejected by the client. If this boolean is set, you should call the `getGoogleUpdated` method to lookup information that's needs to be verified.
     "hasPendingEdits": True or False, # Output only. Indicates whether any of this Location's properties are in the edit pending state.
     "hasVoiceOfMerchant": True or False, # Output only. Indicates if the listing has Voice of Merchant. If this boolean is false, you should call the locations.getVoiceOfMerchantState API to get details as to why they do not have Voice of Merchant.
+    "isParticularlyPersonalPlace": True or False, # Output only.
     "mapsUri": "A String", # Output only. A link to the location on Maps.
     "newReviewUri": "A String", # Output only. A link to the page on Google Search where a customer can leave a review for the location.
     "placeId": "A String", # Output only. If this locationappears on Google Maps, this field is populated with the place ID for the location. This ID can be used in various Places APIs. This field can be set during Create calls, but not for Update.
@@ -957,6 +960,7 @@ 
Method Details

     "hasGoogleUpdated": True or False, # Output only. Indicates whether the place ID associated with this location has updates that need to be updated or rejected by the client. If this boolean is set, you should call the `getGoogleUpdated` method to lookup information that's needs to be verified.
     "hasPendingEdits": True or False, # Output only. Indicates whether any of this Location's properties are in the edit pending state.
     "hasVoiceOfMerchant": True or False, # Output only. Indicates if the listing has Voice of Merchant. If this boolean is false, you should call the locations.getVoiceOfMerchantState API to get details as to why they do not have Voice of Merchant.
+    "isParticularlyPersonalPlace": True or False, # Output only.
     "mapsUri": "A String", # Output only. A link to the location on Maps.
     "newReviewUri": "A String", # Output only. A link to the page on Google Search where a customer can leave a review for the location.
     "placeId": "A String", # Output only. If this locationappears on Google Maps, this field is populated with the place ID for the location. This ID can be used in various Places APIs. This field can be set during Create calls, but not for Update.
diff --git a/googleapiclient/discovery_cache/documents/mybusinessbusinessinformation.v1.json b/googleapiclient/discovery_cache/documents/mybusinessbusinessinformation.v1.json
index 983900128e9..978550bc610 100644
--- a/googleapiclient/discovery_cache/documents/mybusinessbusinessinformation.v1.json
+++ b/googleapiclient/discovery_cache/documents/mybusinessbusinessinformation.v1.json
@@ -612,7 +612,7 @@
 }
 }
 },
-"revision": "20250618",
+"revision": "20250723",
 "rootUrl": "https://mybusinessbusinessinformation.googleapis.com/",
 "schemas": {
 "AdWordsLocationExtensions": {
@@ -1228,6 +1228,11 @@
 "readOnly": true,
 "type": "boolean"
 },
+"isParticularlyPersonalPlace": {
+"description": "Output only.",
+"readOnly": true,
+"type": "boolean"
+},
 "mapsUri": {
 "description": "Output only. A link to the location on Maps.",
 "readOnly": true,

From 6b090afec29a0191a74a3570de4c10d5c6e9ef0d Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:13 +0000
Subject: [PATCH 22/36] feat(mybusinessverifications): update the api

#### mybusinessverifications:v1

The following keys were added:
- resources.verificationTokens.methods.generate (Total Keys: 7)
- schemas.GenerateInstantVerificationTokenRequest (Total Keys: 4)
- schemas.GenerateInstantVerificationTokenResponse (Total Keys: 5)
- schemas.LocationData (Total Keys: 4)
---
 docs/dyn/mybusinessverifications_v1.html      |  5 ++
 ...ssverifications_v1.verificationTokens.html | 35 ++++-----
 .../documents/mybusinessverifications.v1.json | 77 ++++++++++++++++++-
 3 files changed, 97 insertions(+), 20 deletions(-)

diff --git a/docs/dyn/mybusinessverifications_v1.html b/docs/dyn/mybusinessverifications_v1.html
index 845b58bbde8..136fdd18ce3 100644
--- a/docs/dyn/mybusinessverifications_v1.html
+++ b/docs/dyn/mybusinessverifications_v1.html
@@ -79,6 +79,11 @@ 
Instance Methods

 

 
Returns the locations Resource.

 
+

+  verificationTokens()
+

+
Returns the verificationTokens Resource.

+
 

   close()

 
Close httplib2 connections.

diff --git a/docs/dyn/mybusinessverifications_v1.verificationTokens.html b/docs/dyn/mybusinessverifications_v1.verificationTokens.html
index c4cf2a0ac72..243615dbf05 100644
--- a/docs/dyn/mybusinessverifications_v1.verificationTokens.html
+++ b/docs/dyn/mybusinessverifications_v1.verificationTokens.html
@@ -79,7 +79,7 @@ 
Instance Methods

 
Close httplib2 connections.

 

   generate(body=None, x__xgafv=None)

-
Generates a token for the provided location data as a vetted [partner](https://support.google.com/business/answer/7674102). Throws PERMISSION_DENIED if the caller is not a vetted partner account. Throws FAILED_PRECONDITION if the caller's VettedStatus is INVALID.

+
Generate a token for the provided location data to verify the location.

 
Method Details

 

     close()
@@ -88,36 +88,34 @@ 
Method Details

 
 

     generate(body=None, x__xgafv=None)
-  
Generates a token for the provided location data as a vetted [partner](https://support.google.com/business/answer/7674102). Throws PERMISSION_DENIED if the caller is not a vetted partner account. Throws FAILED_PRECONDITION if the caller's VettedStatus is INVALID.
+  
Generate a token for the provided location data to verify the location.
 
 Args:
   body: object, The request body.
     The object takes the form of:
 
-{ # Request message for Verifications.GenerateVerificationToken.
-  "location": { # A subset of location info. See the [help center article] (https://support.google.com/business/answer/3038177) for a detailed description of these fields, or the [category endpoint](/my-business/reference/rest/v4/categories) for a list of valid business categories. # Required. The target location. Note: The location information should exactly match the target Location, otherwise the generated verification token won't be able to verify the target Location.
-    "address": { # Represents a postal address, e.g. for postal delivery or payments addresses. Given a postal address, a postal service can deliver items to a premise, P.O. Box or similar. It is not intended to model geographical locations (roads, towns, mountains). In typical usage an address would be created via user input or from importing existing data, depending on the type of process. Advice on address input / editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput) - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, please see: https://support.google.com/business/answer/6397478 # Required. A precise, accurate address to describe your business location. PO boxes or mailboxes located at remote locations are not acceptable. At this time, you can specify a maximum of five `address_lines` values in the address.
-      "addressLines": [ # Unstructured address lines describing the lower levels of an address. Because values in address_lines do not have type information and may sometimes contain multiple values in a single field (e.g. "Austin, TX"), it is important that the line order is clear. The order of address lines should be "envelope order" for the country/region of the address. In places where this can vary (e.g. Japan), address_language is used to make it explicit (e.g. "ja" for large-to-small ordering and "ja-Latn" or "en" for small-to-large). This way, the most specific line of an address can be selected based on the language. The minimum permitted structural representation of an address consists of a region_code with all remaining information placed in the address_lines. It would be possible to format such an address very approximately without geocoding, but no semantic reasoning could be made about any of the address components until it was at least partially resolved. Creating an address only containing a region_code and address_lines, and then geocoding is the recommended way to handle completely unstructured addresses (as opposed to guessing which parts of the address should be localities or administrative areas).
+{ # Request message for Verifications.GenerateInstantVerificationToken.
+  "locationData": { # The address and other details of the location to generate an instant verification token for. # Immutable. The address and other details of the location to generate an instant verification token for.
+    "address": { # Represents a postal address, such as for postal delivery or payments addresses. With a postal address, a postal service can deliver items to a premise, P.O. box, or similar. A postal address is not intended to model geographical locations like roads, towns, or mountains. In typical usage, an address would be created by user input or from importing existing data, depending on the type of process. Advice on address input or editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput. - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, see: https://support.google.com/business/answer/6397478. # Immutable. A precise, accurate address to describe your business location. PO boxes or mailboxes located at remote locations are not acceptable. At this time, you can specify a maximum of five `address_lines` values in the address.
+      "addressLines": [ # Unstructured address lines describing the lower levels of an address. Because values in `address_lines` do not have type information and may sometimes contain multiple values in a single field (for example, "Austin, TX"), it is important that the line order is clear. The order of address lines should be "envelope order" for the country or region of the address. In places where this can vary (for example, Japan), `address_language` is used to make it explicit (for example, "ja" for large-to-small ordering and "ja-Latn" or "en" for small-to-large). In this way, the most specific line of an address can be selected based on the language. The minimum permitted structural representation of an address consists of a `region_code` with all remaining information placed in the `address_lines`. It would be possible to format such an address very approximately without geocoding, but no semantic reasoning could be made about any of the address components until it was at least partially resolved. Creating an address only containing a `region_code` and `address_lines` and then geocoding is the recommended way to handle completely unstructured addresses (as opposed to guessing which parts of the address should be localities or administrative areas).
         "A String",
       ],
-      "administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal addresses of a country or region. For example, this can be a state, a province, an oblast, or a prefecture. Specifically, for Spain this is the province and not the autonomous community (e.g. "Barcelona" and not "Catalonia"). Many countries don't use an administrative area in postal addresses. E.g. in Switzerland this should be left unpopulated.
+      "administrativeArea": "A String", # Optional. Highest administrative subdivision which is used for postal addresses of a country or region. For example, this can be a state, a province, an oblast, or a prefecture. For Spain, this is the province and not the autonomous community (for example, "Barcelona" and not "Catalonia"). Many countries don't use an administrative area in postal addresses. For example, in Switzerland, this should be left unpopulated.
       "languageCode": "A String", # Optional. BCP-47 language code of the contents of this address (if known). This is often the UI language of the input form or is expected to match one of the languages used in the address' country/region, or their transliterated equivalents. This can affect formatting in certain countries, but is not critical to the correctness of the data and will never affect any validation or other non-formatting related operations. If this value is not known, it should be omitted (rather than specifying a possibly incorrect default). Examples: "zh-Hant", "ja", "ja-Latn", "en".
-      "locality": "A String", # Optional. Generally refers to the city/town portion of the address. Examples: US city, IT comune, UK post town. In regions of the world where localities are not well defined or do not fit into this structure well, leave locality empty and use address_lines.
+      "locality": "A String", # Optional. Generally refers to the city or town portion of the address. Examples: US city, IT comune, UK post town. In regions of the world where localities are not well defined or do not fit into this structure well, leave `locality` empty and use `address_lines`.
       "organization": "A String", # Optional. The name of the organization at the address.
-      "postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (e.g. state/zip validation in the U.S.A.).
+      "postalCode": "A String", # Optional. Postal code of the address. Not all countries use or require postal codes to be present, but where they are used, they may trigger additional validation with other parts of the address (for example, state or zip code validation in the United States).
       "recipients": [ # Optional. The recipient at the address. This field may, under certain circumstances, contain multiline information. For example, it might contain "care of" information.
         "A String",
       ],
       "regionCode": "A String", # Required. CLDR region code of the country/region of the address. This is never inferred and it is up to the user to ensure the value is correct. See https://cldr.unicode.org/ and https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html for details. Example: "CH" for Switzerland.
       "revision": 42, # The schema revision of the `PostalAddress`. This must be set to 0, which is the latest revision. All new revisions **must** be backward compatible with old revisions.
-      "sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used in most regions. Where it is used, the value is either a string like "CEDEX", optionally followed by a number (e.g. "CEDEX 7"), or just a number alone, representing the "sector code" (Jamaica), "delivery area indicator" (Malawi) or "post office indicator" (e.g. Côte d'Ivoire).
-      "sublocality": "A String", # Optional. Sublocality of the address. For example, this can be neighborhoods, boroughs, districts.
+      "sortingCode": "A String", # Optional. Additional, country-specific, sorting code. This is not used in most regions. Where it is used, the value is either a string like "CEDEX", optionally followed by a number (for example, "CEDEX 7"), or just a number alone, representing the "sector code" (Jamaica), "delivery area indicator" (Malawi) or "post office indicator" (Côte d'Ivoire).
+      "sublocality": "A String", # Optional. Sublocality of the address. For example, this can be a neighborhood, borough, or district.
     },
-    "name": "A String", # Required. Location name should reflect your business's real-world name, as used consistently on your storefront, website, and stationery, and as known to customers. Any additional information, when relevant, can be included in other fields of the resource (for example, `Address`, `Categories`). Don't add unnecessary information to your name (for example, prefer "Google" over "Google Inc. - Mountain View Corporate Headquarters"). Don't include marketing taglines, store codes, special characters, hours or closed/open status, phone numbers, website URLs, service/product information, location/address or directions, or containment information (for example, "Chase ATM in Duane Reade").
-    "primaryCategoryId": "A String", # Required. Id of the category that best describes the core business this location engages in. e.g. gcid:bakery.
-    "primaryPhone": "A String", # Optional. A phone number that connects to your individual business location as directly as possible. Use a local phone number instead of a central, call center helpline number whenever possible.
-    "websiteUri": "A String", # Optional. A URL for this business. If possible, use a URL that represents this individual business location instead of a generic website/URL that represents all locations, or the brand.
+    "name": "A String", # Immutable. Name should reflect your business's real-world name, as used consistently on your storefront, website, and stationery, and as known to customers. Any additional information, when relevant, can be included in other fields of the resource (for example, `Address`, `Categories`). Don't add unnecessary information to your name (for example, prefer "Google" over "Google Inc. - Mountain View Corporate Headquarters"). Don't include marketing taglines, store codes, special characters, hours or closed/open status, phone numbers, website URLs, service/product information, location/address or directions, or containment information (for example, "Chase ATM in Duane Reade").
   },
+  "locationId": "A String", # The location identifier associated with an unverified listing. This is the location id generated at the time that the listing was originally created. It is the final portion of a location resource name as generated by the Google My Business API. Note: the caller must be an owner or manager of this listing in order to generate a verification token. See the [location resource](/my-business/reference/rest/v4/accounts.locations) documentation for more information.
 }
 
   x__xgafv: string, V1 error format.
@@ -128,10 +126,9 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # Response message for Verifications.GenerateVerificationToken.
-  "token": { # Token generated by a vetted [partner](https://support.google.com/business/answer/7674102). # The generated token to verify the location.
-    "tokenString": "A String", # The token string.
-  },
+    { # Response message for Verifications.GenerateInstantVerificationToken.
+  "instantVerificationToken": "A String", # The generated instant verification token.
+  "result": "A String", # Output only. The result of the instant verification token generation.
 }

 

 
diff --git a/googleapiclient/discovery_cache/documents/mybusinessverifications.v1.json b/googleapiclient/discovery_cache/documents/mybusinessverifications.v1.json
index 7da5b2561d6..9b66ad31052 100644
--- a/googleapiclient/discovery_cache/documents/mybusinessverifications.v1.json
+++ b/googleapiclient/discovery_cache/documents/mybusinessverifications.v1.json
@@ -235,9 +235,28 @@
 }
 }
 }
+},
+"verificationTokens": {
+"methods": {
+"generate": {
+"description": "Generate a token for the provided location data to verify the location.",
+"flatPath": "v1/verificationTokens:generate",
+"httpMethod": "POST",
+"id": "mybusinessverifications.verificationTokens.generate",
+"parameterOrder": [],
+"parameters": {},
+"path": "v1/verificationTokens:generate",
+"request": {
+"$ref": "GenerateInstantVerificationTokenRequest"
+},
+"response": {
+"$ref": "GenerateInstantVerificationTokenResponse"
+}
+}
+}
 }
 },
-"revision": "20250615",
+"revision": "20250721",
 "rootUrl": "https://mybusinessverifications.googleapis.com/",
 "schemas": {
 "AddressVerificationData": {
@@ -351,6 +370,47 @@
 },
 "type": "object"
 },
+"GenerateInstantVerificationTokenRequest": {
+"description": "Request message for Verifications.GenerateInstantVerificationToken.",
+"id": "GenerateInstantVerificationTokenRequest",
+"properties": {
+"locationData": {
+"$ref": "LocationData",
+"description": "Immutable. The address and other details of the location to generate an instant verification token for."
+},
+"locationId": {
+"description": "The location identifier associated with an unverified listing. This is the location id generated at the time that the listing was originally created. It is the final portion of a location resource name as generated by the Google My Business API. Note: the caller must be an owner or manager of this listing in order to generate a verification token. See the [location resource](/my-business/reference/rest/v4/accounts.locations) documentation for more information.",
+"type": "string"
+}
+},
+"type": "object"
+},
+"GenerateInstantVerificationTokenResponse": {
+"description": "Response message for Verifications.GenerateInstantVerificationToken.",
+"id": "GenerateInstantVerificationTokenResponse",
+"properties": {
+"instantVerificationToken": {
+"description": "The generated instant verification token.",
+"type": "string"
+},
+"result": {
+"description": "Output only. The result of the instant verification token generation.",
+"enum": [
+"RESULT_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value, will result in errors.",
+"The instant verification token was generated successfully.",
+"The instant verification token was not generated.."
+],
+"readOnly": true,
+"type": "string"
+}
+},
+"type": "object"
+},
 "ListVerificationsResponse": {
 "description": "Response message for Verifications.ListVerifications.",
 "id": "ListVerificationsResponse",
@@ -369,6 +429,21 @@
 },
 "type": "object"
 },
+"LocationData": {
+"description": "The address and other details of the location to generate an instant verification token for.",
+"id": "LocationData",
+"properties": {
+"address": {
+"$ref": "PostalAddress",
+"description": "Immutable. A precise, accurate address to describe your business location. PO boxes or mailboxes located at remote locations are not acceptable. At this time, you can specify a maximum of five `address_lines` values in the address."
+},
+"name": {
+"description": "Immutable. Name should reflect your business's real-world name, as used consistently on your storefront, website, and stationery, and as known to customers. Any additional information, when relevant, can be included in other fields of the resource (for example, `Address`, `Categories`). Don't add unnecessary information to your name (for example, prefer \"Google\" over \"Google Inc. - Mountain View Corporate Headquarters\"). Don't include marketing taglines, store codes, special characters, hours or closed/open status, phone numbers, website URLs, service/product information, location/address or directions, or containment information (for example, \"Chase ATM in Duane Reade\").",
+"type": "string"
+}
+},
+"type": "object"
+},
 "PostalAddress": {
 "description": "Represents a postal address, such as for postal delivery or payments addresses. With a postal address, a postal service can deliver items to a premise, P.O. box, or similar. A postal address is not intended to model geographical locations like roads, towns, or mountains. In typical usage, an address would be created by user input or from importing existing data, depending on the type of process. Advice on address input or editing: - Use an internationalization-ready address widget such as https://github.com/google/libaddressinput. - Users should not be presented with UI elements for input or editing of fields outside countries where that field is used. For more guidance on how to use this schema, see: https://support.google.com/business/answer/6397478.",
 "id": "PostalAddress",

From 88e3bf529e4bcdd3eb6c1caf54d596080c01131a Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:13 +0000
Subject: [PATCH 23/36] feat(networkmanagement): update the api

#### networkmanagement:v1

The following keys were deleted:
- schemas.Host.properties.cloudVpcId (Total Keys: 2)

The following keys were added:
- schemas.Host.properties.cloudVirtualNetworkIds (Total Keys: 3)
---
 ...s.networkMonitoringProviders.monitoringPoints.html |  8 ++++++--
 .../documents/networkmanagement.v1.json               | 11 +++++++----
 2 files changed, 13 insertions(+), 6 deletions(-)

diff --git a/docs/dyn/networkmanagement_v1.projects.locations.networkMonitoringProviders.monitoringPoints.html b/docs/dyn/networkmanagement_v1.projects.locations.networkMonitoringProviders.monitoringPoints.html
index 38d6675b7a3..151d65b8854 100644
--- a/docs/dyn/networkmanagement_v1.projects.locations.networkMonitoringProviders.monitoringPoints.html
+++ b/docs/dyn/networkmanagement_v1.projects.locations.networkMonitoringProviders.monitoringPoints.html
@@ -120,7 +120,9 @@ 
Method Details

     "cloudProjectId": "A String", # Output only. The cloud project id of the host.
     "cloudProvider": "A String", # Output only. The cloud provider of the host.
     "cloudRegion": "A String", # Output only. The cloud region of the host.
-    "cloudVpcId": "A String", # Output only. The id of Virtual Private Cloud (VPC) of the host.
+    "cloudVirtualNetworkIds": [ # Output only. The ids of cloud virtual networks of the host.
+      "A String",
+    ],
     "cloudZone": "A String", # Output only. The cloud zone of the host.
     "os": "A String", # Output only. The operating system of the host.
   },
@@ -184,7 +186,9 @@ 
Method Details

         "cloudProjectId": "A String", # Output only. The cloud project id of the host.
         "cloudProvider": "A String", # Output only. The cloud provider of the host.
         "cloudRegion": "A String", # Output only. The cloud region of the host.
-        "cloudVpcId": "A String", # Output only. The id of Virtual Private Cloud (VPC) of the host.
+        "cloudVirtualNetworkIds": [ # Output only. The ids of cloud virtual networks of the host.
+          "A String",
+        ],
         "cloudZone": "A String", # Output only. The cloud zone of the host.
         "os": "A String", # Output only. The operating system of the host.
       },
diff --git a/googleapiclient/discovery_cache/documents/networkmanagement.v1.json b/googleapiclient/discovery_cache/documents/networkmanagement.v1.json
index 03260d137a5..e1fb2299158 100644
--- a/googleapiclient/discovery_cache/documents/networkmanagement.v1.json
+++ b/googleapiclient/discovery_cache/documents/networkmanagement.v1.json
@@ -1289,7 +1289,7 @@
 }
 }
 },
-"revision": "20250709",
+"revision": "20250716",
 "rootUrl": "https://networkmanagement.googleapis.com/",
 "schemas": {
 "AbortInfo": {
@@ -2566,11 +2566,14 @@ false
 "readOnly": true,
 "type": "string"
 },
-"cloudVpcId": {
-"description": "Output only. The id of Virtual Private Cloud (VPC) of the host.",
-"readOnly": true,
+"cloudVirtualNetworkIds": {
+"description": "Output only. The ids of cloud virtual networks of the host.",
+"items": {
 "type": "string"
 },
+"readOnly": true,
+"type": "array"
+},
 "cloudZone": {
 "description": "Output only. The cloud zone of the host.",
 "readOnly": true,

From 78582a7b2e373b85720ac3587885eec258f8d793 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:13 +0000
Subject: [PATCH 24/36] feat(networksecurity): update the api

#### networksecurity:v1

The following keys were added:
- schemas.AuthzPolicyAuthzRuleFromRequestSource.properties.principals (Total Keys: 2)
- schemas.AuthzPolicyAuthzRulePrincipal (Total Keys: 4)

#### networksecurity:v1beta1

The following keys were added:
- resources.projects.resources.locations.resources.dnsThreatDetectors.methods.create (Total Keys: 14)
- resources.projects.resources.locations.resources.dnsThreatDetectors.methods.delete (Total Keys: 11)
- resources.projects.resources.locations.resources.dnsThreatDetectors.methods.get (Total Keys: 11)
- resources.projects.resources.locations.resources.dnsThreatDetectors.methods.list (Total Keys: 16)
- resources.projects.resources.locations.resources.dnsThreatDetectors.methods.patch (Total Keys: 15)
- schemas.DnsThreatDetector (Total Keys: 14)
- schemas.ListDnsThreatDetectorsResponse (Total Keys: 7)
---
 ...y_v1.projects.locations.authzPolicies.html | 112 ++++++-
 ...ocations.backendAuthenticationConfigs.html |   8 +-
 ....projects.locations.clientTlsPolicies.html |  10 +-
 ...projects.locations.dnsThreatDetectors.html | 292 ++++++++++++++++++
 ...rksecurity_v1beta1.projects.locations.html |   5 +
 .../documents/networksecurity.v1.json         |  44 ++-
 .../documents/networksecurity.v1beta1.json    | 233 +++++++++++++-
 7 files changed, 681 insertions(+), 23 deletions(-)
 create mode 100644 docs/dyn/networksecurity_v1beta1.projects.locations.dnsThreatDetectors.html

diff --git a/docs/dyn/networksecurity_v1.projects.locations.authzPolicies.html b/docs/dyn/networksecurity_v1.projects.locations.authzPolicies.html
index 697291cf345..ea393d5a910 100644
--- a/docs/dyn/networksecurity_v1.projects.locations.authzPolicies.html
+++ b/docs/dyn/networksecurity_v1.projects.locations.authzPolicies.html
@@ -137,12 +137,24 @@ 
Method Details

       "from": { # Describes properties of one or more sources of a request. # Optional. Describes properties of a source of a request.
         "notSources": [ # Optional. Describes the negated properties of request sources. Matches requests from sources that do not match the criteria specified in this field. At least one of sources or notSources must be specified.
           { # Describes the properties of a single source.
-            "ipBlocks": [ # Optional. A list of IPs or CIDRs to match against the source IP of a request. Limited to 5 ip_blocks.
+            "ipBlocks": [ # Optional. A list of IP addresses or IP address ranges to match against the source IP address of the request. Limited to 5 ip_blocks.
               { # Represents a range of IP Addresses.
                 "length": 42, # Required. The length of the address range.
                 "prefix": "A String", # Required. The address prefix.
               },
             ],
+            "principals": [ # Optional. A list of identities derived from the client's certificate. This field will not match on a request unless frontend mutual TLS is enabled for the forwarding rule or Gateway and the client certificate has been successfully validated by mTLS. Each identity is a string whose value is matched against a list of URI SANs, DNS Name SANs, or the common name in the client's certificate. A match happens when any principal matches with the rule. Limited to 5 principals.
+              { # Describes the properties of a principal to be matched against.
+                "principal": { # Determines how a string value should be matched. # Required. A non-empty string whose value is matched against the principal value based on the principal_selector. Only exact match can be applied for CLIENT_CERT_URI_SAN, CLIENT_CERT_DNS_NAME_SAN, CLIENT_CERT_COMMON_NAME selectors.
+                  "contains": "A String", # The input string must have the substring specified here. Note: empty contains match is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc.def``
+                  "exact": "A String", # The input string must match exactly the string specified here. Examples: * ``abc`` only matches the value ``abc``.
+                  "ignoreCase": True or False, # If true, indicates the exact/prefix/suffix/contains matching should be case insensitive. For example, the matcher ``data`` will match both input string ``Data`` and ``data`` if set to true.
+                  "prefix": "A String", # The input string must have the prefix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``abc.xyz``
+                  "suffix": "A String", # The input string must have the suffix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc``
+                },
+                "principalSelector": "A String", # Optional. An enum to decide what principal value the principal rule will match against. If not specified, the PrincipalSelector is CLIENT_CERT_URI_SAN.
+              },
+            ],
             "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 5 resources.
               { # Describes the properties of a client VM resource accessing the internal application load balancers.
                 "iamServiceAccount": { # Determines how a string value should be matched. # Optional. An IAM service account to match against the source service account of the VM sending the request.
@@ -163,12 +175,24 @@ 
Method Details

         ],
         "sources": [ # Optional. Describes the properties of a request's sources. At least one of sources or notSources must be specified. Limited to 1 source. A match occurs when ANY source (in sources or notSources) matches the request. Within a single source, the match follows AND semantics across fields and OR semantics within a single field, i.e. a match occurs when ANY principal matches AND ANY ipBlocks match.
           { # Describes the properties of a single source.
-            "ipBlocks": [ # Optional. A list of IPs or CIDRs to match against the source IP of a request. Limited to 5 ip_blocks.
+            "ipBlocks": [ # Optional. A list of IP addresses or IP address ranges to match against the source IP address of the request. Limited to 5 ip_blocks.
               { # Represents a range of IP Addresses.
                 "length": 42, # Required. The length of the address range.
                 "prefix": "A String", # Required. The address prefix.
               },
             ],
+            "principals": [ # Optional. A list of identities derived from the client's certificate. This field will not match on a request unless frontend mutual TLS is enabled for the forwarding rule or Gateway and the client certificate has been successfully validated by mTLS. Each identity is a string whose value is matched against a list of URI SANs, DNS Name SANs, or the common name in the client's certificate. A match happens when any principal matches with the rule. Limited to 5 principals.
+              { # Describes the properties of a principal to be matched against.
+                "principal": { # Determines how a string value should be matched. # Required. A non-empty string whose value is matched against the principal value based on the principal_selector. Only exact match can be applied for CLIENT_CERT_URI_SAN, CLIENT_CERT_DNS_NAME_SAN, CLIENT_CERT_COMMON_NAME selectors.
+                  "contains": "A String", # The input string must have the substring specified here. Note: empty contains match is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc.def``
+                  "exact": "A String", # The input string must match exactly the string specified here. Examples: * ``abc`` only matches the value ``abc``.
+                  "ignoreCase": True or False, # If true, indicates the exact/prefix/suffix/contains matching should be case insensitive. For example, the matcher ``data`` will match both input string ``Data`` and ``data`` if set to true.
+                  "prefix": "A String", # The input string must have the prefix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``abc.xyz``
+                  "suffix": "A String", # The input string must have the suffix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc``
+                },
+                "principalSelector": "A String", # Optional. An enum to decide what principal value the principal rule will match against. If not specified, the PrincipalSelector is CLIENT_CERT_URI_SAN.
+              },
+            ],
             "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 5 resources.
               { # Describes the properties of a client VM resource accessing the internal application load balancers.
                 "iamServiceAccount": { # Determines how a string value should be matched. # Optional. An IAM service account to match against the source service account of the VM sending the request.
@@ -383,12 +407,24 @@ 
Method Details

       "from": { # Describes properties of one or more sources of a request. # Optional. Describes properties of a source of a request.
         "notSources": [ # Optional. Describes the negated properties of request sources. Matches requests from sources that do not match the criteria specified in this field. At least one of sources or notSources must be specified.
           { # Describes the properties of a single source.
-            "ipBlocks": [ # Optional. A list of IPs or CIDRs to match against the source IP of a request. Limited to 5 ip_blocks.
+            "ipBlocks": [ # Optional. A list of IP addresses or IP address ranges to match against the source IP address of the request. Limited to 5 ip_blocks.
               { # Represents a range of IP Addresses.
                 "length": 42, # Required. The length of the address range.
                 "prefix": "A String", # Required. The address prefix.
               },
             ],
+            "principals": [ # Optional. A list of identities derived from the client's certificate. This field will not match on a request unless frontend mutual TLS is enabled for the forwarding rule or Gateway and the client certificate has been successfully validated by mTLS. Each identity is a string whose value is matched against a list of URI SANs, DNS Name SANs, or the common name in the client's certificate. A match happens when any principal matches with the rule. Limited to 5 principals.
+              { # Describes the properties of a principal to be matched against.
+                "principal": { # Determines how a string value should be matched. # Required. A non-empty string whose value is matched against the principal value based on the principal_selector. Only exact match can be applied for CLIENT_CERT_URI_SAN, CLIENT_CERT_DNS_NAME_SAN, CLIENT_CERT_COMMON_NAME selectors.
+                  "contains": "A String", # The input string must have the substring specified here. Note: empty contains match is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc.def``
+                  "exact": "A String", # The input string must match exactly the string specified here. Examples: * ``abc`` only matches the value ``abc``.
+                  "ignoreCase": True or False, # If true, indicates the exact/prefix/suffix/contains matching should be case insensitive. For example, the matcher ``data`` will match both input string ``Data`` and ``data`` if set to true.
+                  "prefix": "A String", # The input string must have the prefix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``abc.xyz``
+                  "suffix": "A String", # The input string must have the suffix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc``
+                },
+                "principalSelector": "A String", # Optional. An enum to decide what principal value the principal rule will match against. If not specified, the PrincipalSelector is CLIENT_CERT_URI_SAN.
+              },
+            ],
             "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 5 resources.
               { # Describes the properties of a client VM resource accessing the internal application load balancers.
                 "iamServiceAccount": { # Determines how a string value should be matched. # Optional. An IAM service account to match against the source service account of the VM sending the request.
@@ -409,12 +445,24 @@ 
Method Details

         ],
         "sources": [ # Optional. Describes the properties of a request's sources. At least one of sources or notSources must be specified. Limited to 1 source. A match occurs when ANY source (in sources or notSources) matches the request. Within a single source, the match follows AND semantics across fields and OR semantics within a single field, i.e. a match occurs when ANY principal matches AND ANY ipBlocks match.
           { # Describes the properties of a single source.
-            "ipBlocks": [ # Optional. A list of IPs or CIDRs to match against the source IP of a request. Limited to 5 ip_blocks.
+            "ipBlocks": [ # Optional. A list of IP addresses or IP address ranges to match against the source IP address of the request. Limited to 5 ip_blocks.
               { # Represents a range of IP Addresses.
                 "length": 42, # Required. The length of the address range.
                 "prefix": "A String", # Required. The address prefix.
               },
             ],
+            "principals": [ # Optional. A list of identities derived from the client's certificate. This field will not match on a request unless frontend mutual TLS is enabled for the forwarding rule or Gateway and the client certificate has been successfully validated by mTLS. Each identity is a string whose value is matched against a list of URI SANs, DNS Name SANs, or the common name in the client's certificate. A match happens when any principal matches with the rule. Limited to 5 principals.
+              { # Describes the properties of a principal to be matched against.
+                "principal": { # Determines how a string value should be matched. # Required. A non-empty string whose value is matched against the principal value based on the principal_selector. Only exact match can be applied for CLIENT_CERT_URI_SAN, CLIENT_CERT_DNS_NAME_SAN, CLIENT_CERT_COMMON_NAME selectors.
+                  "contains": "A String", # The input string must have the substring specified here. Note: empty contains match is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc.def``
+                  "exact": "A String", # The input string must match exactly the string specified here. Examples: * ``abc`` only matches the value ``abc``.
+                  "ignoreCase": True or False, # If true, indicates the exact/prefix/suffix/contains matching should be case insensitive. For example, the matcher ``data`` will match both input string ``Data`` and ``data`` if set to true.
+                  "prefix": "A String", # The input string must have the prefix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``abc.xyz``
+                  "suffix": "A String", # The input string must have the suffix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc``
+                },
+                "principalSelector": "A String", # Optional. An enum to decide what principal value the principal rule will match against. If not specified, the PrincipalSelector is CLIENT_CERT_URI_SAN.
+              },
+            ],
             "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 5 resources.
               { # Describes the properties of a client VM resource accessing the internal application load balancers.
                 "iamServiceAccount": { # Determines how a string value should be matched. # Optional. An IAM service account to match against the source service account of the VM sending the request.
@@ -617,12 +665,24 @@ 
Method Details

           "from": { # Describes properties of one or more sources of a request. # Optional. Describes properties of a source of a request.
             "notSources": [ # Optional. Describes the negated properties of request sources. Matches requests from sources that do not match the criteria specified in this field. At least one of sources or notSources must be specified.
               { # Describes the properties of a single source.
-                "ipBlocks": [ # Optional. A list of IPs or CIDRs to match against the source IP of a request. Limited to 5 ip_blocks.
+                "ipBlocks": [ # Optional. A list of IP addresses or IP address ranges to match against the source IP address of the request. Limited to 5 ip_blocks.
                   { # Represents a range of IP Addresses.
                     "length": 42, # Required. The length of the address range.
                     "prefix": "A String", # Required. The address prefix.
                   },
                 ],
+                "principals": [ # Optional. A list of identities derived from the client's certificate. This field will not match on a request unless frontend mutual TLS is enabled for the forwarding rule or Gateway and the client certificate has been successfully validated by mTLS. Each identity is a string whose value is matched against a list of URI SANs, DNS Name SANs, or the common name in the client's certificate. A match happens when any principal matches with the rule. Limited to 5 principals.
+                  { # Describes the properties of a principal to be matched against.
+                    "principal": { # Determines how a string value should be matched. # Required. A non-empty string whose value is matched against the principal value based on the principal_selector. Only exact match can be applied for CLIENT_CERT_URI_SAN, CLIENT_CERT_DNS_NAME_SAN, CLIENT_CERT_COMMON_NAME selectors.
+                      "contains": "A String", # The input string must have the substring specified here. Note: empty contains match is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc.def``
+                      "exact": "A String", # The input string must match exactly the string specified here. Examples: * ``abc`` only matches the value ``abc``.
+                      "ignoreCase": True or False, # If true, indicates the exact/prefix/suffix/contains matching should be case insensitive. For example, the matcher ``data`` will match both input string ``Data`` and ``data`` if set to true.
+                      "prefix": "A String", # The input string must have the prefix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``abc.xyz``
+                      "suffix": "A String", # The input string must have the suffix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc``
+                    },
+                    "principalSelector": "A String", # Optional. An enum to decide what principal value the principal rule will match against. If not specified, the PrincipalSelector is CLIENT_CERT_URI_SAN.
+                  },
+                ],
                 "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 5 resources.
                   { # Describes the properties of a client VM resource accessing the internal application load balancers.
                     "iamServiceAccount": { # Determines how a string value should be matched. # Optional. An IAM service account to match against the source service account of the VM sending the request.
@@ -643,12 +703,24 @@ 
Method Details

             ],
             "sources": [ # Optional. Describes the properties of a request's sources. At least one of sources or notSources must be specified. Limited to 1 source. A match occurs when ANY source (in sources or notSources) matches the request. Within a single source, the match follows AND semantics across fields and OR semantics within a single field, i.e. a match occurs when ANY principal matches AND ANY ipBlocks match.
               { # Describes the properties of a single source.
-                "ipBlocks": [ # Optional. A list of IPs or CIDRs to match against the source IP of a request. Limited to 5 ip_blocks.
+                "ipBlocks": [ # Optional. A list of IP addresses or IP address ranges to match against the source IP address of the request. Limited to 5 ip_blocks.
                   { # Represents a range of IP Addresses.
                     "length": 42, # Required. The length of the address range.
                     "prefix": "A String", # Required. The address prefix.
                   },
                 ],
+                "principals": [ # Optional. A list of identities derived from the client's certificate. This field will not match on a request unless frontend mutual TLS is enabled for the forwarding rule or Gateway and the client certificate has been successfully validated by mTLS. Each identity is a string whose value is matched against a list of URI SANs, DNS Name SANs, or the common name in the client's certificate. A match happens when any principal matches with the rule. Limited to 5 principals.
+                  { # Describes the properties of a principal to be matched against.
+                    "principal": { # Determines how a string value should be matched. # Required. A non-empty string whose value is matched against the principal value based on the principal_selector. Only exact match can be applied for CLIENT_CERT_URI_SAN, CLIENT_CERT_DNS_NAME_SAN, CLIENT_CERT_COMMON_NAME selectors.
+                      "contains": "A String", # The input string must have the substring specified here. Note: empty contains match is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc.def``
+                      "exact": "A String", # The input string must match exactly the string specified here. Examples: * ``abc`` only matches the value ``abc``.
+                      "ignoreCase": True or False, # If true, indicates the exact/prefix/suffix/contains matching should be case insensitive. For example, the matcher ``data`` will match both input string ``Data`` and ``data`` if set to true.
+                      "prefix": "A String", # The input string must have the prefix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``abc.xyz``
+                      "suffix": "A String", # The input string must have the suffix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc``
+                    },
+                    "principalSelector": "A String", # Optional. An enum to decide what principal value the principal rule will match against. If not specified, the PrincipalSelector is CLIENT_CERT_URI_SAN.
+                  },
+                ],
                 "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 5 resources.
                   { # Describes the properties of a client VM resource accessing the internal application load balancers.
                     "iamServiceAccount": { # Determines how a string value should be matched. # Optional. An IAM service account to match against the source service account of the VM sending the request.
@@ -812,12 +884,24 @@ 
Method Details

       "from": { # Describes properties of one or more sources of a request. # Optional. Describes properties of a source of a request.
         "notSources": [ # Optional. Describes the negated properties of request sources. Matches requests from sources that do not match the criteria specified in this field. At least one of sources or notSources must be specified.
           { # Describes the properties of a single source.
-            "ipBlocks": [ # Optional. A list of IPs or CIDRs to match against the source IP of a request. Limited to 5 ip_blocks.
+            "ipBlocks": [ # Optional. A list of IP addresses or IP address ranges to match against the source IP address of the request. Limited to 5 ip_blocks.
               { # Represents a range of IP Addresses.
                 "length": 42, # Required. The length of the address range.
                 "prefix": "A String", # Required. The address prefix.
               },
             ],
+            "principals": [ # Optional. A list of identities derived from the client's certificate. This field will not match on a request unless frontend mutual TLS is enabled for the forwarding rule or Gateway and the client certificate has been successfully validated by mTLS. Each identity is a string whose value is matched against a list of URI SANs, DNS Name SANs, or the common name in the client's certificate. A match happens when any principal matches with the rule. Limited to 5 principals.
+              { # Describes the properties of a principal to be matched against.
+                "principal": { # Determines how a string value should be matched. # Required. A non-empty string whose value is matched against the principal value based on the principal_selector. Only exact match can be applied for CLIENT_CERT_URI_SAN, CLIENT_CERT_DNS_NAME_SAN, CLIENT_CERT_COMMON_NAME selectors.
+                  "contains": "A String", # The input string must have the substring specified here. Note: empty contains match is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc.def``
+                  "exact": "A String", # The input string must match exactly the string specified here. Examples: * ``abc`` only matches the value ``abc``.
+                  "ignoreCase": True or False, # If true, indicates the exact/prefix/suffix/contains matching should be case insensitive. For example, the matcher ``data`` will match both input string ``Data`` and ``data`` if set to true.
+                  "prefix": "A String", # The input string must have the prefix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``abc.xyz``
+                  "suffix": "A String", # The input string must have the suffix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc``
+                },
+                "principalSelector": "A String", # Optional. An enum to decide what principal value the principal rule will match against. If not specified, the PrincipalSelector is CLIENT_CERT_URI_SAN.
+              },
+            ],
             "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 5 resources.
               { # Describes the properties of a client VM resource accessing the internal application load balancers.
                 "iamServiceAccount": { # Determines how a string value should be matched. # Optional. An IAM service account to match against the source service account of the VM sending the request.
@@ -838,12 +922,24 @@ 
Method Details

         ],
         "sources": [ # Optional. Describes the properties of a request's sources. At least one of sources or notSources must be specified. Limited to 1 source. A match occurs when ANY source (in sources or notSources) matches the request. Within a single source, the match follows AND semantics across fields and OR semantics within a single field, i.e. a match occurs when ANY principal matches AND ANY ipBlocks match.
           { # Describes the properties of a single source.
-            "ipBlocks": [ # Optional. A list of IPs or CIDRs to match against the source IP of a request. Limited to 5 ip_blocks.
+            "ipBlocks": [ # Optional. A list of IP addresses or IP address ranges to match against the source IP address of the request. Limited to 5 ip_blocks.
               { # Represents a range of IP Addresses.
                 "length": 42, # Required. The length of the address range.
                 "prefix": "A String", # Required. The address prefix.
               },
             ],
+            "principals": [ # Optional. A list of identities derived from the client's certificate. This field will not match on a request unless frontend mutual TLS is enabled for the forwarding rule or Gateway and the client certificate has been successfully validated by mTLS. Each identity is a string whose value is matched against a list of URI SANs, DNS Name SANs, or the common name in the client's certificate. A match happens when any principal matches with the rule. Limited to 5 principals.
+              { # Describes the properties of a principal to be matched against.
+                "principal": { # Determines how a string value should be matched. # Required. A non-empty string whose value is matched against the principal value based on the principal_selector. Only exact match can be applied for CLIENT_CERT_URI_SAN, CLIENT_CERT_DNS_NAME_SAN, CLIENT_CERT_COMMON_NAME selectors.
+                  "contains": "A String", # The input string must have the substring specified here. Note: empty contains match is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc.def``
+                  "exact": "A String", # The input string must match exactly the string specified here. Examples: * ``abc`` only matches the value ``abc``.
+                  "ignoreCase": True or False, # If true, indicates the exact/prefix/suffix/contains matching should be case insensitive. For example, the matcher ``data`` will match both input string ``Data`` and ``data`` if set to true.
+                  "prefix": "A String", # The input string must have the prefix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``abc.xyz``
+                  "suffix": "A String", # The input string must have the suffix specified here. Note: empty prefix is not allowed, please use regex instead. Examples: * ``abc`` matches the value ``xyz.abc``
+                },
+                "principalSelector": "A String", # Optional. An enum to decide what principal value the principal rule will match against. If not specified, the PrincipalSelector is CLIENT_CERT_URI_SAN.
+              },
+            ],
             "resources": [ # Optional. A list of resources to match against the resource of the source VM of a request. Limited to 5 resources.
               { # Describes the properties of a client VM resource accessing the internal application load balancers.
                 "iamServiceAccount": { # Determines how a string value should be matched. # Optional. An IAM service account to match against the source service account of the VM sending the request.
diff --git a/docs/dyn/networksecurity_v1.projects.locations.backendAuthenticationConfigs.html b/docs/dyn/networksecurity_v1.projects.locations.backendAuthenticationConfigs.html
index a58eeb20ec6..fc56674a08a 100644
--- a/docs/dyn/networksecurity_v1.projects.locations.backendAuthenticationConfigs.html
+++ b/docs/dyn/networksecurity_v1.projects.locations.backendAuthenticationConfigs.html
@@ -110,7 +110,7 @@ 
Method Details

   body: object, The request body.
     The object takes the form of:
 
-{ # BackendAuthenticationConfig message groups the TrustConfig together with other settings that control how the load balancer authenticates, and expresses its identity to, the backend: * `trustConfig` is the attached TrustConfig. * `wellKnownRoots` indicates whether the load balance should trust backend server certificates that are issued by public certificate authorities, in addition to certificates trusted by the TrustConfig. * `clientCertificate` is a client certificate that the load balancer uses to express its identity to the backend, if the connection to the backend uses mTLS. You can attach the BackendAuthenticationConfig to the load balancer’s BackendService directly determining how that BackendService negotiates TLS.
+{ # BackendAuthenticationConfig message groups the TrustConfig together with other settings that control how the load balancer authenticates, and expresses its identity to, the backend: * `trustConfig` is the attached TrustConfig. * `wellKnownRoots` indicates whether the load balance should trust backend server certificates that are issued by public certificate authorities, in addition to certificates trusted by the TrustConfig. * `clientCertificate` is a client certificate that the load balancer uses to express its identity to the backend, if the connection to the backend uses mTLS. You can attach the BackendAuthenticationConfig to the load balancer's BackendService directly determining how that BackendService negotiates TLS.
   "clientCertificate": "A String", # Optional. A reference to a certificatemanager.googleapis.com.Certificate resource. This is a relative resource path following the form "projects/{project}/locations/{location}/certificates/{certificate}". Used by a BackendService to negotiate mTLS when the backend connection uses TLS and the backend requests a client certificate. Must have a CLIENT_AUTH scope.
   "createTime": "A String", # Output only. The timestamp when the resource was created.
   "description": "A String", # Optional. Free-text description of the resource.
@@ -204,7 +204,7 @@ 
Method Details

 Returns:
   An object of the form:
 
-    { # BackendAuthenticationConfig message groups the TrustConfig together with other settings that control how the load balancer authenticates, and expresses its identity to, the backend: * `trustConfig` is the attached TrustConfig. * `wellKnownRoots` indicates whether the load balance should trust backend server certificates that are issued by public certificate authorities, in addition to certificates trusted by the TrustConfig. * `clientCertificate` is a client certificate that the load balancer uses to express its identity to the backend, if the connection to the backend uses mTLS. You can attach the BackendAuthenticationConfig to the load balancer’s BackendService directly determining how that BackendService negotiates TLS.
+    { # BackendAuthenticationConfig message groups the TrustConfig together with other settings that control how the load balancer authenticates, and expresses its identity to, the backend: * `trustConfig` is the attached TrustConfig. * `wellKnownRoots` indicates whether the load balance should trust backend server certificates that are issued by public certificate authorities, in addition to certificates trusted by the TrustConfig. * `clientCertificate` is a client certificate that the load balancer uses to express its identity to the backend, if the connection to the backend uses mTLS. You can attach the BackendAuthenticationConfig to the load balancer's BackendService directly determining how that BackendService negotiates TLS.
   "clientCertificate": "A String", # Optional. A reference to a certificatemanager.googleapis.com.Certificate resource. This is a relative resource path following the form "projects/{project}/locations/{location}/certificates/{certificate}". Used by a BackendService to negotiate mTLS when the backend connection uses TLS and the backend requests a client certificate. Must have a CLIENT_AUTH scope.
   "createTime": "A String", # Output only. The timestamp when the resource was created.
   "description": "A String", # Optional. Free-text description of the resource.
@@ -237,7 +237,7 @@ 
Method Details

 
     { # Response returned by the ListBackendAuthenticationConfigs method.
   "backendAuthenticationConfigs": [ # List of BackendAuthenticationConfig resources.
-    { # BackendAuthenticationConfig message groups the TrustConfig together with other settings that control how the load balancer authenticates, and expresses its identity to, the backend: * `trustConfig` is the attached TrustConfig. * `wellKnownRoots` indicates whether the load balance should trust backend server certificates that are issued by public certificate authorities, in addition to certificates trusted by the TrustConfig. * `clientCertificate` is a client certificate that the load balancer uses to express its identity to the backend, if the connection to the backend uses mTLS. You can attach the BackendAuthenticationConfig to the load balancer’s BackendService directly determining how that BackendService negotiates TLS.
+    { # BackendAuthenticationConfig message groups the TrustConfig together with other settings that control how the load balancer authenticates, and expresses its identity to, the backend: * `trustConfig` is the attached TrustConfig. * `wellKnownRoots` indicates whether the load balance should trust backend server certificates that are issued by public certificate authorities, in addition to certificates trusted by the TrustConfig. * `clientCertificate` is a client certificate that the load balancer uses to express its identity to the backend, if the connection to the backend uses mTLS. You can attach the BackendAuthenticationConfig to the load balancer's BackendService directly determining how that BackendService negotiates TLS.
       "clientCertificate": "A String", # Optional. A reference to a certificatemanager.googleapis.com.Certificate resource. This is a relative resource path following the form "projects/{project}/locations/{location}/certificates/{certificate}". Used by a BackendService to negotiate mTLS when the backend connection uses TLS and the backend requests a client certificate. Must have a CLIENT_AUTH scope.
       "createTime": "A String", # Output only. The timestamp when the resource was created.
       "description": "A String", # Optional. Free-text description of the resource.
@@ -281,7 +281,7 @@ 
Method Details

   body: object, The request body.
     The object takes the form of:
 
-{ # BackendAuthenticationConfig message groups the TrustConfig together with other settings that control how the load balancer authenticates, and expresses its identity to, the backend: * `trustConfig` is the attached TrustConfig. * `wellKnownRoots` indicates whether the load balance should trust backend server certificates that are issued by public certificate authorities, in addition to certificates trusted by the TrustConfig. * `clientCertificate` is a client certificate that the load balancer uses to express its identity to the backend, if the connection to the backend uses mTLS. You can attach the BackendAuthenticationConfig to the load balancer’s BackendService directly determining how that BackendService negotiates TLS.
+{ # BackendAuthenticationConfig message groups the TrustConfig together with other settings that control how the load balancer authenticates, and expresses its identity to, the backend: * `trustConfig` is the attached TrustConfig. * `wellKnownRoots` indicates whether the load balance should trust backend server certificates that are issued by public certificate authorities, in addition to certificates trusted by the TrustConfig. * `clientCertificate` is a client certificate that the load balancer uses to express its identity to the backend, if the connection to the backend uses mTLS. You can attach the BackendAuthenticationConfig to the load balancer's BackendService directly determining how that BackendService negotiates TLS.
   "clientCertificate": "A String", # Optional. A reference to a certificatemanager.googleapis.com.Certificate resource. This is a relative resource path following the form "projects/{project}/locations/{location}/certificates/{certificate}". Used by a BackendService to negotiate mTLS when the backend connection uses TLS and the backend requests a client certificate. Must have a CLIENT_AUTH scope.
   "createTime": "A String", # Output only. The timestamp when the resource was created.
   "description": "A String", # Optional. Free-text description of the resource.
diff --git a/docs/dyn/networksecurity_v1.projects.locations.clientTlsPolicies.html b/docs/dyn/networksecurity_v1.projects.locations.clientTlsPolicies.html
index c32c7bedb7b..8a2cbff5610 100644
--- a/docs/dyn/networksecurity_v1.projects.locations.clientTlsPolicies.html
+++ b/docs/dyn/networksecurity_v1.projects.locations.clientTlsPolicies.html
@@ -133,7 +133,7 @@ 
Method Details

   "labels": { # Optional. Set of label tags associated with the resource.
     "a_key": "A String",
   },
-  "name": "A String", # Required. Name of the ClientTlsPolicy resource. It matches the pattern `projects/*/locations/{location}/clientTlsPolicies/{client_tls_policy}`
+  "name": "A String", # Required. Name of the ClientTlsPolicy resource. It matches the pattern `projects/{project}/locations/{location}/clientTlsPolicies/{client_tls_policy}`
   "serverValidationCa": [ # Optional. Defines the mechanism to obtain the Certificate Authority certificate to validate the server certificate. If empty, client does not validate the server certificate.
     { # Specification of ValidationCA. Defines the mechanism to obtain the Certificate Authority certificate to validate the peer certificate.
       "certificateProviderInstance": { # Specification of a TLS certificate provider instance. Workloads may have one or more CertificateProvider instances (plugins) and one of them is enabled and configured by specifying this message. Workloads use the values from this message to locate and load the CertificateProvider instance configuration. # The certificate provider instance specification that will be passed to the data plane, which will be used to load necessary credential information.
@@ -241,7 +241,7 @@ 
Method Details

   "labels": { # Optional. Set of label tags associated with the resource.
     "a_key": "A String",
   },
-  "name": "A String", # Required. Name of the ClientTlsPolicy resource. It matches the pattern `projects/*/locations/{location}/clientTlsPolicies/{client_tls_policy}`
+  "name": "A String", # Required. Name of the ClientTlsPolicy resource. It matches the pattern `projects/{project}/locations/{location}/clientTlsPolicies/{client_tls_policy}`
   "serverValidationCa": [ # Optional. Defines the mechanism to obtain the Certificate Authority certificate to validate the server certificate. If empty, client does not validate the server certificate.
     { # Specification of ValidationCA. Defines the mechanism to obtain the Certificate Authority certificate to validate the peer certificate.
       "certificateProviderInstance": { # Specification of a TLS certificate provider instance. Workloads may have one or more CertificateProvider instances (plugins) and one of them is enabled and configured by specifying this message. Workloads use the values from this message to locate and load the CertificateProvider instance configuration. # The certificate provider instance specification that will be passed to the data plane, which will be used to load necessary credential information.
@@ -337,7 +337,7 @@ 
Method Details

       "labels": { # Optional. Set of label tags associated with the resource.
         "a_key": "A String",
       },
-      "name": "A String", # Required. Name of the ClientTlsPolicy resource. It matches the pattern `projects/*/locations/{location}/clientTlsPolicies/{client_tls_policy}`
+      "name": "A String", # Required. Name of the ClientTlsPolicy resource. It matches the pattern `projects/{project}/locations/{location}/clientTlsPolicies/{client_tls_policy}`
       "serverValidationCa": [ # Optional. Defines the mechanism to obtain the Certificate Authority certificate to validate the server certificate. If empty, client does not validate the server certificate.
         { # Specification of ValidationCA. Defines the mechanism to obtain the Certificate Authority certificate to validate the peer certificate.
           "certificateProviderInstance": { # Specification of a TLS certificate provider instance. Workloads may have one or more CertificateProvider instances (plugins) and one of them is enabled and configured by specifying this message. Workloads use the values from this message to locate and load the CertificateProvider instance configuration. # The certificate provider instance specification that will be passed to the data plane, which will be used to load necessary credential information.
@@ -375,7 +375,7 @@ 
Method Details

   
Updates the parameters of a single ClientTlsPolicy.
 
 Args:
-  name: string, Required. Name of the ClientTlsPolicy resource. It matches the pattern `projects/*/locations/{location}/clientTlsPolicies/{client_tls_policy}` (required)
+  name: string, Required. Name of the ClientTlsPolicy resource. It matches the pattern `projects/{project}/locations/{location}/clientTlsPolicies/{client_tls_policy}` (required)
   body: object, The request body.
     The object takes the form of:
 
@@ -393,7 +393,7 @@ 
Method Details

   "labels": { # Optional. Set of label tags associated with the resource.
     "a_key": "A String",
   },
-  "name": "A String", # Required. Name of the ClientTlsPolicy resource. It matches the pattern `projects/*/locations/{location}/clientTlsPolicies/{client_tls_policy}`
+  "name": "A String", # Required. Name of the ClientTlsPolicy resource. It matches the pattern `projects/{project}/locations/{location}/clientTlsPolicies/{client_tls_policy}`
   "serverValidationCa": [ # Optional. Defines the mechanism to obtain the Certificate Authority certificate to validate the server certificate. If empty, client does not validate the server certificate.
     { # Specification of ValidationCA. Defines the mechanism to obtain the Certificate Authority certificate to validate the peer certificate.
       "certificateProviderInstance": { # Specification of a TLS certificate provider instance. Workloads may have one or more CertificateProvider instances (plugins) and one of them is enabled and configured by specifying this message. Workloads use the values from this message to locate and load the CertificateProvider instance configuration. # The certificate provider instance specification that will be passed to the data plane, which will be used to load necessary credential information.
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.dnsThreatDetectors.html b/docs/dyn/networksecurity_v1beta1.projects.locations.dnsThreatDetectors.html
new file mode 100644
index 00000000000..6814da19f21
--- /dev/null
+++ b/docs/dyn/networksecurity_v1beta1.projects.locations.dnsThreatDetectors.html
@@ -0,0 +1,292 @@
+
+
+
+
Network Security API . projects . locations . dnsThreatDetectors

+
Instance Methods

+

+  close()

+
Close httplib2 connections.

+

+  create(parent, body=None, dnsThreatDetectorId=None, x__xgafv=None)

+
Creates a new DnsThreatDetector in a given project and location.

+

+  delete(name, x__xgafv=None)

+
Deletes a single DnsThreatDetector.

+

+  get(name, x__xgafv=None)

+
Gets details of a single DnsThreatDetector.

+

+  list(parent, pageSize=None, pageToken=None, x__xgafv=None)

+
Lists DnsThreatDetectors in a given project and location.

+

+  list_next()

+
Retrieves the next page of results.

+

+  patch(name, body=None, updateMask=None, x__xgafv=None)

+
Updates the parameters of a single DnsThreatDetector.

+
Method Details

+

+    close()
+  
Close httplib2 connections.

+

+
+

+    create(parent, body=None, dnsThreatDetectorId=None, x__xgafv=None)
+  
Creates a new DnsThreatDetector in a given project and location.
+
+Args:
+  parent: string, Required. Value for parent of the DnsThreatDetector resource. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Message describing DnsThreatDetector object
+  "createTime": "A String", # Output only. [Output only] Create time stamp
+  "excludedNetworks": [ # Optional. A list of Network resource names which are exempt from the configuration in this DnsThreatDetector. Example: `projects/PROJECT_ID/global/networks/NETWORK_NAME`.
+    "A String",
+  ],
+  "labels": { # Optional. Labels as key value pairs
+    "a_key": "A String",
+  },
+  "name": "A String", # Immutable. Identifier. Name of the DnsThreatDetector resource.
+  "provider": "A String", # Required. The provider used for DNS threat analysis.
+  "updateTime": "A String", # Output only. [Output only] Update time stamp
+}
+
+  dnsThreatDetectorId: string, Optional. Id of the requesting DnsThreatDetector object. If this field is not supplied, the service will generate an identifier.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Message describing DnsThreatDetector object
+  "createTime": "A String", # Output only. [Output only] Create time stamp
+  "excludedNetworks": [ # Optional. A list of Network resource names which are exempt from the configuration in this DnsThreatDetector. Example: `projects/PROJECT_ID/global/networks/NETWORK_NAME`.
+    "A String",
+  ],
+  "labels": { # Optional. Labels as key value pairs
+    "a_key": "A String",
+  },
+  "name": "A String", # Immutable. Identifier. Name of the DnsThreatDetector resource.
+  "provider": "A String", # Required. The provider used for DNS threat analysis.
+  "updateTime": "A String", # Output only. [Output only] Update time stamp
+}

+

+
+

+    delete(name, x__xgafv=None)
+  
Deletes a single DnsThreatDetector.
+
+Args:
+  name: string, Required. Name of the DnsThreatDetector resource. (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 details of a single DnsThreatDetector.
+
+Args:
+  name: string, Required. Name of the DnsThreatDetector resource (required)
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Message describing DnsThreatDetector object
+  "createTime": "A String", # Output only. [Output only] Create time stamp
+  "excludedNetworks": [ # Optional. A list of Network resource names which are exempt from the configuration in this DnsThreatDetector. Example: `projects/PROJECT_ID/global/networks/NETWORK_NAME`.
+    "A String",
+  ],
+  "labels": { # Optional. Labels as key value pairs
+    "a_key": "A String",
+  },
+  "name": "A String", # Immutable. Identifier. Name of the DnsThreatDetector resource.
+  "provider": "A String", # Required. The provider used for DNS threat analysis.
+  "updateTime": "A String", # Output only. [Output only] Update time stamp
+}

+

+
+

+    list(parent, pageSize=None, pageToken=None, x__xgafv=None)
+  
Lists DnsThreatDetectors in a given project and location.
+
+Args:
+  parent: string, Required. Parent value for ListDnsThreatDetectorsRequest (required)
+  pageSize: integer, Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
+  pageToken: string, Optional. A page token, received from a previous `ListDnsThreatDetectorsRequest` call. Provide this to retrieve the subsequent page.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Message for response to listing DnsThreatDetectors
+  "dnsThreatDetectors": [ # The list of DnsThreatDetector resources.
+    { # Message describing DnsThreatDetector object
+      "createTime": "A String", # Output only. [Output only] Create time stamp
+      "excludedNetworks": [ # Optional. A list of Network resource names which are exempt from the configuration in this DnsThreatDetector. Example: `projects/PROJECT_ID/global/networks/NETWORK_NAME`.
+        "A String",
+      ],
+      "labels": { # Optional. Labels as key value pairs
+        "a_key": "A String",
+      },
+      "name": "A String", # Immutable. Identifier. Name of the DnsThreatDetector resource.
+      "provider": "A String", # Required. The provider used for DNS threat analysis.
+      "updateTime": "A String", # Output only. [Output only] Update time stamp
+    },
+  ],
+  "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page.
+  "unreachable": [ # Unordered list. Unreachable `DnsThreatDetector` resources.
+    "A String",
+  ],
+}

+

+
+

+    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 the parameters of a single DnsThreatDetector.
+
+Args:
+  name: string, Immutable. Identifier. Name of the DnsThreatDetector resource. (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Message describing DnsThreatDetector object
+  "createTime": "A String", # Output only. [Output only] Create time stamp
+  "excludedNetworks": [ # Optional. A list of Network resource names which are exempt from the configuration in this DnsThreatDetector. Example: `projects/PROJECT_ID/global/networks/NETWORK_NAME`.
+    "A String",
+  ],
+  "labels": { # Optional. Labels as key value pairs
+    "a_key": "A String",
+  },
+  "name": "A String", # Immutable. Identifier. Name of the DnsThreatDetector resource.
+  "provider": "A String", # Required. The provider used for DNS threat analysis.
+  "updateTime": "A String", # Output only. [Output only] Update time stamp
+}
+
+  updateMask: string, Optional. Field mask is used to specify the fields to be overwritten in the DnsThreatDetector resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the mask is not provided then all fields present in the request will be overwritten.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # Message describing DnsThreatDetector object
+  "createTime": "A String", # Output only. [Output only] Create time stamp
+  "excludedNetworks": [ # Optional. A list of Network resource names which are exempt from the configuration in this DnsThreatDetector. Example: `projects/PROJECT_ID/global/networks/NETWORK_NAME`.
+    "A String",
+  ],
+  "labels": { # Optional. Labels as key value pairs
+    "a_key": "A String",
+  },
+  "name": "A String", # Immutable. Identifier. Name of the DnsThreatDetector resource.
+  "provider": "A String", # Required. The provider used for DNS threat analysis.
+  "updateTime": "A String", # Output only. [Output only] Update time stamp
+}

+

+
+
\ No newline at end of file
diff --git a/docs/dyn/networksecurity_v1beta1.projects.locations.html b/docs/dyn/networksecurity_v1beta1.projects.locations.html
index a1ba99325ea..434d98f07e2 100644
--- a/docs/dyn/networksecurity_v1beta1.projects.locations.html
+++ b/docs/dyn/networksecurity_v1beta1.projects.locations.html
@@ -99,6 +99,11 @@ 
Instance Methods

 

 
Returns the clientTlsPolicies Resource.

 
+

+  dnsThreatDetectors()
+

+
Returns the dnsThreatDetectors Resource.

+
 

   firewallEndpointAssociations()
 

diff --git a/googleapiclient/discovery_cache/documents/networksecurity.v1.json b/googleapiclient/discovery_cache/documents/networksecurity.v1.json
index c2b6aa928e7..dc50f2794a7 100644
--- a/googleapiclient/discovery_cache/documents/networksecurity.v1.json
+++ b/googleapiclient/discovery_cache/documents/networksecurity.v1.json
@@ -2338,7 +2338,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. Name of the ClientTlsPolicy resource. It matches the pattern `projects/*/locations/{location}/clientTlsPolicies/{client_tls_policy}`",
+"description": "Required. Name of the ClientTlsPolicy resource. It matches the pattern `projects/{project}/locations/{location}/clientTlsPolicies/{client_tls_policy}`",
 "location": "path",
 "pattern": "^projects/[^/]+/locations/[^/]+/clientTlsPolicies/[^/]+$",
 "required": true,
@@ -5070,7 +5070,7 @@
 }
 }
 },
-"revision": "20250604",
+"revision": "20250714",
 "rootUrl": "https://networksecurity.googleapis.com/",
 "schemas": {
 "AddAddressGroupItemsRequest": {
@@ -5387,12 +5387,19 @@
 "id": "AuthzPolicyAuthzRuleFromRequestSource",
 "properties": {
 "ipBlocks": {
-"description": "Optional. A list of IPs or CIDRs to match against the source IP of a request. Limited to 5 ip_blocks.",
+"description": "Optional. A list of IP addresses or IP address ranges to match against the source IP address of the request. Limited to 5 ip_blocks.",
 "items": {
 "$ref": "AuthzPolicyAuthzRuleIpBlock"
 },
 "type": "array"
 },
+"principals": {
+"description": "Optional. A list of identities derived from the client's certificate. This field will not match on a request unless frontend mutual TLS is enabled for the forwarding rule or Gateway and the client certificate has been successfully validated by mTLS. Each identity is a string whose value is matched against a list of URI SANs, DNS Name SANs, or the common name in the client's certificate. A match happens when any principal matches with the rule. Limited to 5 principals.",
+"items": {
+"$ref": "AuthzPolicyAuthzRulePrincipal"
+},
+"type": "array"
+},
 "resources": {
 "description": "Optional. A list of resources to match against the resource of the source VM of a request. Limited to 5 resources.",
 "items": {
@@ -5434,6 +5441,33 @@
 },
 "type": "object"
 },
+"AuthzPolicyAuthzRulePrincipal": {
+"description": "Describes the properties of a principal to be matched against.",
+"id": "AuthzPolicyAuthzRulePrincipal",
+"properties": {
+"principal": {
+"$ref": "AuthzPolicyAuthzRuleStringMatch",
+"description": "Required. A non-empty string whose value is matched against the principal value based on the principal_selector. Only exact match can be applied for CLIENT_CERT_URI_SAN, CLIENT_CERT_DNS_NAME_SAN, CLIENT_CERT_COMMON_NAME selectors."
+},
+"principalSelector": {
+"description": "Optional. An enum to decide what principal value the principal rule will match against. If not specified, the PrincipalSelector is CLIENT_CERT_URI_SAN.",
+"enum": [
+"PRINCIPAL_SELECTOR_UNSPECIFIED",
+"CLIENT_CERT_URI_SAN",
+"CLIENT_CERT_DNS_NAME_SAN",
+"CLIENT_CERT_COMMON_NAME"
+],
+"enumDescriptions": [
+"Unspecified principal selector. It will be treated as CLIENT_CERT_URI_SAN by default.",
+"The principal rule is matched against a list of URI SANs in the validated client\u2019s certificate. A match happens when there is any exact URI SAN value match. This is the default principal selector.",
+"The principal rule is matched against a list of DNS Name SANs in the validated client\u2019s certificate. A match happens when there is any exact DNS Name SAN value match.",
+"The principal rule is matched against the common name in the client\u2019s certificate. Authorization against multiple common names in the client certificate is not supported. Requests with multiple common names in the client certificate will be rejected if CLIENT_CERT_COMMON_NAME is set as the principal selector. A match happens when there is an exact common name value match. This is only applicable for Application Load Balancers except for classic Global External Application load balancer. CLIENT_CERT_COMMON_NAME is not supported for INTERNAL_SELF_MANAGED load balancing scheme."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "AuthzPolicyAuthzRuleRequestResource": {
 "description": "Describes the properties of a client VM resource accessing the internal application load balancers.",
 "id": "AuthzPolicyAuthzRuleRequestResource",
@@ -5624,7 +5658,7 @@
 "type": "object"
 },
 "BackendAuthenticationConfig": {
-"description": "BackendAuthenticationConfig message groups the TrustConfig together with other settings that control how the load balancer authenticates, and expresses its identity to, the backend: * `trustConfig` is the attached TrustConfig. * `wellKnownRoots` indicates whether the load balance should trust backend server certificates that are issued by public certificate authorities, in addition to certificates trusted by the TrustConfig. * `clientCertificate` is a client certificate that the load balancer uses to express its identity to the backend, if the connection to the backend uses mTLS. You can attach the BackendAuthenticationConfig to the load balancer\u2019s BackendService directly determining how that BackendService negotiates TLS.",
+"description": "BackendAuthenticationConfig message groups the TrustConfig together with other settings that control how the load balancer authenticates, and expresses its identity to, the backend: * `trustConfig` is the attached TrustConfig. * `wellKnownRoots` indicates whether the load balance should trust backend server certificates that are issued by public certificate authorities, in addition to certificates trusted by the TrustConfig. * `clientCertificate` is a client certificate that the load balancer uses to express its identity to the backend, if the connection to the backend uses mTLS. You can attach the BackendAuthenticationConfig to the load balancer's BackendService directly determining how that BackendService negotiates TLS.",
 "id": "BackendAuthenticationConfig",
 "properties": {
 "clientCertificate": {
@@ -5727,7 +5761,7 @@
 "type": "object"
 },
 "name": {
-"description": "Required. Name of the ClientTlsPolicy resource. It matches the pattern `projects/*/locations/{location}/clientTlsPolicies/{client_tls_policy}`",
+"description": "Required. Name of the ClientTlsPolicy resource. It matches the pattern `projects/{project}/locations/{location}/clientTlsPolicies/{client_tls_policy}`",
 "type": "string"
 },
 "serverValidationCa": {
diff --git a/googleapiclient/discovery_cache/documents/networksecurity.v1beta1.json b/googleapiclient/discovery_cache/documents/networksecurity.v1beta1.json
index 4ab378ef897..3fc40c2e4b3 100644
--- a/googleapiclient/discovery_cache/documents/networksecurity.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/networksecurity.v1beta1.json
@@ -2420,6 +2420,163 @@
 }
 }
 },
+"dnsThreatDetectors": {
+"methods": {
+"create": {
+"description": "Creates a new DnsThreatDetector in a given project and location.",
+"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/dnsThreatDetectors",
+"httpMethod": "POST",
+"id": "networksecurity.projects.locations.dnsThreatDetectors.create",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"dnsThreatDetectorId": {
+"description": "Optional. Id of the requesting DnsThreatDetector object. If this field is not supplied, the service will generate an identifier.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. Value for parent of the DnsThreatDetector resource.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta1/{+parent}/dnsThreatDetectors",
+"request": {
+"$ref": "DnsThreatDetector"
+},
+"response": {
+"$ref": "DnsThreatDetector"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"delete": {
+"description": "Deletes a single DnsThreatDetector.",
+"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/dnsThreatDetectors/{dnsThreatDetectorsId}",
+"httpMethod": "DELETE",
+"id": "networksecurity.projects.locations.dnsThreatDetectors.delete",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. Name of the DnsThreatDetector resource.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dnsThreatDetectors/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta1/{+name}",
+"response": {
+"$ref": "Empty"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"get": {
+"description": "Gets details of a single DnsThreatDetector.",
+"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/dnsThreatDetectors/{dnsThreatDetectorsId}",
+"httpMethod": "GET",
+"id": "networksecurity.projects.locations.dnsThreatDetectors.get",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Required. Name of the DnsThreatDetector resource",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dnsThreatDetectors/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta1/{+name}",
+"response": {
+"$ref": "DnsThreatDetector"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"list": {
+"description": "Lists DnsThreatDetectors in a given project and location.",
+"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/dnsThreatDetectors",
+"httpMethod": "GET",
+"id": "networksecurity.projects.locations.dnsThreatDetectors.list",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"pageSize": {
+"description": "Optional. Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.",
+"format": "int32",
+"location": "query",
+"type": "integer"
+},
+"pageToken": {
+"description": "Optional. A page token, received from a previous `ListDnsThreatDetectorsRequest` call. Provide this to retrieve the subsequent page.",
+"location": "query",
+"type": "string"
+},
+"parent": {
+"description": "Required. Parent value for ListDnsThreatDetectorsRequest",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1beta1/{+parent}/dnsThreatDetectors",
+"response": {
+"$ref": "ListDnsThreatDetectorsResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
+"patch": {
+"description": "Updates the parameters of a single DnsThreatDetector.",
+"flatPath": "v1beta1/projects/{projectsId}/locations/{locationsId}/dnsThreatDetectors/{dnsThreatDetectorsId}",
+"httpMethod": "PATCH",
+"id": "networksecurity.projects.locations.dnsThreatDetectors.patch",
+"parameterOrder": [
+"name"
+],
+"parameters": {
+"name": {
+"description": "Immutable. Identifier. Name of the DnsThreatDetector resource.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+/dnsThreatDetectors/[^/]+$",
+"required": true,
+"type": "string"
+},
+"updateMask": {
+"description": "Optional. Field mask is used to specify the fields to be overwritten in the DnsThreatDetector resource by the update. The fields specified in the update_mask are relative to the resource, not the full request. A field will be overwritten if it is in the mask. If the mask is not provided then all fields present in the request will be overwritten.",
+"format": "google-fieldmask",
+"location": "query",
+"type": "string"
+}
+},
+"path": "v1beta1/{+name}",
+"request": {
+"$ref": "DnsThreatDetector"
+},
+"response": {
+"$ref": "DnsThreatDetector"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+}
+}
+},
 "firewallEndpointAssociations": {
 "methods": {
 "create": {
@@ -5356,7 +5513,7 @@
 }
 }
 },
-"revision": "20250714",
+"revision": "20250721",
 "rootUrl": "https://networksecurity.googleapis.com/",
 "schemas": {
 "AddAddressGroupItemsRequest": {
@@ -6140,6 +6297,55 @@
 },
 "type": "object"
 },
+"DnsThreatDetector": {
+"description": "Message describing DnsThreatDetector object",
+"id": "DnsThreatDetector",
+"properties": {
+"createTime": {
+"description": "Output only. [Output only] Create time stamp",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+},
+"excludedNetworks": {
+"description": "Optional. A list of Network resource names which are exempt from the configuration in this DnsThreatDetector. Example: `projects/PROJECT_ID/global/networks/NETWORK_NAME`.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"labels": {
+"additionalProperties": {
+"type": "string"
+},
+"description": "Optional. Labels as key value pairs",
+"type": "object"
+},
+"name": {
+"description": "Immutable. Identifier. Name of the DnsThreatDetector resource.",
+"type": "string"
+},
+"provider": {
+"description": "Required. The provider used for DNS threat analysis.",
+"enum": [
+"PROVIDER_UNSPECIFIED",
+"INFOBLOX"
+],
+"enumDescriptions": [
+"An unspecified provider.",
+"The Infoblox DNS threat detecter."
+],
+"type": "string"
+},
+"updateTime": {
+"description": "Output only. [Output only] Update time stamp",
+"format": "google-datetime",
+"readOnly": true,
+"type": "string"
+}
+},
+"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",
@@ -7249,6 +7455,31 @@
 },
 "type": "object"
 },
+"ListDnsThreatDetectorsResponse": {
+"description": "Message for response to listing DnsThreatDetectors",
+"id": "ListDnsThreatDetectorsResponse",
+"properties": {
+"dnsThreatDetectors": {
+"description": "The list of DnsThreatDetector resources.",
+"items": {
+"$ref": "DnsThreatDetector"
+},
+"type": "array"
+},
+"nextPageToken": {
+"description": "A token, which can be sent as `page_token` to retrieve the next page.",
+"type": "string"
+},
+"unreachable": {
+"description": "Unordered list. Unreachable `DnsThreatDetector` resources.",
+"items": {
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "ListFirewallEndpointAssociationsResponse": {
 "description": "Message for response to listing Associations",
 "id": "ListFirewallEndpointAssociationsResponse",

From ee51df3c58c0c1dabcd7d9ff7a06688d57d84cbf Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:13 +0000
Subject: [PATCH 25/36] feat(redis): update the api

#### redis:v1

The following keys were added:
- schemas.BackupDRConfiguration (Total Keys: 3)
- schemas.Cluster.properties.satisfiesPzi (Total Keys: 2)
- schemas.Cluster.properties.satisfiesPzs (Total Keys: 2)
- schemas.DatabaseResourceMetadata.properties.backupdrConfiguration.$ref (Total Keys: 1)
- schemas.DatabaseResourceMetadata.properties.gcbdrConfiguration.deprecated (Total Keys: 1)

#### redis:v1beta1

The following keys were added:
- schemas.BackupDRConfiguration (Total Keys: 3)
- schemas.Cluster.properties.satisfiesPzi (Total Keys: 2)
- schemas.Cluster.properties.satisfiesPzs (Total Keys: 2)
- schemas.DatabaseResourceMetadata.properties.backupdrConfiguration.$ref (Total Keys: 1)
- schemas.DatabaseResourceMetadata.properties.gcbdrConfiguration.deprecated (Total Keys: 1)
---
 .../redis_v1.projects.locations.clusters.html |  8 +++
 ...s_v1beta1.projects.locations.clusters.html |  8 +++
 .../discovery_cache/documents/redis.v1.json   | 53 ++++++++++++++++---
 .../documents/redis.v1beta1.json              | 53 ++++++++++++++++---
 4 files changed, 110 insertions(+), 12 deletions(-)

diff --git a/docs/dyn/redis_v1.projects.locations.clusters.html b/docs/dyn/redis_v1.projects.locations.clusters.html
index 3ac1ac70c10..1ecbc5a5299 100644
--- a/docs/dyn/redis_v1.projects.locations.clusters.html
+++ b/docs/dyn/redis_v1.projects.locations.clusters.html
@@ -323,6 +323,8 @@ 
Method Details

     "a_key": "A String",
   },
   "replicaCount": 42, # Optional. The number of replica nodes per shard.
+  "satisfiesPzi": True or False, # Optional. Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Optional. Output only. Reserved for future use.
   "shardCount": 42, # Optional. Number of shards for the Redis cluster.
   "simulateMaintenanceEvent": True or False, # Optional. Input only. Simulate a maintenance event.
   "sizeGb": 42, # Output only. Redis memory size in GB for the entire cluster rounded up to the next integer.
@@ -584,6 +586,8 @@ 
Method Details

     "a_key": "A String",
   },
   "replicaCount": 42, # Optional. The number of replica nodes per shard.
+  "satisfiesPzi": True or False, # Optional. Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Optional. Output only. Reserved for future use.
   "shardCount": 42, # Optional. Number of shards for the Redis cluster.
   "simulateMaintenanceEvent": True or False, # Optional. Input only. Simulate a maintenance event.
   "sizeGb": 42, # Output only. Redis memory size in GB for the entire cluster rounded up to the next integer.
@@ -811,6 +815,8 @@ 
Method Details

         "a_key": "A String",
       },
       "replicaCount": 42, # Optional. The number of replica nodes per shard.
+      "satisfiesPzi": True or False, # Optional. Output only. Reserved for future use.
+      "satisfiesPzs": True or False, # Optional. Output only. Reserved for future use.
       "shardCount": 42, # Optional. Number of shards for the Redis cluster.
       "simulateMaintenanceEvent": True or False, # Optional. Input only. Simulate a maintenance event.
       "sizeGb": 42, # Output only. Redis memory size in GB for the entire cluster rounded up to the next integer.
@@ -1021,6 +1027,8 @@ 
Method Details

     "a_key": "A String",
   },
   "replicaCount": 42, # Optional. The number of replica nodes per shard.
+  "satisfiesPzi": True or False, # Optional. Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Optional. Output only. Reserved for future use.
   "shardCount": 42, # Optional. Number of shards for the Redis cluster.
   "simulateMaintenanceEvent": True or False, # Optional. Input only. Simulate a maintenance event.
   "sizeGb": 42, # Output only. Redis memory size in GB for the entire cluster rounded up to the next integer.
diff --git a/docs/dyn/redis_v1beta1.projects.locations.clusters.html b/docs/dyn/redis_v1beta1.projects.locations.clusters.html
index 2c4c472fc6a..40c2e5cac2f 100644
--- a/docs/dyn/redis_v1beta1.projects.locations.clusters.html
+++ b/docs/dyn/redis_v1beta1.projects.locations.clusters.html
@@ -323,6 +323,8 @@ 
Method Details

     "a_key": "A String",
   },
   "replicaCount": 42, # Optional. The number of replica nodes per shard.
+  "satisfiesPzi": True or False, # Optional. Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Optional. Output only. Reserved for future use.
   "shardCount": 42, # Optional. Number of shards for the Redis cluster.
   "simulateMaintenanceEvent": True or False, # Optional. Input only. Simulate a maintenance event.
   "sizeGb": 42, # Output only. Redis memory size in GB for the entire cluster rounded up to the next integer.
@@ -584,6 +586,8 @@ 
Method Details

     "a_key": "A String",
   },
   "replicaCount": 42, # Optional. The number of replica nodes per shard.
+  "satisfiesPzi": True or False, # Optional. Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Optional. Output only. Reserved for future use.
   "shardCount": 42, # Optional. Number of shards for the Redis cluster.
   "simulateMaintenanceEvent": True or False, # Optional. Input only. Simulate a maintenance event.
   "sizeGb": 42, # Output only. Redis memory size in GB for the entire cluster rounded up to the next integer.
@@ -811,6 +815,8 @@ 
Method Details

         "a_key": "A String",
       },
       "replicaCount": 42, # Optional. The number of replica nodes per shard.
+      "satisfiesPzi": True or False, # Optional. Output only. Reserved for future use.
+      "satisfiesPzs": True or False, # Optional. Output only. Reserved for future use.
       "shardCount": 42, # Optional. Number of shards for the Redis cluster.
       "simulateMaintenanceEvent": True or False, # Optional. Input only. Simulate a maintenance event.
       "sizeGb": 42, # Output only. Redis memory size in GB for the entire cluster rounded up to the next integer.
@@ -1021,6 +1027,8 @@ 
Method Details

     "a_key": "A String",
   },
   "replicaCount": 42, # Optional. The number of replica nodes per shard.
+  "satisfiesPzi": True or False, # Optional. Output only. Reserved for future use.
+  "satisfiesPzs": True or False, # Optional. Output only. Reserved for future use.
   "shardCount": 42, # Optional. Number of shards for the Redis cluster.
   "simulateMaintenanceEvent": True or False, # Optional. Input only. Simulate a maintenance event.
   "sizeGb": 42, # Output only. Redis memory size in GB for the entire cluster rounded up to the next integer.
diff --git a/googleapiclient/discovery_cache/documents/redis.v1.json b/googleapiclient/discovery_cache/documents/redis.v1.json
index 73ca4b49c76..315765f5311 100644
--- a/googleapiclient/discovery_cache/documents/redis.v1.json
+++ b/googleapiclient/discovery_cache/documents/redis.v1.json
@@ -1073,7 +1073,7 @@
 }
 }
 },
-"revision": "20250701",
+"revision": "20250718",
 "rootUrl": "https://redis.googleapis.com/",
 "schemas": {
 "AOFConfig": {
@@ -1367,6 +1367,17 @@
 },
 "type": "object"
 },
+"BackupDRConfiguration": {
+"description": "BackupDRConfiguration to capture the backup and disaster recovery details of database resource.",
+"id": "BackupDRConfiguration",
+"properties": {
+"backupdrManaged": {
+"description": "Indicates if the resource is managed by BackupDR.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "BackupFile": {
 "description": "Backup is consisted of multiple backup files.",
 "id": "BackupFile",
@@ -1615,6 +1626,16 @@
 "format": "int32",
 "type": "integer"
 },
+"satisfiesPzi": {
+"description": "Optional. Output only. Reserved for future use.",
+"readOnly": true,
+"type": "boolean"
+},
+"satisfiesPzs": {
+"description": "Optional. Output only. Reserved for future use.",
+"readOnly": true,
+"type": "boolean"
+},
 "shardCount": {
 "description": "Optional. Number of shards for the Redis cluster.",
 "format": "int32",
@@ -2203,7 +2224,9 @@
 "SIGNAL_TYPE_HIGH_READ_PRESSURE",
 "SIGNAL_TYPE_ENCRYPTION_ORG_POLICY_NOT_SATISFIED",
 "SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED",
-"SIGNAL_TYPE_OUTDATED_MINOR_VERSION"
+"SIGNAL_TYPE_OUTDATED_MINOR_VERSION",
+"SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED",
+"SIGNAL_TYPE_MANY_IDLE_CONNECTIONS"
 ],
 "enumDeprecated": [
 false,
@@ -2302,6 +2325,8 @@ false,
 false,
 false,
 false,
+false,
+false,
 false
 ],
 "enumDescriptions": [
@@ -2401,7 +2426,9 @@ false
 "Heavy read pressure on the database rows.",
 "Encryption org policy not satisfied.",
 "Location org policy not satisfied.",
-"Outdated DB minor version."
+"Outdated DB minor version.",
+"Schema not optimized.",
+"High number of idle connections."
 ],
 "type": "string"
 },
@@ -2465,7 +2492,7 @@ false
 "type": "object"
 },
 "DatabaseResourceMetadata": {
-"description": "Common model for database resource instance metadata. Next ID: 25",
+"description": "Common model for database resource instance metadata. Next ID: 26",
 "id": "DatabaseResourceMetadata",
 "properties": {
 "availabilityConfiguration": {
@@ -2480,6 +2507,10 @@ false
 "$ref": "BackupRun",
 "description": "Latest backup run information for this instance"
 },
+"backupdrConfiguration": {
+"$ref": "BackupDRConfiguration",
+"description": "Optional. BackupDR Configuration for the resource."
+},
 "creationTime": {
 "description": "The creation time of the resource, i.e. the time when resource is created and recorded in partner service.",
 "format": "google-datetime",
@@ -2552,6 +2583,7 @@ false
 },
 "gcbdrConfiguration": {
 "$ref": "GCBDRConfiguration",
+"deprecated": true,
 "description": "GCBDR configuration for the resource."
 },
 "id": {
@@ -2819,7 +2851,9 @@ false
 "SIGNAL_TYPE_HIGH_READ_PRESSURE",
 "SIGNAL_TYPE_ENCRYPTION_ORG_POLICY_NOT_SATISFIED",
 "SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED",
-"SIGNAL_TYPE_OUTDATED_MINOR_VERSION"
+"SIGNAL_TYPE_OUTDATED_MINOR_VERSION",
+"SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED",
+"SIGNAL_TYPE_MANY_IDLE_CONNECTIONS"
 ],
 "enumDeprecated": [
 false,
@@ -2918,6 +2952,8 @@ false,
 false,
 false,
 false,
+false,
+false,
 false
 ],
 "enumDescriptions": [
@@ -3017,7 +3053,9 @@ false
 "Heavy read pressure on the database rows.",
 "Encryption org policy not satisfied.",
 "Location org policy not satisfied.",
-"Outdated DB minor version."
+"Outdated DB minor version.",
+"Schema not optimized.",
+"High number of idle connections."
 ],
 "type": "string"
 }
@@ -4230,6 +4268,7 @@ false
 "ENGINE_OTHER",
 "ENGINE_FIRESTORE_WITH_NATIVE_MODE",
 "ENGINE_FIRESTORE_WITH_DATASTORE_MODE",
+"ENGINE_FIRESTORE_WITH_MONGODB_COMPATIBILITY_MODE",
 "ENGINE_EXADATA_ORACLE",
 "ENGINE_ADB_SERVERLESS_ORACLE"
 ],
@@ -4251,6 +4290,7 @@ false,
 false,
 false,
 false,
+false,
 false
 ],
 "enumDescriptions": [
@@ -4270,6 +4310,7 @@ false
 "Other refers to rest of other database engine. This is to be when engine is known, but it is not present in this enum.",
 "Firestore with native mode.",
 "Firestore with datastore mode.",
+"Firestore with MongoDB compatibility mode.",
 "Oracle Exadata engine.",
 "Oracle Autonomous DB Serverless engine."
 ],
diff --git a/googleapiclient/discovery_cache/documents/redis.v1beta1.json b/googleapiclient/discovery_cache/documents/redis.v1beta1.json
index f6691811128..895b9bfe35b 100644
--- a/googleapiclient/discovery_cache/documents/redis.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/redis.v1beta1.json
@@ -1073,7 +1073,7 @@
 }
 }
 },
-"revision": "20250701",
+"revision": "20250718",
 "rootUrl": "https://redis.googleapis.com/",
 "schemas": {
 "AOFConfig": {
@@ -1367,6 +1367,17 @@
 },
 "type": "object"
 },
+"BackupDRConfiguration": {
+"description": "BackupDRConfiguration to capture the backup and disaster recovery details of database resource.",
+"id": "BackupDRConfiguration",
+"properties": {
+"backupdrManaged": {
+"description": "Indicates if the resource is managed by BackupDR.",
+"type": "boolean"
+}
+},
+"type": "object"
+},
 "BackupFile": {
 "description": "Backup is consisted of multiple backup files.",
 "id": "BackupFile",
@@ -1615,6 +1626,16 @@
 "format": "int32",
 "type": "integer"
 },
+"satisfiesPzi": {
+"description": "Optional. Output only. Reserved for future use.",
+"readOnly": true,
+"type": "boolean"
+},
+"satisfiesPzs": {
+"description": "Optional. Output only. Reserved for future use.",
+"readOnly": true,
+"type": "boolean"
+},
 "shardCount": {
 "description": "Optional. Number of shards for the Redis cluster.",
 "format": "int32",
@@ -2203,7 +2224,9 @@
 "SIGNAL_TYPE_HIGH_READ_PRESSURE",
 "SIGNAL_TYPE_ENCRYPTION_ORG_POLICY_NOT_SATISFIED",
 "SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED",
-"SIGNAL_TYPE_OUTDATED_MINOR_VERSION"
+"SIGNAL_TYPE_OUTDATED_MINOR_VERSION",
+"SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED",
+"SIGNAL_TYPE_MANY_IDLE_CONNECTIONS"
 ],
 "enumDeprecated": [
 false,
@@ -2302,6 +2325,8 @@ false,
 false,
 false,
 false,
+false,
+false,
 false
 ],
 "enumDescriptions": [
@@ -2401,7 +2426,9 @@ false
 "Heavy read pressure on the database rows.",
 "Encryption org policy not satisfied.",
 "Location org policy not satisfied.",
-"Outdated DB minor version."
+"Outdated DB minor version.",
+"Schema not optimized.",
+"High number of idle connections."
 ],
 "type": "string"
 },
@@ -2465,7 +2492,7 @@ false
 "type": "object"
 },
 "DatabaseResourceMetadata": {
-"description": "Common model for database resource instance metadata. Next ID: 25",
+"description": "Common model for database resource instance metadata. Next ID: 26",
 "id": "DatabaseResourceMetadata",
 "properties": {
 "availabilityConfiguration": {
@@ -2480,6 +2507,10 @@ false
 "$ref": "BackupRun",
 "description": "Latest backup run information for this instance"
 },
+"backupdrConfiguration": {
+"$ref": "BackupDRConfiguration",
+"description": "Optional. BackupDR Configuration for the resource."
+},
 "creationTime": {
 "description": "The creation time of the resource, i.e. the time when resource is created and recorded in partner service.",
 "format": "google-datetime",
@@ -2552,6 +2583,7 @@ false
 },
 "gcbdrConfiguration": {
 "$ref": "GCBDRConfiguration",
+"deprecated": true,
 "description": "GCBDR configuration for the resource."
 },
 "id": {
@@ -2819,7 +2851,9 @@ false
 "SIGNAL_TYPE_HIGH_READ_PRESSURE",
 "SIGNAL_TYPE_ENCRYPTION_ORG_POLICY_NOT_SATISFIED",
 "SIGNAL_TYPE_LOCATION_ORG_POLICY_NOT_SATISFIED",
-"SIGNAL_TYPE_OUTDATED_MINOR_VERSION"
+"SIGNAL_TYPE_OUTDATED_MINOR_VERSION",
+"SIGNAL_TYPE_SCHEMA_NOT_OPTIMIZED",
+"SIGNAL_TYPE_MANY_IDLE_CONNECTIONS"
 ],
 "enumDeprecated": [
 false,
@@ -2918,6 +2952,8 @@ false,
 false,
 false,
 false,
+false,
+false,
 false
 ],
 "enumDescriptions": [
@@ -3017,7 +3053,9 @@ false
 "Heavy read pressure on the database rows.",
 "Encryption org policy not satisfied.",
 "Location org policy not satisfied.",
-"Outdated DB minor version."
+"Outdated DB minor version.",
+"Schema not optimized.",
+"High number of idle connections."
 ],
 "type": "string"
 }
@@ -4237,6 +4275,7 @@ false
 "ENGINE_OTHER",
 "ENGINE_FIRESTORE_WITH_NATIVE_MODE",
 "ENGINE_FIRESTORE_WITH_DATASTORE_MODE",
+"ENGINE_FIRESTORE_WITH_MONGODB_COMPATIBILITY_MODE",
 "ENGINE_EXADATA_ORACLE",
 "ENGINE_ADB_SERVERLESS_ORACLE"
 ],
@@ -4258,6 +4297,7 @@ false,
 false,
 false,
 false,
+false,
 false
 ],
 "enumDescriptions": [
@@ -4277,6 +4317,7 @@ false
 "Other refers to rest of other database engine. This is to be when engine is known, but it is not present in this enum.",
 "Firestore with native mode.",
 "Firestore with datastore mode.",
+"Firestore with MongoDB compatibility mode.",
 "Oracle Exadata engine.",
 "Oracle Autonomous DB Serverless engine."
 ],

From 4c4f2dc79c5e81a79bf1054ccb1dc57a515ef7f6 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:13 +0000
Subject: [PATCH 26/36] feat(retail): update the api

#### retail:v2

The following keys were added:
- schemas.GoogleCloudRetailV2PanelInfo (Total Keys: 11)
- schemas.GoogleCloudRetailV2UserEvent.properties.panels (Total Keys: 2)

#### retail:v2alpha

The following keys were added:
- schemas.GoogleCloudRetailV2alphaConversationalSearchRequest.properties.safetySettings (Total Keys: 2)
- schemas.GoogleCloudRetailV2alphaMerchantCenterFeedFilter.properties.primaryFeedId (Total Keys: 3)
- schemas.GoogleCloudRetailV2alphaPanelInfo (Total Keys: 11)
- schemas.GoogleCloudRetailV2alphaSafetySetting (Total Keys: 5)
- schemas.GoogleCloudRetailV2alphaUserEvent.properties.panels (Total Keys: 2)

#### retail:v2beta

The following keys were added:
- schemas.GoogleCloudRetailV2betaMerchantCenterFeedFilter.properties.primaryFeedId (Total Keys: 3)
- schemas.GoogleCloudRetailV2betaPanelInfo (Total Keys: 11)
- schemas.GoogleCloudRetailV2betaUserEvent.properties.panels (Total Keys: 2)
---
 ...rojects.locations.catalogs.placements.html | 178 ++++++
 ...cts.locations.catalogs.servingConfigs.html | 178 ++++++
 ...rojects.locations.catalogs.userEvents.html | 534 +++++++++++++++++
 ...l_v2alpha.projects.locations.catalogs.html |   3 +
 ...rojects.locations.catalogs.placements.html | 186 ++++++
 ...cts.locations.catalogs.servingConfigs.html | 186 ++++++
 ...rojects.locations.catalogs.userEvents.html | 537 ++++++++++++++++++
 ...il_v2beta.projects.locations.catalogs.html |   3 +
 ...rojects.locations.catalogs.placements.html | 178 ++++++
 ...cts.locations.catalogs.servingConfigs.html | 178 ++++++
 ...rojects.locations.catalogs.userEvents.html | 534 +++++++++++++++++
 .../discovery_cache/documents/retail.v2.json  |  45 +-
 .../documents/retail.v2alpha.json             | 119 +++-
 .../documents/retail.v2beta.json              |  51 +-
 14 files changed, 2907 insertions(+), 3 deletions(-)

diff --git a/docs/dyn/retail_v2.projects.locations.catalogs.placements.html b/docs/dyn/retail_v2.projects.locations.catalogs.placements.html
index 5a96da8cd69..17e8a6db2da 100644
--- a/docs/dyn/retail_v2.projects.locations.catalogs.placements.html
+++ b/docs/dyn/retail_v2.projects.locations.catalogs.placements.html
@@ -144,6 +144,184 @@ 
Method Details

       "A String",
     ],
     "pageViewId": "A String", # A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
+    "panels": [ # Optional. List of panels associated with this event. Used for panel-level impression data.
+      { # Detailed panel information associated with a user event.
+        "attributionToken": "A String", # Optional. The attribution token of the panel.
+        "displayName": "A String", # Optional. The display name of the panel.
+        "panelId": "A String", # Required. The panel ID.
+        "panelPosition": 42, # Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.
+        "productDetails": [ # Optional. The product details associated with the panel.
+          { # Detailed product information associated with a user event.
+            "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
+              "attributes": { # Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here. Features that can take on one of a limited number of possible values. Two types of features can be set are: Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer. For example: `{ "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": {"numbers":[2.3, 15.4]}, "heights_cm": {"numbers":[8.1, 6.4]} }`. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * Max entries count: 200. * The key must be a UTF-8 encoded string with a length limit of 128 characters. * For indexable attribute, the key must match the pattern: `a-zA-Z0-9*`. For example, `key0LikeThis` or `KEY_1_LIKE_THIS`. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed.
+                "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                  "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                  "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                    3.14,
+                  ],
+                  "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                  "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                },
+              },
+              "audience": { # An intended audience of the Product for whom it's sold. # The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product.
+                "ageGroups": [ # The age groups of the audience. Strongly encouraged to use the standard values: "newborn" (up to 3 months old), "infant" (3–12 months old), "toddler" (1–5 years old), "kids" (5–13 years old), "adult" (typically teens or older). At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [age_group](https://support.google.com/merchants/answer/6324463). Schema.org property [Product.audience.suggestedMinAge](https://schema.org/suggestedMinAge) and [Product.audience.suggestedMaxAge](https://schema.org/suggestedMaxAge).
+                  "A String",
+                ],
+                "genders": [ # The genders of the audience. Strongly encouraged to use the standard values: "male", "female", "unisex". At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [gender](https://support.google.com/merchants/answer/6324479). Schema.org property [Product.audience.suggestedGender](https://schema.org/suggestedGender).
+                  "A String",
+                ],
+              },
+              "availability": "A String", # The online availability of the Product. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+              "availableQuantity": 42, # The available quantity of the item.
+              "availableTime": "A String", # The timestamp when this Product becomes available for SearchService.Search. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT.
+              "brands": [ # The brands of the product. A maximum of 30 brands are allowed unless overridden through the Google Cloud console. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [brand](https://support.google.com/merchants/answer/6324351). Schema.org property [Product.brand](https://schema.org/brand).
+                "A String",
+              ],
+              "categories": [ # Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as: "categories": [ "Shoes & Accessories > Shoes", "Sports & Fitness > Athletic Clothing > Shoes" ] Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned. At most 250 values are allowed per Product unless overridden through the Google Cloud console. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property google_product_category. Schema.org property [Product.category] (https://schema.org/category). [mc_google_product_category]: https://support.google.com/merchants/answer/6324436
+                "A String",
+              ],
+              "collectionMemberIds": [ # The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.
+                "A String",
+              ],
+              "colorInfo": { # The color information of a Product. # The color of the product. Corresponding properties: Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                "colorFamilies": [ # The standard color families. Strongly recommended to use the following standard color groups: "Red", "Pink", "Orange", "Yellow", "Purple", "Green", "Cyan", "Blue", "Brown", "White", "Gray", "Black" and "Mixed". Normally it is expected to have only 1 color family. May consider using single "Mixed" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.
+                  "A String",
+                ],
+                "colors": [ # The color display names, which may be different from standard color family names, such as the color aliases used in the website frontend. Normally it is expected to have only 1 color. May consider using single "Mixed" instead of multiple values. A maximum of 75 colors are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                  "A String",
+                ],
+              },
+              "conditions": [ # The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used". A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [condition](https://support.google.com/merchants/answer/6324469). Schema.org property [Offer.itemCondition](https://schema.org/itemCondition).
+                "A String",
+              ],
+              "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
+              "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+              "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
+                { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
+                  "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                  "type": "A String", # The fulfillment type, including commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned.
+                },
+              ],
+              "gtin": "A String", # The Global Trade Item Number (GTIN) of the product. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [gtin](https://support.google.com/merchants/answer/6324461). Schema.org property [Product.isbn](https://schema.org/isbn), [Product.gtin8](https://schema.org/gtin8), [Product.gtin12](https://schema.org/gtin12), [Product.gtin13](https://schema.org/gtin13), or [Product.gtin14](https://schema.org/gtin14). If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.
+              "id": "A String", # Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1`. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [id](https://support.google.com/merchants/answer/6324405). Schema.org property [Product.sku](https://schema.org/sku).
+              "images": [ # Product images for the product. We highly recommend putting the main image first. A maximum of 300 images are allowed. Corresponding properties: Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                { # Product image. Recommendations AI and Retail Search use product images to improve prediction and search results. Product images can be returned in results, and are shown in prediction or search previews in the console. Please try to provide correct product images and avoid using images with size too small.
+                  "height": 42, # Height of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "uri": "A String", # Required. URI of the image. This field must be a valid UTF-8 encoded URI with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                  "width": 42, # Width of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                },
+              ],
+              "languageCode": "A String", # Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance. For product search this field is in use. It defaults to "en-US" if unset.
+              "localInventories": [ # Output only. A list of local inventories specific to different places. This field can be managed by ProductService.AddLocalInventories and ProductService.RemoveLocalInventories APIs if fine-grained, high-volume updates are necessary.
+                { # The inventory information at a place (e.g. a store) identified by a place ID.
+                  "attributes": { # Optional. Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.
+                    "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                      "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                      "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                        3.14,
+                      ],
+                      "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                      "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                        "A String",
+                      ],
+                    },
+                  },
+                  "fulfillmentTypes": [ # Optional. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                  "placeId": "A String", # Optional. The place ID for the current set of inventory information.
+                  "priceInfo": { # The price information of a Product. # Optional. Product price and cost information. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                    "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                    "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                    "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                    "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                    "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                    "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                    "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                      "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                        "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                        "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                        "maximum": 3.14, # Inclusive upper bound.
+                        "minimum": 3.14, # Inclusive lower bound.
+                      },
+                      "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                        "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                        "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                        "maximum": 3.14, # Inclusive upper bound.
+                        "minimum": 3.14, # Inclusive lower bound.
+                      },
+                    },
+                  },
+                },
+              ],
+              "materials": [ # The material of the product. For example, "leather", "wooden". A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [material](https://support.google.com/merchants/answer/6324410). Schema.org property [Product.material](https://schema.org/material).
+                "A String",
+              ],
+              "name": "A String", # Immutable. Full resource name of the product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id`.
+              "patterns": [ # The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [pattern](https://support.google.com/merchants/answer/6324483). Schema.org property [Product.pattern](https://schema.org/pattern).
+                "A String",
+              ],
+              "priceInfo": { # The price information of a Product. # Product price and cost information. Corresponding properties: Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                  "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                    "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                    "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                    "maximum": 3.14, # Inclusive upper bound.
+                    "minimum": 3.14, # Inclusive lower bound.
+                  },
+                  "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                    "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                    "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                    "maximum": 3.14, # Inclusive upper bound.
+                    "minimum": 3.14, # Inclusive lower bound.
+                  },
+                },
+              },
+              "primaryProductId": "A String", # Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown. For Type.PRIMARY Products, this field can only be empty or set to the same value as id. For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [item_group_id](https://support.google.com/merchants/answer/6324507). Schema.org property [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID).
+              "promotions": [ # The promotions applied to the product. A maximum of 10 values are allowed per Product. Only Promotion.promotion_id will be used, other fields will be ignored if set.
+                { # Promotion specification.
+                  "promotionId": "A String", # Promotion identifier, which is the final component of name. For example, this field is "free_gift", if name is `projects/*/locations/global/catalogs/default_catalog/promotions/free_gift`. The value must be a UTF-8 encoded string with a length limit of 128 characters, and match the pattern: `a-zA-Z*`. For example, id0LikeThis or ID_1_LIKE_THIS. Otherwise, an INVALID_ARGUMENT error is returned. Corresponds to Google Merchant Center property [promotion_id](https://support.google.com/merchants/answer/7050148).
+                },
+              ],
+              "publishTime": "A String", # The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.
+              "rating": { # The rating of a Product. # The rating of this product.
+                "averageRating": 3.14, # The average rating of the Product. The rating is scaled at 1-5. Otherwise, an INVALID_ARGUMENT error is returned.
+                "ratingCount": 42, # The total number of ratings. This value is independent of the value of rating_histogram. This value must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                "ratingHistogram": [ # List of rating counts per rating value (index = rating - 1). The list is empty if there is no rating. If the list is non-empty, its size is always 5. Otherwise, an INVALID_ARGUMENT error is returned. For example, [41, 14, 13, 47, 303]. It means that the Product got 41 ratings with 1 star, 14 ratings with 2 star, and so on.
+                  42,
+                ],
+              },
+              "retrievableFields": "A String", # Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
+              "sizes": [ # The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value]. For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [size](https://support.google.com/merchants/answer/6324492), [size_type](https://support.google.com/merchants/answer/6324497), and [size_system](https://support.google.com/merchants/answer/6324502). Schema.org property [Product.size](https://schema.org/size).
+                "A String",
+              ],
+              "tags": [ # Custom tags associated with the product. At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter. Corresponding properties: Google Merchant Center property [custom_label_0–4](https://support.google.com/merchants/answer/6324473).
+                "A String",
+              ],
+              "title": "A String", # Required. Product title. This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [title](https://support.google.com/merchants/answer/6324415). Schema.org property [Product.name](https://schema.org/name).
+              "ttl": "A String", # Input only. The TTL (time to live) of the product. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. If it is set, it must be a non-negative value, and expire_time is set as current timestamp plus ttl. The derived expire_time is returned in the output and ttl is left blank when retrieving the Product. If it is set, the product is not available for SearchService.Search after current timestamp plus ttl. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts.
+              "type": "A String", # Immutable. The type of the product. Default to Catalog.product_level_config.ingestion_product_type if unset.
+              "uri": "A String", # Canonical URL directly linking to the product detail page. It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [link](https://support.google.com/merchants/answer/6324416). Schema.org property [Offer.url](https://schema.org/url).
+              "variants": [ # Output only. Product variants grouped together on primary product which share similar product attributes. It's automatically grouped by primary_product_id for all the product variants. Only populated for Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                # Object with schema name: GoogleCloudRetailV2Product
+              ],
+            },
+            "quantity": 42, # Quantity of the product associated with the user event. For example, this field will be 2 if two products are added to the shopping cart for `purchase-complete` event. Required for `add-to-cart` and `purchase-complete` event types.
+          },
+        ],
+        "totalPanels": 42, # Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.
+      },
+    ],
     "productDetails": [ # The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.
       { # Detailed product information associated with a user event.
         "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
diff --git a/docs/dyn/retail_v2.projects.locations.catalogs.servingConfigs.html b/docs/dyn/retail_v2.projects.locations.catalogs.servingConfigs.html
index d7597e6c00e..5a4f196d72e 100644
--- a/docs/dyn/retail_v2.projects.locations.catalogs.servingConfigs.html
+++ b/docs/dyn/retail_v2.projects.locations.catalogs.servingConfigs.html
@@ -626,6 +626,184 @@ 
Method Details

       "A String",
     ],
     "pageViewId": "A String", # A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
+    "panels": [ # Optional. List of panels associated with this event. Used for panel-level impression data.
+      { # Detailed panel information associated with a user event.
+        "attributionToken": "A String", # Optional. The attribution token of the panel.
+        "displayName": "A String", # Optional. The display name of the panel.
+        "panelId": "A String", # Required. The panel ID.
+        "panelPosition": 42, # Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.
+        "productDetails": [ # Optional. The product details associated with the panel.
+          { # Detailed product information associated with a user event.
+            "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
+              "attributes": { # Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here. Features that can take on one of a limited number of possible values. Two types of features can be set are: Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer. For example: `{ "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": {"numbers":[2.3, 15.4]}, "heights_cm": {"numbers":[8.1, 6.4]} }`. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * Max entries count: 200. * The key must be a UTF-8 encoded string with a length limit of 128 characters. * For indexable attribute, the key must match the pattern: `a-zA-Z0-9*`. For example, `key0LikeThis` or `KEY_1_LIKE_THIS`. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed.
+                "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                  "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                  "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                    3.14,
+                  ],
+                  "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                  "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                },
+              },
+              "audience": { # An intended audience of the Product for whom it's sold. # The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product.
+                "ageGroups": [ # The age groups of the audience. Strongly encouraged to use the standard values: "newborn" (up to 3 months old), "infant" (3–12 months old), "toddler" (1–5 years old), "kids" (5–13 years old), "adult" (typically teens or older). At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [age_group](https://support.google.com/merchants/answer/6324463). Schema.org property [Product.audience.suggestedMinAge](https://schema.org/suggestedMinAge) and [Product.audience.suggestedMaxAge](https://schema.org/suggestedMaxAge).
+                  "A String",
+                ],
+                "genders": [ # The genders of the audience. Strongly encouraged to use the standard values: "male", "female", "unisex". At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [gender](https://support.google.com/merchants/answer/6324479). Schema.org property [Product.audience.suggestedGender](https://schema.org/suggestedGender).
+                  "A String",
+                ],
+              },
+              "availability": "A String", # The online availability of the Product. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+              "availableQuantity": 42, # The available quantity of the item.
+              "availableTime": "A String", # The timestamp when this Product becomes available for SearchService.Search. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT.
+              "brands": [ # The brands of the product. A maximum of 30 brands are allowed unless overridden through the Google Cloud console. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [brand](https://support.google.com/merchants/answer/6324351). Schema.org property [Product.brand](https://schema.org/brand).
+                "A String",
+              ],
+              "categories": [ # Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as: "categories": [ "Shoes & Accessories > Shoes", "Sports & Fitness > Athletic Clothing > Shoes" ] Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned. At most 250 values are allowed per Product unless overridden through the Google Cloud console. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property google_product_category. Schema.org property [Product.category] (https://schema.org/category). [mc_google_product_category]: https://support.google.com/merchants/answer/6324436
+                "A String",
+              ],
+              "collectionMemberIds": [ # The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.
+                "A String",
+              ],
+              "colorInfo": { # The color information of a Product. # The color of the product. Corresponding properties: Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                "colorFamilies": [ # The standard color families. Strongly recommended to use the following standard color groups: "Red", "Pink", "Orange", "Yellow", "Purple", "Green", "Cyan", "Blue", "Brown", "White", "Gray", "Black" and "Mixed". Normally it is expected to have only 1 color family. May consider using single "Mixed" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.
+                  "A String",
+                ],
+                "colors": [ # The color display names, which may be different from standard color family names, such as the color aliases used in the website frontend. Normally it is expected to have only 1 color. May consider using single "Mixed" instead of multiple values. A maximum of 75 colors are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                  "A String",
+                ],
+              },
+              "conditions": [ # The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used". A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [condition](https://support.google.com/merchants/answer/6324469). Schema.org property [Offer.itemCondition](https://schema.org/itemCondition).
+                "A String",
+              ],
+              "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
+              "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+              "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
+                { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
+                  "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                  "type": "A String", # The fulfillment type, including commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned.
+                },
+              ],
+              "gtin": "A String", # The Global Trade Item Number (GTIN) of the product. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [gtin](https://support.google.com/merchants/answer/6324461). Schema.org property [Product.isbn](https://schema.org/isbn), [Product.gtin8](https://schema.org/gtin8), [Product.gtin12](https://schema.org/gtin12), [Product.gtin13](https://schema.org/gtin13), or [Product.gtin14](https://schema.org/gtin14). If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.
+              "id": "A String", # Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1`. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [id](https://support.google.com/merchants/answer/6324405). Schema.org property [Product.sku](https://schema.org/sku).
+              "images": [ # Product images for the product. We highly recommend putting the main image first. A maximum of 300 images are allowed. Corresponding properties: Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                { # Product image. Recommendations AI and Retail Search use product images to improve prediction and search results. Product images can be returned in results, and are shown in prediction or search previews in the console. Please try to provide correct product images and avoid using images with size too small.
+                  "height": 42, # Height of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "uri": "A String", # Required. URI of the image. This field must be a valid UTF-8 encoded URI with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                  "width": 42, # Width of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                },
+              ],
+              "languageCode": "A String", # Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance. For product search this field is in use. It defaults to "en-US" if unset.
+              "localInventories": [ # Output only. A list of local inventories specific to different places. This field can be managed by ProductService.AddLocalInventories and ProductService.RemoveLocalInventories APIs if fine-grained, high-volume updates are necessary.
+                { # The inventory information at a place (e.g. a store) identified by a place ID.
+                  "attributes": { # Optional. Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.
+                    "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                      "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                      "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                        3.14,
+                      ],
+                      "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                      "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                        "A String",
+                      ],
+                    },
+                  },
+                  "fulfillmentTypes": [ # Optional. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                  "placeId": "A String", # Optional. The place ID for the current set of inventory information.
+                  "priceInfo": { # The price information of a Product. # Optional. Product price and cost information. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                    "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                    "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                    "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                    "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                    "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                    "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                    "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                      "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                        "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                        "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                        "maximum": 3.14, # Inclusive upper bound.
+                        "minimum": 3.14, # Inclusive lower bound.
+                      },
+                      "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                        "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                        "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                        "maximum": 3.14, # Inclusive upper bound.
+                        "minimum": 3.14, # Inclusive lower bound.
+                      },
+                    },
+                  },
+                },
+              ],
+              "materials": [ # The material of the product. For example, "leather", "wooden". A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [material](https://support.google.com/merchants/answer/6324410). Schema.org property [Product.material](https://schema.org/material).
+                "A String",
+              ],
+              "name": "A String", # Immutable. Full resource name of the product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id`.
+              "patterns": [ # The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [pattern](https://support.google.com/merchants/answer/6324483). Schema.org property [Product.pattern](https://schema.org/pattern).
+                "A String",
+              ],
+              "priceInfo": { # The price information of a Product. # Product price and cost information. Corresponding properties: Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                  "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                    "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                    "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                    "maximum": 3.14, # Inclusive upper bound.
+                    "minimum": 3.14, # Inclusive lower bound.
+                  },
+                  "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                    "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                    "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                    "maximum": 3.14, # Inclusive upper bound.
+                    "minimum": 3.14, # Inclusive lower bound.
+                  },
+                },
+              },
+              "primaryProductId": "A String", # Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown. For Type.PRIMARY Products, this field can only be empty or set to the same value as id. For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [item_group_id](https://support.google.com/merchants/answer/6324507). Schema.org property [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID).
+              "promotions": [ # The promotions applied to the product. A maximum of 10 values are allowed per Product. Only Promotion.promotion_id will be used, other fields will be ignored if set.
+                { # Promotion specification.
+                  "promotionId": "A String", # Promotion identifier, which is the final component of name. For example, this field is "free_gift", if name is `projects/*/locations/global/catalogs/default_catalog/promotions/free_gift`. The value must be a UTF-8 encoded string with a length limit of 128 characters, and match the pattern: `a-zA-Z*`. For example, id0LikeThis or ID_1_LIKE_THIS. Otherwise, an INVALID_ARGUMENT error is returned. Corresponds to Google Merchant Center property [promotion_id](https://support.google.com/merchants/answer/7050148).
+                },
+              ],
+              "publishTime": "A String", # The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.
+              "rating": { # The rating of a Product. # The rating of this product.
+                "averageRating": 3.14, # The average rating of the Product. The rating is scaled at 1-5. Otherwise, an INVALID_ARGUMENT error is returned.
+                "ratingCount": 42, # The total number of ratings. This value is independent of the value of rating_histogram. This value must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                "ratingHistogram": [ # List of rating counts per rating value (index = rating - 1). The list is empty if there is no rating. If the list is non-empty, its size is always 5. Otherwise, an INVALID_ARGUMENT error is returned. For example, [41, 14, 13, 47, 303]. It means that the Product got 41 ratings with 1 star, 14 ratings with 2 star, and so on.
+                  42,
+                ],
+              },
+              "retrievableFields": "A String", # Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
+              "sizes": [ # The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value]. For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [size](https://support.google.com/merchants/answer/6324492), [size_type](https://support.google.com/merchants/answer/6324497), and [size_system](https://support.google.com/merchants/answer/6324502). Schema.org property [Product.size](https://schema.org/size).
+                "A String",
+              ],
+              "tags": [ # Custom tags associated with the product. At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter. Corresponding properties: Google Merchant Center property [custom_label_0–4](https://support.google.com/merchants/answer/6324473).
+                "A String",
+              ],
+              "title": "A String", # Required. Product title. This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [title](https://support.google.com/merchants/answer/6324415). Schema.org property [Product.name](https://schema.org/name).
+              "ttl": "A String", # Input only. The TTL (time to live) of the product. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. If it is set, it must be a non-negative value, and expire_time is set as current timestamp plus ttl. The derived expire_time is returned in the output and ttl is left blank when retrieving the Product. If it is set, the product is not available for SearchService.Search after current timestamp plus ttl. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts.
+              "type": "A String", # Immutable. The type of the product. Default to Catalog.product_level_config.ingestion_product_type if unset.
+              "uri": "A String", # Canonical URL directly linking to the product detail page. It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [link](https://support.google.com/merchants/answer/6324416). Schema.org property [Offer.url](https://schema.org/url).
+              "variants": [ # Output only. Product variants grouped together on primary product which share similar product attributes. It's automatically grouped by primary_product_id for all the product variants. Only populated for Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                # Object with schema name: GoogleCloudRetailV2Product
+              ],
+            },
+            "quantity": 42, # Quantity of the product associated with the user event. For example, this field will be 2 if two products are added to the shopping cart for `purchase-complete` event. Required for `add-to-cart` and `purchase-complete` event types.
+          },
+        ],
+        "totalPanels": 42, # Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.
+      },
+    ],
     "productDetails": [ # The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.
       { # Detailed product information associated with a user event.
         "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
diff --git a/docs/dyn/retail_v2.projects.locations.catalogs.userEvents.html b/docs/dyn/retail_v2.projects.locations.catalogs.userEvents.html
index 06cfa55958f..2d0c2c8d7e0 100644
--- a/docs/dyn/retail_v2.projects.locations.catalogs.userEvents.html
+++ b/docs/dyn/retail_v2.projects.locations.catalogs.userEvents.html
@@ -201,6 +201,184 @@ 
Method Details

             "A String",
           ],
           "pageViewId": "A String", # A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
+          "panels": [ # Optional. List of panels associated with this event. Used for panel-level impression data.
+            { # Detailed panel information associated with a user event.
+              "attributionToken": "A String", # Optional. The attribution token of the panel.
+              "displayName": "A String", # Optional. The display name of the panel.
+              "panelId": "A String", # Required. The panel ID.
+              "panelPosition": 42, # Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.
+              "productDetails": [ # Optional. The product details associated with the panel.
+                { # Detailed product information associated with a user event.
+                  "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
+                    "attributes": { # Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here. Features that can take on one of a limited number of possible values. Two types of features can be set are: Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer. For example: `{ "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": {"numbers":[2.3, 15.4]}, "heights_cm": {"numbers":[8.1, 6.4]} }`. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * Max entries count: 200. * The key must be a UTF-8 encoded string with a length limit of 128 characters. * For indexable attribute, the key must match the pattern: `a-zA-Z0-9*`. For example, `key0LikeThis` or `KEY_1_LIKE_THIS`. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed.
+                      "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                        "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                        "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                          3.14,
+                        ],
+                        "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                        "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                          "A String",
+                        ],
+                      },
+                    },
+                    "audience": { # An intended audience of the Product for whom it's sold. # The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product.
+                      "ageGroups": [ # The age groups of the audience. Strongly encouraged to use the standard values: "newborn" (up to 3 months old), "infant" (3–12 months old), "toddler" (1–5 years old), "kids" (5–13 years old), "adult" (typically teens or older). At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [age_group](https://support.google.com/merchants/answer/6324463). Schema.org property [Product.audience.suggestedMinAge](https://schema.org/suggestedMinAge) and [Product.audience.suggestedMaxAge](https://schema.org/suggestedMaxAge).
+                        "A String",
+                      ],
+                      "genders": [ # The genders of the audience. Strongly encouraged to use the standard values: "male", "female", "unisex". At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [gender](https://support.google.com/merchants/answer/6324479). Schema.org property [Product.audience.suggestedGender](https://schema.org/suggestedGender).
+                        "A String",
+                      ],
+                    },
+                    "availability": "A String", # The online availability of the Product. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+                    "availableQuantity": 42, # The available quantity of the item.
+                    "availableTime": "A String", # The timestamp when this Product becomes available for SearchService.Search. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT.
+                    "brands": [ # The brands of the product. A maximum of 30 brands are allowed unless overridden through the Google Cloud console. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [brand](https://support.google.com/merchants/answer/6324351). Schema.org property [Product.brand](https://schema.org/brand).
+                      "A String",
+                    ],
+                    "categories": [ # Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as: "categories": [ "Shoes & Accessories > Shoes", "Sports & Fitness > Athletic Clothing > Shoes" ] Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned. At most 250 values are allowed per Product unless overridden through the Google Cloud console. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property google_product_category. Schema.org property [Product.category] (https://schema.org/category). [mc_google_product_category]: https://support.google.com/merchants/answer/6324436
+                      "A String",
+                    ],
+                    "collectionMemberIds": [ # The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.
+                      "A String",
+                    ],
+                    "colorInfo": { # The color information of a Product. # The color of the product. Corresponding properties: Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                      "colorFamilies": [ # The standard color families. Strongly recommended to use the following standard color groups: "Red", "Pink", "Orange", "Yellow", "Purple", "Green", "Cyan", "Blue", "Brown", "White", "Gray", "Black" and "Mixed". Normally it is expected to have only 1 color family. May consider using single "Mixed" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.
+                        "A String",
+                      ],
+                      "colors": [ # The color display names, which may be different from standard color family names, such as the color aliases used in the website frontend. Normally it is expected to have only 1 color. May consider using single "Mixed" instead of multiple values. A maximum of 75 colors are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                        "A String",
+                      ],
+                    },
+                    "conditions": [ # The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used". A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [condition](https://support.google.com/merchants/answer/6324469). Schema.org property [Offer.itemCondition](https://schema.org/itemCondition).
+                      "A String",
+                    ],
+                    "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
+                    "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+                    "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
+                      { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
+                        "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
+                          "A String",
+                        ],
+                        "type": "A String", # The fulfillment type, including commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned.
+                      },
+                    ],
+                    "gtin": "A String", # The Global Trade Item Number (GTIN) of the product. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [gtin](https://support.google.com/merchants/answer/6324461). Schema.org property [Product.isbn](https://schema.org/isbn), [Product.gtin8](https://schema.org/gtin8), [Product.gtin12](https://schema.org/gtin12), [Product.gtin13](https://schema.org/gtin13), or [Product.gtin14](https://schema.org/gtin14). If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.
+                    "id": "A String", # Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1`. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [id](https://support.google.com/merchants/answer/6324405). Schema.org property [Product.sku](https://schema.org/sku).
+                    "images": [ # Product images for the product. We highly recommend putting the main image first. A maximum of 300 images are allowed. Corresponding properties: Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                      { # Product image. Recommendations AI and Retail Search use product images to improve prediction and search results. Product images can be returned in results, and are shown in prediction or search previews in the console. Please try to provide correct product images and avoid using images with size too small.
+                        "height": 42, # Height of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                        "uri": "A String", # Required. URI of the image. This field must be a valid UTF-8 encoded URI with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                        "width": 42, # Width of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                      },
+                    ],
+                    "languageCode": "A String", # Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance. For product search this field is in use. It defaults to "en-US" if unset.
+                    "localInventories": [ # Output only. A list of local inventories specific to different places. This field can be managed by ProductService.AddLocalInventories and ProductService.RemoveLocalInventories APIs if fine-grained, high-volume updates are necessary.
+                      { # The inventory information at a place (e.g. a store) identified by a place ID.
+                        "attributes": { # Optional. Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.
+                          "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                            "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                            "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                              3.14,
+                            ],
+                            "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                            "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                              "A String",
+                            ],
+                          },
+                        },
+                        "fulfillmentTypes": [ # Optional. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.
+                          "A String",
+                        ],
+                        "placeId": "A String", # Optional. The place ID for the current set of inventory information.
+                        "priceInfo": { # The price information of a Product. # Optional. Product price and cost information. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                          "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                          "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                          "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                          "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                          "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                          "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                          "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                            "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                              "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                              "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                              "maximum": 3.14, # Inclusive upper bound.
+                              "minimum": 3.14, # Inclusive lower bound.
+                            },
+                            "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                              "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                              "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                              "maximum": 3.14, # Inclusive upper bound.
+                              "minimum": 3.14, # Inclusive lower bound.
+                            },
+                          },
+                        },
+                      },
+                    ],
+                    "materials": [ # The material of the product. For example, "leather", "wooden". A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [material](https://support.google.com/merchants/answer/6324410). Schema.org property [Product.material](https://schema.org/material).
+                      "A String",
+                    ],
+                    "name": "A String", # Immutable. Full resource name of the product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id`.
+                    "patterns": [ # The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [pattern](https://support.google.com/merchants/answer/6324483). Schema.org property [Product.pattern](https://schema.org/pattern).
+                      "A String",
+                    ],
+                    "priceInfo": { # The price information of a Product. # Product price and cost information. Corresponding properties: Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                      "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                      "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                      "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                      "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                      "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                      "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                      "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                        "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                          "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                          "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                          "maximum": 3.14, # Inclusive upper bound.
+                          "minimum": 3.14, # Inclusive lower bound.
+                        },
+                        "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                          "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                          "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                          "maximum": 3.14, # Inclusive upper bound.
+                          "minimum": 3.14, # Inclusive lower bound.
+                        },
+                      },
+                    },
+                    "primaryProductId": "A String", # Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown. For Type.PRIMARY Products, this field can only be empty or set to the same value as id. For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [item_group_id](https://support.google.com/merchants/answer/6324507). Schema.org property [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID).
+                    "promotions": [ # The promotions applied to the product. A maximum of 10 values are allowed per Product. Only Promotion.promotion_id will be used, other fields will be ignored if set.
+                      { # Promotion specification.
+                        "promotionId": "A String", # Promotion identifier, which is the final component of name. For example, this field is "free_gift", if name is `projects/*/locations/global/catalogs/default_catalog/promotions/free_gift`. The value must be a UTF-8 encoded string with a length limit of 128 characters, and match the pattern: `a-zA-Z*`. For example, id0LikeThis or ID_1_LIKE_THIS. Otherwise, an INVALID_ARGUMENT error is returned. Corresponds to Google Merchant Center property [promotion_id](https://support.google.com/merchants/answer/7050148).
+                      },
+                    ],
+                    "publishTime": "A String", # The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.
+                    "rating": { # The rating of a Product. # The rating of this product.
+                      "averageRating": 3.14, # The average rating of the Product. The rating is scaled at 1-5. Otherwise, an INVALID_ARGUMENT error is returned.
+                      "ratingCount": 42, # The total number of ratings. This value is independent of the value of rating_histogram. This value must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                      "ratingHistogram": [ # List of rating counts per rating value (index = rating - 1). The list is empty if there is no rating. If the list is non-empty, its size is always 5. Otherwise, an INVALID_ARGUMENT error is returned. For example, [41, 14, 13, 47, 303]. It means that the Product got 41 ratings with 1 star, 14 ratings with 2 star, and so on.
+                        42,
+                      ],
+                    },
+                    "retrievableFields": "A String", # Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
+                    "sizes": [ # The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value]. For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [size](https://support.google.com/merchants/answer/6324492), [size_type](https://support.google.com/merchants/answer/6324497), and [size_system](https://support.google.com/merchants/answer/6324502). Schema.org property [Product.size](https://schema.org/size).
+                      "A String",
+                    ],
+                    "tags": [ # Custom tags associated with the product. At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter. Corresponding properties: Google Merchant Center property [custom_label_0–4](https://support.google.com/merchants/answer/6324473).
+                      "A String",
+                    ],
+                    "title": "A String", # Required. Product title. This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [title](https://support.google.com/merchants/answer/6324415). Schema.org property [Product.name](https://schema.org/name).
+                    "ttl": "A String", # Input only. The TTL (time to live) of the product. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. If it is set, it must be a non-negative value, and expire_time is set as current timestamp plus ttl. The derived expire_time is returned in the output and ttl is left blank when retrieving the Product. If it is set, the product is not available for SearchService.Search after current timestamp plus ttl. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts.
+                    "type": "A String", # Immutable. The type of the product. Default to Catalog.product_level_config.ingestion_product_type if unset.
+                    "uri": "A String", # Canonical URL directly linking to the product detail page. It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [link](https://support.google.com/merchants/answer/6324416). Schema.org property [Offer.url](https://schema.org/url).
+                    "variants": [ # Output only. Product variants grouped together on primary product which share similar product attributes. It's automatically grouped by primary_product_id for all the product variants. Only populated for Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                      # Object with schema name: GoogleCloudRetailV2Product
+                    ],
+                  },
+                  "quantity": 42, # Quantity of the product associated with the user event. For example, this field will be 2 if two products are added to the shopping cart for `purchase-complete` event. Required for `add-to-cart` and `purchase-complete` event types.
+                },
+              ],
+              "totalPanels": 42, # Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.
+            },
+          ],
           "productDetails": [ # The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.
             { # Detailed product information associated with a user event.
               "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
@@ -550,6 +728,184 @@ 
Method Details

     "A String",
   ],
   "pageViewId": "A String", # A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
+  "panels": [ # Optional. List of panels associated with this event. Used for panel-level impression data.
+    { # Detailed panel information associated with a user event.
+      "attributionToken": "A String", # Optional. The attribution token of the panel.
+      "displayName": "A String", # Optional. The display name of the panel.
+      "panelId": "A String", # Required. The panel ID.
+      "panelPosition": 42, # Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.
+      "productDetails": [ # Optional. The product details associated with the panel.
+        { # Detailed product information associated with a user event.
+          "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
+            "attributes": { # Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here. Features that can take on one of a limited number of possible values. Two types of features can be set are: Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer. For example: `{ "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": {"numbers":[2.3, 15.4]}, "heights_cm": {"numbers":[8.1, 6.4]} }`. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * Max entries count: 200. * The key must be a UTF-8 encoded string with a length limit of 128 characters. * For indexable attribute, the key must match the pattern: `a-zA-Z0-9*`. For example, `key0LikeThis` or `KEY_1_LIKE_THIS`. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed.
+              "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                  3.14,
+                ],
+                "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+              },
+            },
+            "audience": { # An intended audience of the Product for whom it's sold. # The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product.
+              "ageGroups": [ # The age groups of the audience. Strongly encouraged to use the standard values: "newborn" (up to 3 months old), "infant" (3–12 months old), "toddler" (1–5 years old), "kids" (5–13 years old), "adult" (typically teens or older). At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [age_group](https://support.google.com/merchants/answer/6324463). Schema.org property [Product.audience.suggestedMinAge](https://schema.org/suggestedMinAge) and [Product.audience.suggestedMaxAge](https://schema.org/suggestedMaxAge).
+                "A String",
+              ],
+              "genders": [ # The genders of the audience. Strongly encouraged to use the standard values: "male", "female", "unisex". At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [gender](https://support.google.com/merchants/answer/6324479). Schema.org property [Product.audience.suggestedGender](https://schema.org/suggestedGender).
+                "A String",
+              ],
+            },
+            "availability": "A String", # The online availability of the Product. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+            "availableQuantity": 42, # The available quantity of the item.
+            "availableTime": "A String", # The timestamp when this Product becomes available for SearchService.Search. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT.
+            "brands": [ # The brands of the product. A maximum of 30 brands are allowed unless overridden through the Google Cloud console. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [brand](https://support.google.com/merchants/answer/6324351). Schema.org property [Product.brand](https://schema.org/brand).
+              "A String",
+            ],
+            "categories": [ # Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as: "categories": [ "Shoes & Accessories > Shoes", "Sports & Fitness > Athletic Clothing > Shoes" ] Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned. At most 250 values are allowed per Product unless overridden through the Google Cloud console. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property google_product_category. Schema.org property [Product.category] (https://schema.org/category). [mc_google_product_category]: https://support.google.com/merchants/answer/6324436
+              "A String",
+            ],
+            "collectionMemberIds": [ # The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.
+              "A String",
+            ],
+            "colorInfo": { # The color information of a Product. # The color of the product. Corresponding properties: Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+              "colorFamilies": [ # The standard color families. Strongly recommended to use the following standard color groups: "Red", "Pink", "Orange", "Yellow", "Purple", "Green", "Cyan", "Blue", "Brown", "White", "Gray", "Black" and "Mixed". Normally it is expected to have only 1 color family. May consider using single "Mixed" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.
+                "A String",
+              ],
+              "colors": [ # The color display names, which may be different from standard color family names, such as the color aliases used in the website frontend. Normally it is expected to have only 1 color. May consider using single "Mixed" instead of multiple values. A maximum of 75 colors are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                "A String",
+              ],
+            },
+            "conditions": [ # The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used". A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [condition](https://support.google.com/merchants/answer/6324469). Schema.org property [Offer.itemCondition](https://schema.org/itemCondition).
+              "A String",
+            ],
+            "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
+            "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+            "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
+              { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
+                "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+                "type": "A String", # The fulfillment type, including commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned.
+              },
+            ],
+            "gtin": "A String", # The Global Trade Item Number (GTIN) of the product. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [gtin](https://support.google.com/merchants/answer/6324461). Schema.org property [Product.isbn](https://schema.org/isbn), [Product.gtin8](https://schema.org/gtin8), [Product.gtin12](https://schema.org/gtin12), [Product.gtin13](https://schema.org/gtin13), or [Product.gtin14](https://schema.org/gtin14). If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.
+            "id": "A String", # Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1`. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [id](https://support.google.com/merchants/answer/6324405). Schema.org property [Product.sku](https://schema.org/sku).
+            "images": [ # Product images for the product. We highly recommend putting the main image first. A maximum of 300 images are allowed. Corresponding properties: Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+              { # Product image. Recommendations AI and Retail Search use product images to improve prediction and search results. Product images can be returned in results, and are shown in prediction or search previews in the console. Please try to provide correct product images and avoid using images with size too small.
+                "height": 42, # Height of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                "uri": "A String", # Required. URI of the image. This field must be a valid UTF-8 encoded URI with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                "width": 42, # Width of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+              },
+            ],
+            "languageCode": "A String", # Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance. For product search this field is in use. It defaults to "en-US" if unset.
+            "localInventories": [ # Output only. A list of local inventories specific to different places. This field can be managed by ProductService.AddLocalInventories and ProductService.RemoveLocalInventories APIs if fine-grained, high-volume updates are necessary.
+              { # The inventory information at a place (e.g. a store) identified by a place ID.
+                "attributes": { # Optional. Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.
+                  "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                    "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                    "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                      3.14,
+                    ],
+                    "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                    "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                      "A String",
+                    ],
+                  },
+                },
+                "fulfillmentTypes": [ # Optional. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+                "placeId": "A String", # Optional. The place ID for the current set of inventory information.
+                "priceInfo": { # The price information of a Product. # Optional. Product price and cost information. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                  "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                  "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                  "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                  "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                  "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                  "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                  "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                    "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                      "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                      "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                      "maximum": 3.14, # Inclusive upper bound.
+                      "minimum": 3.14, # Inclusive lower bound.
+                    },
+                    "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                      "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                      "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                      "maximum": 3.14, # Inclusive upper bound.
+                      "minimum": 3.14, # Inclusive lower bound.
+                    },
+                  },
+                },
+              },
+            ],
+            "materials": [ # The material of the product. For example, "leather", "wooden". A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [material](https://support.google.com/merchants/answer/6324410). Schema.org property [Product.material](https://schema.org/material).
+              "A String",
+            ],
+            "name": "A String", # Immutable. Full resource name of the product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id`.
+            "patterns": [ # The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [pattern](https://support.google.com/merchants/answer/6324483). Schema.org property [Product.pattern](https://schema.org/pattern).
+              "A String",
+            ],
+            "priceInfo": { # The price information of a Product. # Product price and cost information. Corresponding properties: Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+              "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+              "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+              "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+              "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+              "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+              "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+              "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                  "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                  "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                  "maximum": 3.14, # Inclusive upper bound.
+                  "minimum": 3.14, # Inclusive lower bound.
+                },
+                "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                  "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                  "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                  "maximum": 3.14, # Inclusive upper bound.
+                  "minimum": 3.14, # Inclusive lower bound.
+                },
+              },
+            },
+            "primaryProductId": "A String", # Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown. For Type.PRIMARY Products, this field can only be empty or set to the same value as id. For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [item_group_id](https://support.google.com/merchants/answer/6324507). Schema.org property [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID).
+            "promotions": [ # The promotions applied to the product. A maximum of 10 values are allowed per Product. Only Promotion.promotion_id will be used, other fields will be ignored if set.
+              { # Promotion specification.
+                "promotionId": "A String", # Promotion identifier, which is the final component of name. For example, this field is "free_gift", if name is `projects/*/locations/global/catalogs/default_catalog/promotions/free_gift`. The value must be a UTF-8 encoded string with a length limit of 128 characters, and match the pattern: `a-zA-Z*`. For example, id0LikeThis or ID_1_LIKE_THIS. Otherwise, an INVALID_ARGUMENT error is returned. Corresponds to Google Merchant Center property [promotion_id](https://support.google.com/merchants/answer/7050148).
+              },
+            ],
+            "publishTime": "A String", # The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.
+            "rating": { # The rating of a Product. # The rating of this product.
+              "averageRating": 3.14, # The average rating of the Product. The rating is scaled at 1-5. Otherwise, an INVALID_ARGUMENT error is returned.
+              "ratingCount": 42, # The total number of ratings. This value is independent of the value of rating_histogram. This value must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+              "ratingHistogram": [ # List of rating counts per rating value (index = rating - 1). The list is empty if there is no rating. If the list is non-empty, its size is always 5. Otherwise, an INVALID_ARGUMENT error is returned. For example, [41, 14, 13, 47, 303]. It means that the Product got 41 ratings with 1 star, 14 ratings with 2 star, and so on.
+                42,
+              ],
+            },
+            "retrievableFields": "A String", # Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
+            "sizes": [ # The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value]. For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [size](https://support.google.com/merchants/answer/6324492), [size_type](https://support.google.com/merchants/answer/6324497), and [size_system](https://support.google.com/merchants/answer/6324502). Schema.org property [Product.size](https://schema.org/size).
+              "A String",
+            ],
+            "tags": [ # Custom tags associated with the product. At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter. Corresponding properties: Google Merchant Center property [custom_label_0–4](https://support.google.com/merchants/answer/6324473).
+              "A String",
+            ],
+            "title": "A String", # Required. Product title. This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [title](https://support.google.com/merchants/answer/6324415). Schema.org property [Product.name](https://schema.org/name).
+            "ttl": "A String", # Input only. The TTL (time to live) of the product. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. If it is set, it must be a non-negative value, and expire_time is set as current timestamp plus ttl. The derived expire_time is returned in the output and ttl is left blank when retrieving the Product. If it is set, the product is not available for SearchService.Search after current timestamp plus ttl. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts.
+            "type": "A String", # Immutable. The type of the product. Default to Catalog.product_level_config.ingestion_product_type if unset.
+            "uri": "A String", # Canonical URL directly linking to the product detail page. It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [link](https://support.google.com/merchants/answer/6324416). Schema.org property [Offer.url](https://schema.org/url).
+            "variants": [ # Output only. Product variants grouped together on primary product which share similar product attributes. It's automatically grouped by primary_product_id for all the product variants. Only populated for Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+              # Object with schema name: GoogleCloudRetailV2Product
+            ],
+          },
+          "quantity": 42, # Quantity of the product associated with the user event. For example, this field will be 2 if two products are added to the shopping cart for `purchase-complete` event. Required for `add-to-cart` and `purchase-complete` event types.
+        },
+      ],
+      "totalPanels": 42, # Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.
+    },
+  ],
   "productDetails": [ # The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.
     { # Detailed product information associated with a user event.
       "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
@@ -781,6 +1137,184 @@ 
Method Details

     "A String",
   ],
   "pageViewId": "A String", # A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
+  "panels": [ # Optional. List of panels associated with this event. Used for panel-level impression data.
+    { # Detailed panel information associated with a user event.
+      "attributionToken": "A String", # Optional. The attribution token of the panel.
+      "displayName": "A String", # Optional. The display name of the panel.
+      "panelId": "A String", # Required. The panel ID.
+      "panelPosition": 42, # Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.
+      "productDetails": [ # Optional. The product details associated with the panel.
+        { # Detailed product information associated with a user event.
+          "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
+            "attributes": { # Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here. Features that can take on one of a limited number of possible values. Two types of features can be set are: Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer. For example: `{ "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": {"numbers":[2.3, 15.4]}, "heights_cm": {"numbers":[8.1, 6.4]} }`. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * Max entries count: 200. * The key must be a UTF-8 encoded string with a length limit of 128 characters. * For indexable attribute, the key must match the pattern: `a-zA-Z0-9*`. For example, `key0LikeThis` or `KEY_1_LIKE_THIS`. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed.
+              "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                  3.14,
+                ],
+                "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+              },
+            },
+            "audience": { # An intended audience of the Product for whom it's sold. # The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product.
+              "ageGroups": [ # The age groups of the audience. Strongly encouraged to use the standard values: "newborn" (up to 3 months old), "infant" (3–12 months old), "toddler" (1–5 years old), "kids" (5–13 years old), "adult" (typically teens or older). At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [age_group](https://support.google.com/merchants/answer/6324463). Schema.org property [Product.audience.suggestedMinAge](https://schema.org/suggestedMinAge) and [Product.audience.suggestedMaxAge](https://schema.org/suggestedMaxAge).
+                "A String",
+              ],
+              "genders": [ # The genders of the audience. Strongly encouraged to use the standard values: "male", "female", "unisex". At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [gender](https://support.google.com/merchants/answer/6324479). Schema.org property [Product.audience.suggestedGender](https://schema.org/suggestedGender).
+                "A String",
+              ],
+            },
+            "availability": "A String", # The online availability of the Product. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+            "availableQuantity": 42, # The available quantity of the item.
+            "availableTime": "A String", # The timestamp when this Product becomes available for SearchService.Search. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT.
+            "brands": [ # The brands of the product. A maximum of 30 brands are allowed unless overridden through the Google Cloud console. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [brand](https://support.google.com/merchants/answer/6324351). Schema.org property [Product.brand](https://schema.org/brand).
+              "A String",
+            ],
+            "categories": [ # Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as: "categories": [ "Shoes & Accessories > Shoes", "Sports & Fitness > Athletic Clothing > Shoes" ] Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned. At most 250 values are allowed per Product unless overridden through the Google Cloud console. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property google_product_category. Schema.org property [Product.category] (https://schema.org/category). [mc_google_product_category]: https://support.google.com/merchants/answer/6324436
+              "A String",
+            ],
+            "collectionMemberIds": [ # The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.
+              "A String",
+            ],
+            "colorInfo": { # The color information of a Product. # The color of the product. Corresponding properties: Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+              "colorFamilies": [ # The standard color families. Strongly recommended to use the following standard color groups: "Red", "Pink", "Orange", "Yellow", "Purple", "Green", "Cyan", "Blue", "Brown", "White", "Gray", "Black" and "Mixed". Normally it is expected to have only 1 color family. May consider using single "Mixed" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.
+                "A String",
+              ],
+              "colors": [ # The color display names, which may be different from standard color family names, such as the color aliases used in the website frontend. Normally it is expected to have only 1 color. May consider using single "Mixed" instead of multiple values. A maximum of 75 colors are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                "A String",
+              ],
+            },
+            "conditions": [ # The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used". A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [condition](https://support.google.com/merchants/answer/6324469). Schema.org property [Offer.itemCondition](https://schema.org/itemCondition).
+              "A String",
+            ],
+            "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
+            "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+            "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
+              { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
+                "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+                "type": "A String", # The fulfillment type, including commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned.
+              },
+            ],
+            "gtin": "A String", # The Global Trade Item Number (GTIN) of the product. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [gtin](https://support.google.com/merchants/answer/6324461). Schema.org property [Product.isbn](https://schema.org/isbn), [Product.gtin8](https://schema.org/gtin8), [Product.gtin12](https://schema.org/gtin12), [Product.gtin13](https://schema.org/gtin13), or [Product.gtin14](https://schema.org/gtin14). If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.
+            "id": "A String", # Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1`. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [id](https://support.google.com/merchants/answer/6324405). Schema.org property [Product.sku](https://schema.org/sku).
+            "images": [ # Product images for the product. We highly recommend putting the main image first. A maximum of 300 images are allowed. Corresponding properties: Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+              { # Product image. Recommendations AI and Retail Search use product images to improve prediction and search results. Product images can be returned in results, and are shown in prediction or search previews in the console. Please try to provide correct product images and avoid using images with size too small.
+                "height": 42, # Height of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                "uri": "A String", # Required. URI of the image. This field must be a valid UTF-8 encoded URI with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                "width": 42, # Width of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+              },
+            ],
+            "languageCode": "A String", # Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance. For product search this field is in use. It defaults to "en-US" if unset.
+            "localInventories": [ # Output only. A list of local inventories specific to different places. This field can be managed by ProductService.AddLocalInventories and ProductService.RemoveLocalInventories APIs if fine-grained, high-volume updates are necessary.
+              { # The inventory information at a place (e.g. a store) identified by a place ID.
+                "attributes": { # Optional. Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.
+                  "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                    "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                    "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                      3.14,
+                    ],
+                    "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                    "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                      "A String",
+                    ],
+                  },
+                },
+                "fulfillmentTypes": [ # Optional. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+                "placeId": "A String", # Optional. The place ID for the current set of inventory information.
+                "priceInfo": { # The price information of a Product. # Optional. Product price and cost information. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                  "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                  "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                  "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                  "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                  "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                  "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                  "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                    "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                      "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                      "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                      "maximum": 3.14, # Inclusive upper bound.
+                      "minimum": 3.14, # Inclusive lower bound.
+                    },
+                    "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                      "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                      "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                      "maximum": 3.14, # Inclusive upper bound.
+                      "minimum": 3.14, # Inclusive lower bound.
+                    },
+                  },
+                },
+              },
+            ],
+            "materials": [ # The material of the product. For example, "leather", "wooden". A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [material](https://support.google.com/merchants/answer/6324410). Schema.org property [Product.material](https://schema.org/material).
+              "A String",
+            ],
+            "name": "A String", # Immutable. Full resource name of the product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id`.
+            "patterns": [ # The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [pattern](https://support.google.com/merchants/answer/6324483). Schema.org property [Product.pattern](https://schema.org/pattern).
+              "A String",
+            ],
+            "priceInfo": { # The price information of a Product. # Product price and cost information. Corresponding properties: Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+              "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+              "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+              "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+              "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+              "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+              "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+              "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                  "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                  "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                  "maximum": 3.14, # Inclusive upper bound.
+                  "minimum": 3.14, # Inclusive lower bound.
+                },
+                "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                  "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                  "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                  "maximum": 3.14, # Inclusive upper bound.
+                  "minimum": 3.14, # Inclusive lower bound.
+                },
+              },
+            },
+            "primaryProductId": "A String", # Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown. For Type.PRIMARY Products, this field can only be empty or set to the same value as id. For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [item_group_id](https://support.google.com/merchants/answer/6324507). Schema.org property [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID).
+            "promotions": [ # The promotions applied to the product. A maximum of 10 values are allowed per Product. Only Promotion.promotion_id will be used, other fields will be ignored if set.
+              { # Promotion specification.
+                "promotionId": "A String", # Promotion identifier, which is the final component of name. For example, this field is "free_gift", if name is `projects/*/locations/global/catalogs/default_catalog/promotions/free_gift`. The value must be a UTF-8 encoded string with a length limit of 128 characters, and match the pattern: `a-zA-Z*`. For example, id0LikeThis or ID_1_LIKE_THIS. Otherwise, an INVALID_ARGUMENT error is returned. Corresponds to Google Merchant Center property [promotion_id](https://support.google.com/merchants/answer/7050148).
+              },
+            ],
+            "publishTime": "A String", # The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.
+            "rating": { # The rating of a Product. # The rating of this product.
+              "averageRating": 3.14, # The average rating of the Product. The rating is scaled at 1-5. Otherwise, an INVALID_ARGUMENT error is returned.
+              "ratingCount": 42, # The total number of ratings. This value is independent of the value of rating_histogram. This value must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+              "ratingHistogram": [ # List of rating counts per rating value (index = rating - 1). The list is empty if there is no rating. If the list is non-empty, its size is always 5. Otherwise, an INVALID_ARGUMENT error is returned. For example, [41, 14, 13, 47, 303]. It means that the Product got 41 ratings with 1 star, 14 ratings with 2 star, and so on.
+                42,
+              ],
+            },
+            "retrievableFields": "A String", # Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
+            "sizes": [ # The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value]. For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [size](https://support.google.com/merchants/answer/6324492), [size_type](https://support.google.com/merchants/answer/6324497), and [size_system](https://support.google.com/merchants/answer/6324502). Schema.org property [Product.size](https://schema.org/size).
+              "A String",
+            ],
+            "tags": [ # Custom tags associated with the product. At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter. Corresponding properties: Google Merchant Center property [custom_label_0–4](https://support.google.com/merchants/answer/6324473).
+              "A String",
+            ],
+            "title": "A String", # Required. Product title. This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [title](https://support.google.com/merchants/answer/6324415). Schema.org property [Product.name](https://schema.org/name).
+            "ttl": "A String", # Input only. The TTL (time to live) of the product. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. If it is set, it must be a non-negative value, and expire_time is set as current timestamp plus ttl. The derived expire_time is returned in the output and ttl is left blank when retrieving the Product. If it is set, the product is not available for SearchService.Search after current timestamp plus ttl. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts.
+            "type": "A String", # Immutable. The type of the product. Default to Catalog.product_level_config.ingestion_product_type if unset.
+            "uri": "A String", # Canonical URL directly linking to the product detail page. It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [link](https://support.google.com/merchants/answer/6324416). Schema.org property [Offer.url](https://schema.org/url).
+            "variants": [ # Output only. Product variants grouped together on primary product which share similar product attributes. It's automatically grouped by primary_product_id for all the product variants. Only populated for Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+              # Object with schema name: GoogleCloudRetailV2Product
+            ],
+          },
+          "quantity": 42, # Quantity of the product associated with the user event. For example, this field will be 2 if two products are added to the shopping cart for `purchase-complete` event. Required for `add-to-cart` and `purchase-complete` event types.
+        },
+      ],
+      "totalPanels": 42, # Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.
+    },
+  ],
   "productDetails": [ # The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.
     { # Detailed product information associated with a user event.
       "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
diff --git a/docs/dyn/retail_v2alpha.projects.locations.catalogs.html b/docs/dyn/retail_v2alpha.projects.locations.catalogs.html
index a04567dd889..3a1d57f92b3 100644
--- a/docs/dyn/retail_v2alpha.projects.locations.catalogs.html
+++ b/docs/dyn/retail_v2alpha.projects.locations.catalogs.html
@@ -575,6 +575,7 @@ 
Method Details

             "feeds": [ # Criteria for the Merchant Center feeds to be ingested via the link. All offers will be ingested if the list is empty. Otherwise the offers will be ingested from selected feeds.
               { # Merchant Center Feed filter criterion.
                 "dataSourceId": "A String", # AFM data source ID.
+                "primaryFeedId": "A String", # Merchant Center primary feed ID. Deprecated: use data_source_id instead.
                 "primaryFeedName": "A String", # Merchant Center primary feed name. The name is used for the display purposes only.
               },
             ],
@@ -630,6 +631,7 @@ 
Method Details

         "feeds": [ # Criteria for the Merchant Center feeds to be ingested via the link. All offers will be ingested if the list is empty. Otherwise the offers will be ingested from selected feeds.
           { # Merchant Center Feed filter criterion.
             "dataSourceId": "A String", # AFM data source ID.
+            "primaryFeedId": "A String", # Merchant Center primary feed ID. Deprecated: use data_source_id instead.
             "primaryFeedName": "A String", # Merchant Center primary feed name. The name is used for the display purposes only.
           },
         ],
@@ -667,6 +669,7 @@ 
Method Details

         "feeds": [ # Criteria for the Merchant Center feeds to be ingested via the link. All offers will be ingested if the list is empty. Otherwise the offers will be ingested from selected feeds.
           { # Merchant Center Feed filter criterion.
             "dataSourceId": "A String", # AFM data source ID.
+            "primaryFeedId": "A String", # Merchant Center primary feed ID. Deprecated: use data_source_id instead.
             "primaryFeedName": "A String", # Merchant Center primary feed name. The name is used for the display purposes only.
           },
         ],
diff --git a/docs/dyn/retail_v2alpha.projects.locations.catalogs.placements.html b/docs/dyn/retail_v2alpha.projects.locations.catalogs.placements.html
index 52d275f52b9..1a035232652 100644
--- a/docs/dyn/retail_v2alpha.projects.locations.catalogs.placements.html
+++ b/docs/dyn/retail_v2alpha.projects.locations.catalogs.placements.html
@@ -124,6 +124,13 @@ 
Method Details

     "A String",
   ],
   "query": "A String", # Optional. Raw search query to be searched for. If this field is empty, the request is considered a category browsing request.
+  "safetySettings": [ # Optional. The safety settings to be applied to the generated content.
+    { # Safety settings.
+      "category": "A String", # Harm category.
+      "method": "A String", # Optional. Specify if the threshold is used for probability or severity score. If not specified, the threshold is used for probability score.
+      "threshold": "A String", # The harm block threshold.
+    },
+  ],
   "searchParams": { # Search parameters. # Optional. Search parameters.
     "boostSpec": { # Boost specification to boost certain items. # Optional. The boost spec to specify the boosting of search results. The syntax of the boost spec is the same as SearchRequest.boost_spec.
       "conditionBoostSpecs": [ # Condition boost specifications. If a product matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
@@ -239,6 +246,185 @@ 
Method Details

       "A String",
     ],
     "pageViewId": "A String", # A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
+    "panels": [ # Optional. List of panels associated with this event. Used for panel-level impression data.
+      { # Detailed panel information associated with a user event.
+        "attributionToken": "A String", # Optional. The attribution token of the panel.
+        "displayName": "A String", # Optional. The display name of the panel.
+        "panelId": "A String", # Required. The panel ID.
+        "panelPosition": 42, # Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.
+        "productDetails": [ # Optional. The product details associated with the panel.
+          { # Detailed product information associated with a user event.
+            "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
+              "attributes": { # Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here. Features that can take on one of a limited number of possible values. Two types of features can be set are: Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer. For example: `{ "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": {"numbers":[2.3, 15.4]}, "heights_cm": {"numbers":[8.1, 6.4]} }`. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * Max entries count: 200. * The key must be a UTF-8 encoded string with a length limit of 128 characters. * For indexable attribute, the key must match the pattern: `a-zA-Z0-9*`. For example, `key0LikeThis` or `KEY_1_LIKE_THIS`. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed.
+                "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                  "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                  "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                    3.14,
+                  ],
+                  "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                  "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                },
+              },
+              "audience": { # An intended audience of the Product for whom it's sold. # The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product.
+                "ageGroups": [ # The age groups of the audience. Strongly encouraged to use the standard values: "newborn" (up to 3 months old), "infant" (3–12 months old), "toddler" (1–5 years old), "kids" (5–13 years old), "adult" (typically teens or older). At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [age_group](https://support.google.com/merchants/answer/6324463). Schema.org property [Product.audience.suggestedMinAge](https://schema.org/suggestedMinAge) and [Product.audience.suggestedMaxAge](https://schema.org/suggestedMaxAge).
+                  "A String",
+                ],
+                "genders": [ # The genders of the audience. Strongly encouraged to use the standard values: "male", "female", "unisex". At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [gender](https://support.google.com/merchants/answer/6324479). Schema.org property [Product.audience.suggestedGender](https://schema.org/suggestedGender).
+                  "A String",
+                ],
+              },
+              "availability": "A String", # The online availability of the Product. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+              "availableQuantity": 42, # The available quantity of the item.
+              "availableTime": "A String", # The timestamp when this Product becomes available for SearchService.Search. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT.
+              "brands": [ # The brands of the product. A maximum of 30 brands are allowed unless overridden through the Google Cloud console. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [brand](https://support.google.com/merchants/answer/6324351). Schema.org property [Product.brand](https://schema.org/brand).
+                "A String",
+              ],
+              "categories": [ # Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as: "categories": [ "Shoes & Accessories > Shoes", "Sports & Fitness > Athletic Clothing > Shoes" ] Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned. At most 250 values are allowed per Product unless overridden through the Google Cloud console. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property google_product_category. Schema.org property [Product.category] (https://schema.org/category). [mc_google_product_category]: https://support.google.com/merchants/answer/6324436
+                "A String",
+              ],
+              "collectionMemberIds": [ # The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.
+                "A String",
+              ],
+              "colorInfo": { # The color information of a Product. # The color of the product. Corresponding properties: Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                "colorFamilies": [ # The standard color families. Strongly recommended to use the following standard color groups: "Red", "Pink", "Orange", "Yellow", "Purple", "Green", "Cyan", "Blue", "Brown", "White", "Gray", "Black" and "Mixed". Normally it is expected to have only 1 color family. May consider using single "Mixed" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.
+                  "A String",
+                ],
+                "colors": [ # The color display names, which may be different from standard color family names, such as the color aliases used in the website frontend. Normally it is expected to have only 1 color. May consider using single "Mixed" instead of multiple values. A maximum of 75 colors are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                  "A String",
+                ],
+              },
+              "conditions": [ # The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used". A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [condition](https://support.google.com/merchants/answer/6324469). Schema.org property [Offer.itemCondition](https://schema.org/itemCondition).
+                "A String",
+              ],
+              "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
+              "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+              "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
+                { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
+                  "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                  "type": "A String", # The fulfillment type, including commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned.
+                },
+              ],
+              "gtin": "A String", # The Global Trade Item Number (GTIN) of the product. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [gtin](https://support.google.com/merchants/answer/6324461). Schema.org property [Product.isbn](https://schema.org/isbn), [Product.gtin8](https://schema.org/gtin8), [Product.gtin12](https://schema.org/gtin12), [Product.gtin13](https://schema.org/gtin13), or [Product.gtin14](https://schema.org/gtin14). If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.
+              "id": "A String", # Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1`. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [id](https://support.google.com/merchants/answer/6324405). Schema.org property [Product.sku](https://schema.org/sku).
+              "images": [ # Product images for the product. We highly recommend putting the main image first. A maximum of 300 images are allowed. Corresponding properties: Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                { # Product image. Recommendations AI and Retail Search use product images to improve prediction and search results. Product images can be returned in results, and are shown in prediction or search previews in the console. Please try to provide correct product images and avoid using images with size too small.
+                  "height": 42, # Height of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "uri": "A String", # Required. URI of the image. This field must be a valid UTF-8 encoded URI with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                  "width": 42, # Width of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                },
+              ],
+              "languageCode": "A String", # Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance. For product search this field is in use. It defaults to "en-US" if unset.
+              "localInventories": [ # Output only. A list of local inventories specific to different places. This field can be managed by ProductService.AddLocalInventories and ProductService.RemoveLocalInventories APIs if fine-grained, high-volume updates are necessary.
+                { # The inventory information at a place (e.g. a store) identified by a place ID.
+                  "attributes": { # Optional. Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.
+                    "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                      "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                      "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                        3.14,
+                      ],
+                      "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                      "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                        "A String",
+                      ],
+                    },
+                  },
+                  "availability": "A String", # Optional. The availability of the Product at this place_id. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability). This field is currently only used by the Recommendations API. For Search, please make use of fulfillment_types or custom attributes for similar behaviour. See [here]( https://cloud.google.com/retail/docs/local-inventory-updates#local-inventory-update-methods) for more details.
+                  "fulfillmentTypes": [ # Optional. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                  "placeId": "A String", # Optional. The place ID for the current set of inventory information.
+                  "priceInfo": { # The price information of a Product. # Optional. Product price and cost information. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                    "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                    "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                    "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                    "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                    "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                    "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                    "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                      "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                        "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                        "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                        "maximum": 3.14, # Inclusive upper bound.
+                        "minimum": 3.14, # Inclusive lower bound.
+                      },
+                      "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                        "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                        "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                        "maximum": 3.14, # Inclusive upper bound.
+                        "minimum": 3.14, # Inclusive lower bound.
+                      },
+                    },
+                  },
+                },
+              ],
+              "materials": [ # The material of the product. For example, "leather", "wooden". A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [material](https://support.google.com/merchants/answer/6324410). Schema.org property [Product.material](https://schema.org/material).
+                "A String",
+              ],
+              "name": "A String", # Immutable. Full resource name of the product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id`.
+              "patterns": [ # The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [pattern](https://support.google.com/merchants/answer/6324483). Schema.org property [Product.pattern](https://schema.org/pattern).
+                "A String",
+              ],
+              "priceInfo": { # The price information of a Product. # Product price and cost information. Corresponding properties: Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                  "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                    "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                    "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                    "maximum": 3.14, # Inclusive upper bound.
+                    "minimum": 3.14, # Inclusive lower bound.
+                  },
+                  "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                    "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                    "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                    "maximum": 3.14, # Inclusive upper bound.
+                    "minimum": 3.14, # Inclusive lower bound.
+                  },
+                },
+              },
+              "primaryProductId": "A String", # Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown. For Type.PRIMARY Products, this field can only be empty or set to the same value as id. For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [item_group_id](https://support.google.com/merchants/answer/6324507). Schema.org property [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID).
+              "promotions": [ # The promotions applied to the product. A maximum of 10 values are allowed per Product. Only Promotion.promotion_id will be used, other fields will be ignored if set.
+                { # Promotion specification.
+                  "promotionId": "A String", # Promotion identifier, which is the final component of name. For example, this field is "free_gift", if name is `projects/*/locations/global/catalogs/default_catalog/promotions/free_gift`. The value must be a UTF-8 encoded string with a length limit of 128 characters, and match the pattern: `a-zA-Z*`. For example, id0LikeThis or ID_1_LIKE_THIS. Otherwise, an INVALID_ARGUMENT error is returned. Corresponds to Google Merchant Center property [promotion_id](https://support.google.com/merchants/answer/7050148).
+                },
+              ],
+              "publishTime": "A String", # The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.
+              "rating": { # The rating of a Product. # The rating of this product.
+                "averageRating": 3.14, # The average rating of the Product. The rating is scaled at 1-5. Otherwise, an INVALID_ARGUMENT error is returned.
+                "ratingCount": 42, # The total number of ratings. This value is independent of the value of rating_histogram. This value must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                "ratingHistogram": [ # List of rating counts per rating value (index = rating - 1). The list is empty if there is no rating. If the list is non-empty, its size is always 5. Otherwise, an INVALID_ARGUMENT error is returned. For example, [41, 14, 13, 47, 303]. It means that the Product got 41 ratings with 1 star, 14 ratings with 2 star, and so on.
+                  42,
+                ],
+              },
+              "retrievableFields": "A String", # Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
+              "sizes": [ # The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value]. For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [size](https://support.google.com/merchants/answer/6324492), [size_type](https://support.google.com/merchants/answer/6324497), and [size_system](https://support.google.com/merchants/answer/6324502). Schema.org property [Product.size](https://schema.org/size).
+                "A String",
+              ],
+              "tags": [ # Custom tags associated with the product. At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter. Corresponding properties: Google Merchant Center property [custom_label_0–4](https://support.google.com/merchants/answer/6324473).
+                "A String",
+              ],
+              "title": "A String", # Required. Product title. This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [title](https://support.google.com/merchants/answer/6324415). Schema.org property [Product.name](https://schema.org/name).
+              "ttl": "A String", # Input only. The TTL (time to live) of the product. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. If it is set, it must be a non-negative value, and expire_time is set as current timestamp plus ttl. The derived expire_time is returned in the output and ttl is left blank when retrieving the Product. If it is set, the product is not available for SearchService.Search after current timestamp plus ttl. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts.
+              "type": "A String", # Immutable. The type of the product. Default to Catalog.product_level_config.ingestion_product_type if unset.
+              "uri": "A String", # Canonical URL directly linking to the product detail page. It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [link](https://support.google.com/merchants/answer/6324416). Schema.org property [Offer.url](https://schema.org/url).
+              "variants": [ # Output only. Product variants grouped together on primary product which share similar product attributes. It's automatically grouped by primary_product_id for all the product variants. Only populated for Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                # Object with schema name: GoogleCloudRetailV2alphaProduct
+              ],
+            },
+            "quantity": 42, # Quantity of the product associated with the user event. For example, this field will be 2 if two products are added to the shopping cart for `purchase-complete` event. Required for `add-to-cart` and `purchase-complete` event types.
+          },
+        ],
+        "totalPanels": 42, # Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.
+      },
+    ],
     "productDetails": [ # The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.
       { # Detailed product information associated with a user event.
         "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
diff --git a/docs/dyn/retail_v2alpha.projects.locations.catalogs.servingConfigs.html b/docs/dyn/retail_v2alpha.projects.locations.catalogs.servingConfigs.html
index bc064a8e741..46dbb661efc 100644
--- a/docs/dyn/retail_v2alpha.projects.locations.catalogs.servingConfigs.html
+++ b/docs/dyn/retail_v2alpha.projects.locations.catalogs.servingConfigs.html
@@ -217,6 +217,13 @@ 
Method Details

     "A String",
   ],
   "query": "A String", # Optional. Raw search query to be searched for. If this field is empty, the request is considered a category browsing request.
+  "safetySettings": [ # Optional. The safety settings to be applied to the generated content.
+    { # Safety settings.
+      "category": "A String", # Harm category.
+      "method": "A String", # Optional. Specify if the threshold is used for probability or severity score. If not specified, the threshold is used for probability score.
+      "threshold": "A String", # The harm block threshold.
+    },
+  ],
   "searchParams": { # Search parameters. # Optional. Search parameters.
     "boostSpec": { # Boost specification to boost certain items. # Optional. The boost spec to specify the boosting of search results. The syntax of the boost spec is the same as SearchRequest.boost_spec.
       "conditionBoostSpecs": [ # Condition boost specifications. If a product matches multiple conditions in the specifications, boost scores from these specifications are all applied and combined in a non-linear way. Maximum number of specifications is 20.
@@ -721,6 +728,185 @@ 
Method Details

       "A String",
     ],
     "pageViewId": "A String", # A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
+    "panels": [ # Optional. List of panels associated with this event. Used for panel-level impression data.
+      { # Detailed panel information associated with a user event.
+        "attributionToken": "A String", # Optional. The attribution token of the panel.
+        "displayName": "A String", # Optional. The display name of the panel.
+        "panelId": "A String", # Required. The panel ID.
+        "panelPosition": 42, # Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.
+        "productDetails": [ # Optional. The product details associated with the panel.
+          { # Detailed product information associated with a user event.
+            "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
+              "attributes": { # Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here. Features that can take on one of a limited number of possible values. Two types of features can be set are: Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer. For example: `{ "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": {"numbers":[2.3, 15.4]}, "heights_cm": {"numbers":[8.1, 6.4]} }`. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * Max entries count: 200. * The key must be a UTF-8 encoded string with a length limit of 128 characters. * For indexable attribute, the key must match the pattern: `a-zA-Z0-9*`. For example, `key0LikeThis` or `KEY_1_LIKE_THIS`. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed.
+                "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                  "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                  "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                    3.14,
+                  ],
+                  "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                  "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                },
+              },
+              "audience": { # An intended audience of the Product for whom it's sold. # The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product.
+                "ageGroups": [ # The age groups of the audience. Strongly encouraged to use the standard values: "newborn" (up to 3 months old), "infant" (3–12 months old), "toddler" (1–5 years old), "kids" (5–13 years old), "adult" (typically teens or older). At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [age_group](https://support.google.com/merchants/answer/6324463). Schema.org property [Product.audience.suggestedMinAge](https://schema.org/suggestedMinAge) and [Product.audience.suggestedMaxAge](https://schema.org/suggestedMaxAge).
+                  "A String",
+                ],
+                "genders": [ # The genders of the audience. Strongly encouraged to use the standard values: "male", "female", "unisex". At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [gender](https://support.google.com/merchants/answer/6324479). Schema.org property [Product.audience.suggestedGender](https://schema.org/suggestedGender).
+                  "A String",
+                ],
+              },
+              "availability": "A String", # The online availability of the Product. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+              "availableQuantity": 42, # The available quantity of the item.
+              "availableTime": "A String", # The timestamp when this Product becomes available for SearchService.Search. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT.
+              "brands": [ # The brands of the product. A maximum of 30 brands are allowed unless overridden through the Google Cloud console. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [brand](https://support.google.com/merchants/answer/6324351). Schema.org property [Product.brand](https://schema.org/brand).
+                "A String",
+              ],
+              "categories": [ # Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as: "categories": [ "Shoes & Accessories > Shoes", "Sports & Fitness > Athletic Clothing > Shoes" ] Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned. At most 250 values are allowed per Product unless overridden through the Google Cloud console. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property google_product_category. Schema.org property [Product.category] (https://schema.org/category). [mc_google_product_category]: https://support.google.com/merchants/answer/6324436
+                "A String",
+              ],
+              "collectionMemberIds": [ # The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.
+                "A String",
+              ],
+              "colorInfo": { # The color information of a Product. # The color of the product. Corresponding properties: Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                "colorFamilies": [ # The standard color families. Strongly recommended to use the following standard color groups: "Red", "Pink", "Orange", "Yellow", "Purple", "Green", "Cyan", "Blue", "Brown", "White", "Gray", "Black" and "Mixed". Normally it is expected to have only 1 color family. May consider using single "Mixed" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.
+                  "A String",
+                ],
+                "colors": [ # The color display names, which may be different from standard color family names, such as the color aliases used in the website frontend. Normally it is expected to have only 1 color. May consider using single "Mixed" instead of multiple values. A maximum of 75 colors are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                  "A String",
+                ],
+              },
+              "conditions": [ # The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used". A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [condition](https://support.google.com/merchants/answer/6324469). Schema.org property [Offer.itemCondition](https://schema.org/itemCondition).
+                "A String",
+              ],
+              "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
+              "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+              "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
+                { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
+                  "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                  "type": "A String", # The fulfillment type, including commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned.
+                },
+              ],
+              "gtin": "A String", # The Global Trade Item Number (GTIN) of the product. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [gtin](https://support.google.com/merchants/answer/6324461). Schema.org property [Product.isbn](https://schema.org/isbn), [Product.gtin8](https://schema.org/gtin8), [Product.gtin12](https://schema.org/gtin12), [Product.gtin13](https://schema.org/gtin13), or [Product.gtin14](https://schema.org/gtin14). If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.
+              "id": "A String", # Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1`. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [id](https://support.google.com/merchants/answer/6324405). Schema.org property [Product.sku](https://schema.org/sku).
+              "images": [ # Product images for the product. We highly recommend putting the main image first. A maximum of 300 images are allowed. Corresponding properties: Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                { # Product image. Recommendations AI and Retail Search use product images to improve prediction and search results. Product images can be returned in results, and are shown in prediction or search previews in the console. Please try to provide correct product images and avoid using images with size too small.
+                  "height": 42, # Height of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "uri": "A String", # Required. URI of the image. This field must be a valid UTF-8 encoded URI with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                  "width": 42, # Width of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                },
+              ],
+              "languageCode": "A String", # Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance. For product search this field is in use. It defaults to "en-US" if unset.
+              "localInventories": [ # Output only. A list of local inventories specific to different places. This field can be managed by ProductService.AddLocalInventories and ProductService.RemoveLocalInventories APIs if fine-grained, high-volume updates are necessary.
+                { # The inventory information at a place (e.g. a store) identified by a place ID.
+                  "attributes": { # Optional. Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.
+                    "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                      "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                      "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                        3.14,
+                      ],
+                      "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                      "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                        "A String",
+                      ],
+                    },
+                  },
+                  "availability": "A String", # Optional. The availability of the Product at this place_id. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability). This field is currently only used by the Recommendations API. For Search, please make use of fulfillment_types or custom attributes for similar behaviour. See [here]( https://cloud.google.com/retail/docs/local-inventory-updates#local-inventory-update-methods) for more details.
+                  "fulfillmentTypes": [ # Optional. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                  "placeId": "A String", # Optional. The place ID for the current set of inventory information.
+                  "priceInfo": { # The price information of a Product. # Optional. Product price and cost information. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                    "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                    "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                    "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                    "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                    "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                    "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                    "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                      "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                        "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                        "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                        "maximum": 3.14, # Inclusive upper bound.
+                        "minimum": 3.14, # Inclusive lower bound.
+                      },
+                      "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                        "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                        "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                        "maximum": 3.14, # Inclusive upper bound.
+                        "minimum": 3.14, # Inclusive lower bound.
+                      },
+                    },
+                  },
+                },
+              ],
+              "materials": [ # The material of the product. For example, "leather", "wooden". A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [material](https://support.google.com/merchants/answer/6324410). Schema.org property [Product.material](https://schema.org/material).
+                "A String",
+              ],
+              "name": "A String", # Immutable. Full resource name of the product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id`.
+              "patterns": [ # The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [pattern](https://support.google.com/merchants/answer/6324483). Schema.org property [Product.pattern](https://schema.org/pattern).
+                "A String",
+              ],
+              "priceInfo": { # The price information of a Product. # Product price and cost information. Corresponding properties: Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                  "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                    "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                    "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                    "maximum": 3.14, # Inclusive upper bound.
+                    "minimum": 3.14, # Inclusive lower bound.
+                  },
+                  "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                    "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                    "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                    "maximum": 3.14, # Inclusive upper bound.
+                    "minimum": 3.14, # Inclusive lower bound.
+                  },
+                },
+              },
+              "primaryProductId": "A String", # Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown. For Type.PRIMARY Products, this field can only be empty or set to the same value as id. For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [item_group_id](https://support.google.com/merchants/answer/6324507). Schema.org property [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID).
+              "promotions": [ # The promotions applied to the product. A maximum of 10 values are allowed per Product. Only Promotion.promotion_id will be used, other fields will be ignored if set.
+                { # Promotion specification.
+                  "promotionId": "A String", # Promotion identifier, which is the final component of name. For example, this field is "free_gift", if name is `projects/*/locations/global/catalogs/default_catalog/promotions/free_gift`. The value must be a UTF-8 encoded string with a length limit of 128 characters, and match the pattern: `a-zA-Z*`. For example, id0LikeThis or ID_1_LIKE_THIS. Otherwise, an INVALID_ARGUMENT error is returned. Corresponds to Google Merchant Center property [promotion_id](https://support.google.com/merchants/answer/7050148).
+                },
+              ],
+              "publishTime": "A String", # The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.
+              "rating": { # The rating of a Product. # The rating of this product.
+                "averageRating": 3.14, # The average rating of the Product. The rating is scaled at 1-5. Otherwise, an INVALID_ARGUMENT error is returned.
+                "ratingCount": 42, # The total number of ratings. This value is independent of the value of rating_histogram. This value must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                "ratingHistogram": [ # List of rating counts per rating value (index = rating - 1). The list is empty if there is no rating. If the list is non-empty, its size is always 5. Otherwise, an INVALID_ARGUMENT error is returned. For example, [41, 14, 13, 47, 303]. It means that the Product got 41 ratings with 1 star, 14 ratings with 2 star, and so on.
+                  42,
+                ],
+              },
+              "retrievableFields": "A String", # Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
+              "sizes": [ # The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value]. For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [size](https://support.google.com/merchants/answer/6324492), [size_type](https://support.google.com/merchants/answer/6324497), and [size_system](https://support.google.com/merchants/answer/6324502). Schema.org property [Product.size](https://schema.org/size).
+                "A String",
+              ],
+              "tags": [ # Custom tags associated with the product. At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter. Corresponding properties: Google Merchant Center property [custom_label_0–4](https://support.google.com/merchants/answer/6324473).
+                "A String",
+              ],
+              "title": "A String", # Required. Product title. This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [title](https://support.google.com/merchants/answer/6324415). Schema.org property [Product.name](https://schema.org/name).
+              "ttl": "A String", # Input only. The TTL (time to live) of the product. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. If it is set, it must be a non-negative value, and expire_time is set as current timestamp plus ttl. The derived expire_time is returned in the output and ttl is left blank when retrieving the Product. If it is set, the product is not available for SearchService.Search after current timestamp plus ttl. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts.
+              "type": "A String", # Immutable. The type of the product. Default to Catalog.product_level_config.ingestion_product_type if unset.
+              "uri": "A String", # Canonical URL directly linking to the product detail page. It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [link](https://support.google.com/merchants/answer/6324416). Schema.org property [Offer.url](https://schema.org/url).
+              "variants": [ # Output only. Product variants grouped together on primary product which share similar product attributes. It's automatically grouped by primary_product_id for all the product variants. Only populated for Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                # Object with schema name: GoogleCloudRetailV2alphaProduct
+              ],
+            },
+            "quantity": 42, # Quantity of the product associated with the user event. For example, this field will be 2 if two products are added to the shopping cart for `purchase-complete` event. Required for `add-to-cart` and `purchase-complete` event types.
+          },
+        ],
+        "totalPanels": 42, # Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.
+      },
+    ],
     "productDetails": [ # The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.
       { # Detailed product information associated with a user event.
         "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
diff --git a/docs/dyn/retail_v2alpha.projects.locations.catalogs.userEvents.html b/docs/dyn/retail_v2alpha.projects.locations.catalogs.userEvents.html
index f99f3f4a168..e61d6e2b13e 100644
--- a/docs/dyn/retail_v2alpha.projects.locations.catalogs.userEvents.html
+++ b/docs/dyn/retail_v2alpha.projects.locations.catalogs.userEvents.html
@@ -256,6 +256,185 @@ 
Method Details

             "A String",
           ],
           "pageViewId": "A String", # A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
+          "panels": [ # Optional. List of panels associated with this event. Used for panel-level impression data.
+            { # Detailed panel information associated with a user event.
+              "attributionToken": "A String", # Optional. The attribution token of the panel.
+              "displayName": "A String", # Optional. The display name of the panel.
+              "panelId": "A String", # Required. The panel ID.
+              "panelPosition": 42, # Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.
+              "productDetails": [ # Optional. The product details associated with the panel.
+                { # Detailed product information associated with a user event.
+                  "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
+                    "attributes": { # Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here. Features that can take on one of a limited number of possible values. Two types of features can be set are: Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer. For example: `{ "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": {"numbers":[2.3, 15.4]}, "heights_cm": {"numbers":[8.1, 6.4]} }`. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * Max entries count: 200. * The key must be a UTF-8 encoded string with a length limit of 128 characters. * For indexable attribute, the key must match the pattern: `a-zA-Z0-9*`. For example, `key0LikeThis` or `KEY_1_LIKE_THIS`. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed.
+                      "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                        "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                        "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                          3.14,
+                        ],
+                        "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                        "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                          "A String",
+                        ],
+                      },
+                    },
+                    "audience": { # An intended audience of the Product for whom it's sold. # The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product.
+                      "ageGroups": [ # The age groups of the audience. Strongly encouraged to use the standard values: "newborn" (up to 3 months old), "infant" (3–12 months old), "toddler" (1–5 years old), "kids" (5–13 years old), "adult" (typically teens or older). At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [age_group](https://support.google.com/merchants/answer/6324463). Schema.org property [Product.audience.suggestedMinAge](https://schema.org/suggestedMinAge) and [Product.audience.suggestedMaxAge](https://schema.org/suggestedMaxAge).
+                        "A String",
+                      ],
+                      "genders": [ # The genders of the audience. Strongly encouraged to use the standard values: "male", "female", "unisex". At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [gender](https://support.google.com/merchants/answer/6324479). Schema.org property [Product.audience.suggestedGender](https://schema.org/suggestedGender).
+                        "A String",
+                      ],
+                    },
+                    "availability": "A String", # The online availability of the Product. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+                    "availableQuantity": 42, # The available quantity of the item.
+                    "availableTime": "A String", # The timestamp when this Product becomes available for SearchService.Search. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT.
+                    "brands": [ # The brands of the product. A maximum of 30 brands are allowed unless overridden through the Google Cloud console. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [brand](https://support.google.com/merchants/answer/6324351). Schema.org property [Product.brand](https://schema.org/brand).
+                      "A String",
+                    ],
+                    "categories": [ # Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as: "categories": [ "Shoes & Accessories > Shoes", "Sports & Fitness > Athletic Clothing > Shoes" ] Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned. At most 250 values are allowed per Product unless overridden through the Google Cloud console. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property google_product_category. Schema.org property [Product.category] (https://schema.org/category). [mc_google_product_category]: https://support.google.com/merchants/answer/6324436
+                      "A String",
+                    ],
+                    "collectionMemberIds": [ # The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.
+                      "A String",
+                    ],
+                    "colorInfo": { # The color information of a Product. # The color of the product. Corresponding properties: Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                      "colorFamilies": [ # The standard color families. Strongly recommended to use the following standard color groups: "Red", "Pink", "Orange", "Yellow", "Purple", "Green", "Cyan", "Blue", "Brown", "White", "Gray", "Black" and "Mixed". Normally it is expected to have only 1 color family. May consider using single "Mixed" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.
+                        "A String",
+                      ],
+                      "colors": [ # The color display names, which may be different from standard color family names, such as the color aliases used in the website frontend. Normally it is expected to have only 1 color. May consider using single "Mixed" instead of multiple values. A maximum of 75 colors are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                        "A String",
+                      ],
+                    },
+                    "conditions": [ # The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used". A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [condition](https://support.google.com/merchants/answer/6324469). Schema.org property [Offer.itemCondition](https://schema.org/itemCondition).
+                      "A String",
+                    ],
+                    "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
+                    "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+                    "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
+                      { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
+                        "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
+                          "A String",
+                        ],
+                        "type": "A String", # The fulfillment type, including commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned.
+                      },
+                    ],
+                    "gtin": "A String", # The Global Trade Item Number (GTIN) of the product. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [gtin](https://support.google.com/merchants/answer/6324461). Schema.org property [Product.isbn](https://schema.org/isbn), [Product.gtin8](https://schema.org/gtin8), [Product.gtin12](https://schema.org/gtin12), [Product.gtin13](https://schema.org/gtin13), or [Product.gtin14](https://schema.org/gtin14). If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.
+                    "id": "A String", # Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1`. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [id](https://support.google.com/merchants/answer/6324405). Schema.org property [Product.sku](https://schema.org/sku).
+                    "images": [ # Product images for the product. We highly recommend putting the main image first. A maximum of 300 images are allowed. Corresponding properties: Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                      { # Product image. Recommendations AI and Retail Search use product images to improve prediction and search results. Product images can be returned in results, and are shown in prediction or search previews in the console. Please try to provide correct product images and avoid using images with size too small.
+                        "height": 42, # Height of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                        "uri": "A String", # Required. URI of the image. This field must be a valid UTF-8 encoded URI with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                        "width": 42, # Width of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                      },
+                    ],
+                    "languageCode": "A String", # Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance. For product search this field is in use. It defaults to "en-US" if unset.
+                    "localInventories": [ # Output only. A list of local inventories specific to different places. This field can be managed by ProductService.AddLocalInventories and ProductService.RemoveLocalInventories APIs if fine-grained, high-volume updates are necessary.
+                      { # The inventory information at a place (e.g. a store) identified by a place ID.
+                        "attributes": { # Optional. Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.
+                          "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                            "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                            "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                              3.14,
+                            ],
+                            "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                            "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                              "A String",
+                            ],
+                          },
+                        },
+                        "availability": "A String", # Optional. The availability of the Product at this place_id. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability). This field is currently only used by the Recommendations API. For Search, please make use of fulfillment_types or custom attributes for similar behaviour. See [here]( https://cloud.google.com/retail/docs/local-inventory-updates#local-inventory-update-methods) for more details.
+                        "fulfillmentTypes": [ # Optional. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.
+                          "A String",
+                        ],
+                        "placeId": "A String", # Optional. The place ID for the current set of inventory information.
+                        "priceInfo": { # The price information of a Product. # Optional. Product price and cost information. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                          "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                          "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                          "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                          "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                          "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                          "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                          "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                            "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                              "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                              "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                              "maximum": 3.14, # Inclusive upper bound.
+                              "minimum": 3.14, # Inclusive lower bound.
+                            },
+                            "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                              "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                              "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                              "maximum": 3.14, # Inclusive upper bound.
+                              "minimum": 3.14, # Inclusive lower bound.
+                            },
+                          },
+                        },
+                      },
+                    ],
+                    "materials": [ # The material of the product. For example, "leather", "wooden". A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [material](https://support.google.com/merchants/answer/6324410). Schema.org property [Product.material](https://schema.org/material).
+                      "A String",
+                    ],
+                    "name": "A String", # Immutable. Full resource name of the product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id`.
+                    "patterns": [ # The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [pattern](https://support.google.com/merchants/answer/6324483). Schema.org property [Product.pattern](https://schema.org/pattern).
+                      "A String",
+                    ],
+                    "priceInfo": { # The price information of a Product. # Product price and cost information. Corresponding properties: Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                      "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                      "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                      "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                      "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                      "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                      "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                      "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                        "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                          "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                          "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                          "maximum": 3.14, # Inclusive upper bound.
+                          "minimum": 3.14, # Inclusive lower bound.
+                        },
+                        "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                          "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                          "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                          "maximum": 3.14, # Inclusive upper bound.
+                          "minimum": 3.14, # Inclusive lower bound.
+                        },
+                      },
+                    },
+                    "primaryProductId": "A String", # Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown. For Type.PRIMARY Products, this field can only be empty or set to the same value as id. For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [item_group_id](https://support.google.com/merchants/answer/6324507). Schema.org property [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID).
+                    "promotions": [ # The promotions applied to the product. A maximum of 10 values are allowed per Product. Only Promotion.promotion_id will be used, other fields will be ignored if set.
+                      { # Promotion specification.
+                        "promotionId": "A String", # Promotion identifier, which is the final component of name. For example, this field is "free_gift", if name is `projects/*/locations/global/catalogs/default_catalog/promotions/free_gift`. The value must be a UTF-8 encoded string with a length limit of 128 characters, and match the pattern: `a-zA-Z*`. For example, id0LikeThis or ID_1_LIKE_THIS. Otherwise, an INVALID_ARGUMENT error is returned. Corresponds to Google Merchant Center property [promotion_id](https://support.google.com/merchants/answer/7050148).
+                      },
+                    ],
+                    "publishTime": "A String", # The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.
+                    "rating": { # The rating of a Product. # The rating of this product.
+                      "averageRating": 3.14, # The average rating of the Product. The rating is scaled at 1-5. Otherwise, an INVALID_ARGUMENT error is returned.
+                      "ratingCount": 42, # The total number of ratings. This value is independent of the value of rating_histogram. This value must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                      "ratingHistogram": [ # List of rating counts per rating value (index = rating - 1). The list is empty if there is no rating. If the list is non-empty, its size is always 5. Otherwise, an INVALID_ARGUMENT error is returned. For example, [41, 14, 13, 47, 303]. It means that the Product got 41 ratings with 1 star, 14 ratings with 2 star, and so on.
+                        42,
+                      ],
+                    },
+                    "retrievableFields": "A String", # Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
+                    "sizes": [ # The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value]. For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [size](https://support.google.com/merchants/answer/6324492), [size_type](https://support.google.com/merchants/answer/6324497), and [size_system](https://support.google.com/merchants/answer/6324502). Schema.org property [Product.size](https://schema.org/size).
+                      "A String",
+                    ],
+                    "tags": [ # Custom tags associated with the product. At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter. Corresponding properties: Google Merchant Center property [custom_label_0–4](https://support.google.com/merchants/answer/6324473).
+                      "A String",
+                    ],
+                    "title": "A String", # Required. Product title. This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [title](https://support.google.com/merchants/answer/6324415). Schema.org property [Product.name](https://schema.org/name).
+                    "ttl": "A String", # Input only. The TTL (time to live) of the product. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. If it is set, it must be a non-negative value, and expire_time is set as current timestamp plus ttl. The derived expire_time is returned in the output and ttl is left blank when retrieving the Product. If it is set, the product is not available for SearchService.Search after current timestamp plus ttl. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts.
+                    "type": "A String", # Immutable. The type of the product. Default to Catalog.product_level_config.ingestion_product_type if unset.
+                    "uri": "A String", # Canonical URL directly linking to the product detail page. It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [link](https://support.google.com/merchants/answer/6324416). Schema.org property [Offer.url](https://schema.org/url).
+                    "variants": [ # Output only. Product variants grouped together on primary product which share similar product attributes. It's automatically grouped by primary_product_id for all the product variants. Only populated for Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                      # Object with schema name: GoogleCloudRetailV2alphaProduct
+                    ],
+                  },
+                  "quantity": 42, # Quantity of the product associated with the user event. For example, this field will be 2 if two products are added to the shopping cart for `purchase-complete` event. Required for `add-to-cart` and `purchase-complete` event types.
+                },
+              ],
+              "totalPanels": 42, # Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.
+            },
+          ],
           "productDetails": [ # The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.
             { # Detailed product information associated with a user event.
               "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
@@ -606,6 +785,185 @@ 
Method Details

     "A String",
   ],
   "pageViewId": "A String", # A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
+  "panels": [ # Optional. List of panels associated with this event. Used for panel-level impression data.
+    { # Detailed panel information associated with a user event.
+      "attributionToken": "A String", # Optional. The attribution token of the panel.
+      "displayName": "A String", # Optional. The display name of the panel.
+      "panelId": "A String", # Required. The panel ID.
+      "panelPosition": 42, # Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.
+      "productDetails": [ # Optional. The product details associated with the panel.
+        { # Detailed product information associated with a user event.
+          "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
+            "attributes": { # Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here. Features that can take on one of a limited number of possible values. Two types of features can be set are: Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer. For example: `{ "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": {"numbers":[2.3, 15.4]}, "heights_cm": {"numbers":[8.1, 6.4]} }`. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * Max entries count: 200. * The key must be a UTF-8 encoded string with a length limit of 128 characters. * For indexable attribute, the key must match the pattern: `a-zA-Z0-9*`. For example, `key0LikeThis` or `KEY_1_LIKE_THIS`. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed.
+              "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                  3.14,
+                ],
+                "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+              },
+            },
+            "audience": { # An intended audience of the Product for whom it's sold. # The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product.
+              "ageGroups": [ # The age groups of the audience. Strongly encouraged to use the standard values: "newborn" (up to 3 months old), "infant" (3–12 months old), "toddler" (1–5 years old), "kids" (5–13 years old), "adult" (typically teens or older). At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [age_group](https://support.google.com/merchants/answer/6324463). Schema.org property [Product.audience.suggestedMinAge](https://schema.org/suggestedMinAge) and [Product.audience.suggestedMaxAge](https://schema.org/suggestedMaxAge).
+                "A String",
+              ],
+              "genders": [ # The genders of the audience. Strongly encouraged to use the standard values: "male", "female", "unisex". At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [gender](https://support.google.com/merchants/answer/6324479). Schema.org property [Product.audience.suggestedGender](https://schema.org/suggestedGender).
+                "A String",
+              ],
+            },
+            "availability": "A String", # The online availability of the Product. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+            "availableQuantity": 42, # The available quantity of the item.
+            "availableTime": "A String", # The timestamp when this Product becomes available for SearchService.Search. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT.
+            "brands": [ # The brands of the product. A maximum of 30 brands are allowed unless overridden through the Google Cloud console. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [brand](https://support.google.com/merchants/answer/6324351). Schema.org property [Product.brand](https://schema.org/brand).
+              "A String",
+            ],
+            "categories": [ # Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as: "categories": [ "Shoes & Accessories > Shoes", "Sports & Fitness > Athletic Clothing > Shoes" ] Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned. At most 250 values are allowed per Product unless overridden through the Google Cloud console. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property google_product_category. Schema.org property [Product.category] (https://schema.org/category). [mc_google_product_category]: https://support.google.com/merchants/answer/6324436
+              "A String",
+            ],
+            "collectionMemberIds": [ # The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.
+              "A String",
+            ],
+            "colorInfo": { # The color information of a Product. # The color of the product. Corresponding properties: Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+              "colorFamilies": [ # The standard color families. Strongly recommended to use the following standard color groups: "Red", "Pink", "Orange", "Yellow", "Purple", "Green", "Cyan", "Blue", "Brown", "White", "Gray", "Black" and "Mixed". Normally it is expected to have only 1 color family. May consider using single "Mixed" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.
+                "A String",
+              ],
+              "colors": [ # The color display names, which may be different from standard color family names, such as the color aliases used in the website frontend. Normally it is expected to have only 1 color. May consider using single "Mixed" instead of multiple values. A maximum of 75 colors are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                "A String",
+              ],
+            },
+            "conditions": [ # The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used". A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [condition](https://support.google.com/merchants/answer/6324469). Schema.org property [Offer.itemCondition](https://schema.org/itemCondition).
+              "A String",
+            ],
+            "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
+            "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+            "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
+              { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
+                "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+                "type": "A String", # The fulfillment type, including commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned.
+              },
+            ],
+            "gtin": "A String", # The Global Trade Item Number (GTIN) of the product. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [gtin](https://support.google.com/merchants/answer/6324461). Schema.org property [Product.isbn](https://schema.org/isbn), [Product.gtin8](https://schema.org/gtin8), [Product.gtin12](https://schema.org/gtin12), [Product.gtin13](https://schema.org/gtin13), or [Product.gtin14](https://schema.org/gtin14). If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.
+            "id": "A String", # Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1`. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [id](https://support.google.com/merchants/answer/6324405). Schema.org property [Product.sku](https://schema.org/sku).
+            "images": [ # Product images for the product. We highly recommend putting the main image first. A maximum of 300 images are allowed. Corresponding properties: Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+              { # Product image. Recommendations AI and Retail Search use product images to improve prediction and search results. Product images can be returned in results, and are shown in prediction or search previews in the console. Please try to provide correct product images and avoid using images with size too small.
+                "height": 42, # Height of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                "uri": "A String", # Required. URI of the image. This field must be a valid UTF-8 encoded URI with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                "width": 42, # Width of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+              },
+            ],
+            "languageCode": "A String", # Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance. For product search this field is in use. It defaults to "en-US" if unset.
+            "localInventories": [ # Output only. A list of local inventories specific to different places. This field can be managed by ProductService.AddLocalInventories and ProductService.RemoveLocalInventories APIs if fine-grained, high-volume updates are necessary.
+              { # The inventory information at a place (e.g. a store) identified by a place ID.
+                "attributes": { # Optional. Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.
+                  "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                    "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                    "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                      3.14,
+                    ],
+                    "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                    "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                      "A String",
+                    ],
+                  },
+                },
+                "availability": "A String", # Optional. The availability of the Product at this place_id. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability). This field is currently only used by the Recommendations API. For Search, please make use of fulfillment_types or custom attributes for similar behaviour. See [here]( https://cloud.google.com/retail/docs/local-inventory-updates#local-inventory-update-methods) for more details.
+                "fulfillmentTypes": [ # Optional. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+                "placeId": "A String", # Optional. The place ID for the current set of inventory information.
+                "priceInfo": { # The price information of a Product. # Optional. Product price and cost information. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                  "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                  "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                  "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                  "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                  "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                  "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                  "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                    "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                      "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                      "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                      "maximum": 3.14, # Inclusive upper bound.
+                      "minimum": 3.14, # Inclusive lower bound.
+                    },
+                    "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                      "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                      "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                      "maximum": 3.14, # Inclusive upper bound.
+                      "minimum": 3.14, # Inclusive lower bound.
+                    },
+                  },
+                },
+              },
+            ],
+            "materials": [ # The material of the product. For example, "leather", "wooden". A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [material](https://support.google.com/merchants/answer/6324410). Schema.org property [Product.material](https://schema.org/material).
+              "A String",
+            ],
+            "name": "A String", # Immutable. Full resource name of the product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id`.
+            "patterns": [ # The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [pattern](https://support.google.com/merchants/answer/6324483). Schema.org property [Product.pattern](https://schema.org/pattern).
+              "A String",
+            ],
+            "priceInfo": { # The price information of a Product. # Product price and cost information. Corresponding properties: Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+              "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+              "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+              "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+              "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+              "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+              "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+              "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                  "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                  "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                  "maximum": 3.14, # Inclusive upper bound.
+                  "minimum": 3.14, # Inclusive lower bound.
+                },
+                "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                  "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                  "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                  "maximum": 3.14, # Inclusive upper bound.
+                  "minimum": 3.14, # Inclusive lower bound.
+                },
+              },
+            },
+            "primaryProductId": "A String", # Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown. For Type.PRIMARY Products, this field can only be empty or set to the same value as id. For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [item_group_id](https://support.google.com/merchants/answer/6324507). Schema.org property [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID).
+            "promotions": [ # The promotions applied to the product. A maximum of 10 values are allowed per Product. Only Promotion.promotion_id will be used, other fields will be ignored if set.
+              { # Promotion specification.
+                "promotionId": "A String", # Promotion identifier, which is the final component of name. For example, this field is "free_gift", if name is `projects/*/locations/global/catalogs/default_catalog/promotions/free_gift`. The value must be a UTF-8 encoded string with a length limit of 128 characters, and match the pattern: `a-zA-Z*`. For example, id0LikeThis or ID_1_LIKE_THIS. Otherwise, an INVALID_ARGUMENT error is returned. Corresponds to Google Merchant Center property [promotion_id](https://support.google.com/merchants/answer/7050148).
+              },
+            ],
+            "publishTime": "A String", # The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.
+            "rating": { # The rating of a Product. # The rating of this product.
+              "averageRating": 3.14, # The average rating of the Product. The rating is scaled at 1-5. Otherwise, an INVALID_ARGUMENT error is returned.
+              "ratingCount": 42, # The total number of ratings. This value is independent of the value of rating_histogram. This value must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+              "ratingHistogram": [ # List of rating counts per rating value (index = rating - 1). The list is empty if there is no rating. If the list is non-empty, its size is always 5. Otherwise, an INVALID_ARGUMENT error is returned. For example, [41, 14, 13, 47, 303]. It means that the Product got 41 ratings with 1 star, 14 ratings with 2 star, and so on.
+                42,
+              ],
+            },
+            "retrievableFields": "A String", # Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
+            "sizes": [ # The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value]. For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [size](https://support.google.com/merchants/answer/6324492), [size_type](https://support.google.com/merchants/answer/6324497), and [size_system](https://support.google.com/merchants/answer/6324502). Schema.org property [Product.size](https://schema.org/size).
+              "A String",
+            ],
+            "tags": [ # Custom tags associated with the product. At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter. Corresponding properties: Google Merchant Center property [custom_label_0–4](https://support.google.com/merchants/answer/6324473).
+              "A String",
+            ],
+            "title": "A String", # Required. Product title. This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [title](https://support.google.com/merchants/answer/6324415). Schema.org property [Product.name](https://schema.org/name).
+            "ttl": "A String", # Input only. The TTL (time to live) of the product. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. If it is set, it must be a non-negative value, and expire_time is set as current timestamp plus ttl. The derived expire_time is returned in the output and ttl is left blank when retrieving the Product. If it is set, the product is not available for SearchService.Search after current timestamp plus ttl. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts.
+            "type": "A String", # Immutable. The type of the product. Default to Catalog.product_level_config.ingestion_product_type if unset.
+            "uri": "A String", # Canonical URL directly linking to the product detail page. It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [link](https://support.google.com/merchants/answer/6324416). Schema.org property [Offer.url](https://schema.org/url).
+            "variants": [ # Output only. Product variants grouped together on primary product which share similar product attributes. It's automatically grouped by primary_product_id for all the product variants. Only populated for Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+              # Object with schema name: GoogleCloudRetailV2alphaProduct
+            ],
+          },
+          "quantity": 42, # Quantity of the product associated with the user event. For example, this field will be 2 if two products are added to the shopping cart for `purchase-complete` event. Required for `add-to-cart` and `purchase-complete` event types.
+        },
+      ],
+      "totalPanels": 42, # Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.
+    },
+  ],
   "productDetails": [ # The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.
     { # Detailed product information associated with a user event.
       "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
@@ -838,6 +1196,185 @@ 
Method Details

     "A String",
   ],
   "pageViewId": "A String", # A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
+  "panels": [ # Optional. List of panels associated with this event. Used for panel-level impression data.
+    { # Detailed panel information associated with a user event.
+      "attributionToken": "A String", # Optional. The attribution token of the panel.
+      "displayName": "A String", # Optional. The display name of the panel.
+      "panelId": "A String", # Required. The panel ID.
+      "panelPosition": 42, # Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.
+      "productDetails": [ # Optional. The product details associated with the panel.
+        { # Detailed product information associated with a user event.
+          "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
+            "attributes": { # Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here. Features that can take on one of a limited number of possible values. Two types of features can be set are: Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer. For example: `{ "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": {"numbers":[2.3, 15.4]}, "heights_cm": {"numbers":[8.1, 6.4]} }`. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * Max entries count: 200. * The key must be a UTF-8 encoded string with a length limit of 128 characters. * For indexable attribute, the key must match the pattern: `a-zA-Z0-9*`. For example, `key0LikeThis` or `KEY_1_LIKE_THIS`. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed.
+              "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                  3.14,
+                ],
+                "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+              },
+            },
+            "audience": { # An intended audience of the Product for whom it's sold. # The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product.
+              "ageGroups": [ # The age groups of the audience. Strongly encouraged to use the standard values: "newborn" (up to 3 months old), "infant" (3–12 months old), "toddler" (1–5 years old), "kids" (5–13 years old), "adult" (typically teens or older). At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [age_group](https://support.google.com/merchants/answer/6324463). Schema.org property [Product.audience.suggestedMinAge](https://schema.org/suggestedMinAge) and [Product.audience.suggestedMaxAge](https://schema.org/suggestedMaxAge).
+                "A String",
+              ],
+              "genders": [ # The genders of the audience. Strongly encouraged to use the standard values: "male", "female", "unisex". At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [gender](https://support.google.com/merchants/answer/6324479). Schema.org property [Product.audience.suggestedGender](https://schema.org/suggestedGender).
+                "A String",
+              ],
+            },
+            "availability": "A String", # The online availability of the Product. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+            "availableQuantity": 42, # The available quantity of the item.
+            "availableTime": "A String", # The timestamp when this Product becomes available for SearchService.Search. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT.
+            "brands": [ # The brands of the product. A maximum of 30 brands are allowed unless overridden through the Google Cloud console. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [brand](https://support.google.com/merchants/answer/6324351). Schema.org property [Product.brand](https://schema.org/brand).
+              "A String",
+            ],
+            "categories": [ # Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as: "categories": [ "Shoes & Accessories > Shoes", "Sports & Fitness > Athletic Clothing > Shoes" ] Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned. At most 250 values are allowed per Product unless overridden through the Google Cloud console. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property google_product_category. Schema.org property [Product.category] (https://schema.org/category). [mc_google_product_category]: https://support.google.com/merchants/answer/6324436
+              "A String",
+            ],
+            "collectionMemberIds": [ # The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.
+              "A String",
+            ],
+            "colorInfo": { # The color information of a Product. # The color of the product. Corresponding properties: Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+              "colorFamilies": [ # The standard color families. Strongly recommended to use the following standard color groups: "Red", "Pink", "Orange", "Yellow", "Purple", "Green", "Cyan", "Blue", "Brown", "White", "Gray", "Black" and "Mixed". Normally it is expected to have only 1 color family. May consider using single "Mixed" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.
+                "A String",
+              ],
+              "colors": [ # The color display names, which may be different from standard color family names, such as the color aliases used in the website frontend. Normally it is expected to have only 1 color. May consider using single "Mixed" instead of multiple values. A maximum of 75 colors are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                "A String",
+              ],
+            },
+            "conditions": [ # The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used". A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [condition](https://support.google.com/merchants/answer/6324469). Schema.org property [Offer.itemCondition](https://schema.org/itemCondition).
+              "A String",
+            ],
+            "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
+            "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+            "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
+              { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
+                "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+                "type": "A String", # The fulfillment type, including commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned.
+              },
+            ],
+            "gtin": "A String", # The Global Trade Item Number (GTIN) of the product. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [gtin](https://support.google.com/merchants/answer/6324461). Schema.org property [Product.isbn](https://schema.org/isbn), [Product.gtin8](https://schema.org/gtin8), [Product.gtin12](https://schema.org/gtin12), [Product.gtin13](https://schema.org/gtin13), or [Product.gtin14](https://schema.org/gtin14). If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.
+            "id": "A String", # Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1`. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [id](https://support.google.com/merchants/answer/6324405). Schema.org property [Product.sku](https://schema.org/sku).
+            "images": [ # Product images for the product. We highly recommend putting the main image first. A maximum of 300 images are allowed. Corresponding properties: Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+              { # Product image. Recommendations AI and Retail Search use product images to improve prediction and search results. Product images can be returned in results, and are shown in prediction or search previews in the console. Please try to provide correct product images and avoid using images with size too small.
+                "height": 42, # Height of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                "uri": "A String", # Required. URI of the image. This field must be a valid UTF-8 encoded URI with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                "width": 42, # Width of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+              },
+            ],
+            "languageCode": "A String", # Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance. For product search this field is in use. It defaults to "en-US" if unset.
+            "localInventories": [ # Output only. A list of local inventories specific to different places. This field can be managed by ProductService.AddLocalInventories and ProductService.RemoveLocalInventories APIs if fine-grained, high-volume updates are necessary.
+              { # The inventory information at a place (e.g. a store) identified by a place ID.
+                "attributes": { # Optional. Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.
+                  "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                    "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                    "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                      3.14,
+                    ],
+                    "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                    "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                      "A String",
+                    ],
+                  },
+                },
+                "availability": "A String", # Optional. The availability of the Product at this place_id. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability). This field is currently only used by the Recommendations API. For Search, please make use of fulfillment_types or custom attributes for similar behaviour. See [here]( https://cloud.google.com/retail/docs/local-inventory-updates#local-inventory-update-methods) for more details.
+                "fulfillmentTypes": [ # Optional. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+                "placeId": "A String", # Optional. The place ID for the current set of inventory information.
+                "priceInfo": { # The price information of a Product. # Optional. Product price and cost information. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                  "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                  "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                  "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                  "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                  "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                  "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                  "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                    "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                      "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                      "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                      "maximum": 3.14, # Inclusive upper bound.
+                      "minimum": 3.14, # Inclusive lower bound.
+                    },
+                    "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                      "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                      "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                      "maximum": 3.14, # Inclusive upper bound.
+                      "minimum": 3.14, # Inclusive lower bound.
+                    },
+                  },
+                },
+              },
+            ],
+            "materials": [ # The material of the product. For example, "leather", "wooden". A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [material](https://support.google.com/merchants/answer/6324410). Schema.org property [Product.material](https://schema.org/material).
+              "A String",
+            ],
+            "name": "A String", # Immutable. Full resource name of the product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id`.
+            "patterns": [ # The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [pattern](https://support.google.com/merchants/answer/6324483). Schema.org property [Product.pattern](https://schema.org/pattern).
+              "A String",
+            ],
+            "priceInfo": { # The price information of a Product. # Product price and cost information. Corresponding properties: Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+              "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+              "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+              "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+              "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+              "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+              "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+              "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                  "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                  "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                  "maximum": 3.14, # Inclusive upper bound.
+                  "minimum": 3.14, # Inclusive lower bound.
+                },
+                "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                  "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                  "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                  "maximum": 3.14, # Inclusive upper bound.
+                  "minimum": 3.14, # Inclusive lower bound.
+                },
+              },
+            },
+            "primaryProductId": "A String", # Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown. For Type.PRIMARY Products, this field can only be empty or set to the same value as id. For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [item_group_id](https://support.google.com/merchants/answer/6324507). Schema.org property [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID).
+            "promotions": [ # The promotions applied to the product. A maximum of 10 values are allowed per Product. Only Promotion.promotion_id will be used, other fields will be ignored if set.
+              { # Promotion specification.
+                "promotionId": "A String", # Promotion identifier, which is the final component of name. For example, this field is "free_gift", if name is `projects/*/locations/global/catalogs/default_catalog/promotions/free_gift`. The value must be a UTF-8 encoded string with a length limit of 128 characters, and match the pattern: `a-zA-Z*`. For example, id0LikeThis or ID_1_LIKE_THIS. Otherwise, an INVALID_ARGUMENT error is returned. Corresponds to Google Merchant Center property [promotion_id](https://support.google.com/merchants/answer/7050148).
+              },
+            ],
+            "publishTime": "A String", # The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.
+            "rating": { # The rating of a Product. # The rating of this product.
+              "averageRating": 3.14, # The average rating of the Product. The rating is scaled at 1-5. Otherwise, an INVALID_ARGUMENT error is returned.
+              "ratingCount": 42, # The total number of ratings. This value is independent of the value of rating_histogram. This value must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+              "ratingHistogram": [ # List of rating counts per rating value (index = rating - 1). The list is empty if there is no rating. If the list is non-empty, its size is always 5. Otherwise, an INVALID_ARGUMENT error is returned. For example, [41, 14, 13, 47, 303]. It means that the Product got 41 ratings with 1 star, 14 ratings with 2 star, and so on.
+                42,
+              ],
+            },
+            "retrievableFields": "A String", # Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
+            "sizes": [ # The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value]. For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [size](https://support.google.com/merchants/answer/6324492), [size_type](https://support.google.com/merchants/answer/6324497), and [size_system](https://support.google.com/merchants/answer/6324502). Schema.org property [Product.size](https://schema.org/size).
+              "A String",
+            ],
+            "tags": [ # Custom tags associated with the product. At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter. Corresponding properties: Google Merchant Center property [custom_label_0–4](https://support.google.com/merchants/answer/6324473).
+              "A String",
+            ],
+            "title": "A String", # Required. Product title. This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [title](https://support.google.com/merchants/answer/6324415). Schema.org property [Product.name](https://schema.org/name).
+            "ttl": "A String", # Input only. The TTL (time to live) of the product. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. If it is set, it must be a non-negative value, and expire_time is set as current timestamp plus ttl. The derived expire_time is returned in the output and ttl is left blank when retrieving the Product. If it is set, the product is not available for SearchService.Search after current timestamp plus ttl. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts.
+            "type": "A String", # Immutable. The type of the product. Default to Catalog.product_level_config.ingestion_product_type if unset.
+            "uri": "A String", # Canonical URL directly linking to the product detail page. It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [link](https://support.google.com/merchants/answer/6324416). Schema.org property [Offer.url](https://schema.org/url).
+            "variants": [ # Output only. Product variants grouped together on primary product which share similar product attributes. It's automatically grouped by primary_product_id for all the product variants. Only populated for Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+              # Object with schema name: GoogleCloudRetailV2alphaProduct
+            ],
+          },
+          "quantity": 42, # Quantity of the product associated with the user event. For example, this field will be 2 if two products are added to the shopping cart for `purchase-complete` event. Required for `add-to-cart` and `purchase-complete` event types.
+        },
+      ],
+      "totalPanels": 42, # Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.
+    },
+  ],
   "productDetails": [ # The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.
     { # Detailed product information associated with a user event.
       "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
diff --git a/docs/dyn/retail_v2beta.projects.locations.catalogs.html b/docs/dyn/retail_v2beta.projects.locations.catalogs.html
index 3186873495d..a808246b87c 100644
--- a/docs/dyn/retail_v2beta.projects.locations.catalogs.html
+++ b/docs/dyn/retail_v2beta.projects.locations.catalogs.html
@@ -549,6 +549,7 @@ 
Method Details

             "feeds": [ # Criteria for the Merchant Center feeds to be ingested via the link. All offers will be ingested if the list is empty. Otherwise the offers will be ingested from selected feeds.
               { # Merchant Center Feed filter criterion.
                 "dataSourceId": "A String", # AFM data source ID.
+                "primaryFeedId": "A String", # Merchant Center primary feed ID. Deprecated: use data_source_id instead.
                 "primaryFeedName": "A String", # Merchant Center primary feed name. The name is used for the display purposes only.
               },
             ],
@@ -604,6 +605,7 @@ 
Method Details

         "feeds": [ # Criteria for the Merchant Center feeds to be ingested via the link. All offers will be ingested if the list is empty. Otherwise the offers will be ingested from selected feeds.
           { # Merchant Center Feed filter criterion.
             "dataSourceId": "A String", # AFM data source ID.
+            "primaryFeedId": "A String", # Merchant Center primary feed ID. Deprecated: use data_source_id instead.
             "primaryFeedName": "A String", # Merchant Center primary feed name. The name is used for the display purposes only.
           },
         ],
@@ -641,6 +643,7 @@ 
Method Details

         "feeds": [ # Criteria for the Merchant Center feeds to be ingested via the link. All offers will be ingested if the list is empty. Otherwise the offers will be ingested from selected feeds.
           { # Merchant Center Feed filter criterion.
             "dataSourceId": "A String", # AFM data source ID.
+            "primaryFeedId": "A String", # Merchant Center primary feed ID. Deprecated: use data_source_id instead.
             "primaryFeedName": "A String", # Merchant Center primary feed name. The name is used for the display purposes only.
           },
         ],
diff --git a/docs/dyn/retail_v2beta.projects.locations.catalogs.placements.html b/docs/dyn/retail_v2beta.projects.locations.catalogs.placements.html
index f599ad710ec..733cfff0e3b 100644
--- a/docs/dyn/retail_v2beta.projects.locations.catalogs.placements.html
+++ b/docs/dyn/retail_v2beta.projects.locations.catalogs.placements.html
@@ -144,6 +144,184 @@ 
Method Details

       "A String",
     ],
     "pageViewId": "A String", # A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
+    "panels": [ # Optional. List of panels associated with this event. Used for panel-level impression data.
+      { # Detailed panel information associated with a user event.
+        "attributionToken": "A String", # Optional. The attribution token of the panel.
+        "displayName": "A String", # Optional. The display name of the panel.
+        "panelId": "A String", # Required. The panel ID.
+        "panelPosition": 42, # Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.
+        "productDetails": [ # Optional. The product details associated with the panel.
+          { # Detailed product information associated with a user event.
+            "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
+              "attributes": { # Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here. Features that can take on one of a limited number of possible values. Two types of features can be set are: Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer. For example: `{ "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": {"numbers":[2.3, 15.4]}, "heights_cm": {"numbers":[8.1, 6.4]} }`. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * Max entries count: 200. * The key must be a UTF-8 encoded string with a length limit of 128 characters. * For indexable attribute, the key must match the pattern: `a-zA-Z0-9*`. For example, `key0LikeThis` or `KEY_1_LIKE_THIS`. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed.
+                "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                  "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                  "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                    3.14,
+                  ],
+                  "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                  "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                },
+              },
+              "audience": { # An intended audience of the Product for whom it's sold. # The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product.
+                "ageGroups": [ # The age groups of the audience. Strongly encouraged to use the standard values: "newborn" (up to 3 months old), "infant" (3–12 months old), "toddler" (1–5 years old), "kids" (5–13 years old), "adult" (typically teens or older). At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [age_group](https://support.google.com/merchants/answer/6324463). Schema.org property [Product.audience.suggestedMinAge](https://schema.org/suggestedMinAge) and [Product.audience.suggestedMaxAge](https://schema.org/suggestedMaxAge).
+                  "A String",
+                ],
+                "genders": [ # The genders of the audience. Strongly encouraged to use the standard values: "male", "female", "unisex". At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [gender](https://support.google.com/merchants/answer/6324479). Schema.org property [Product.audience.suggestedGender](https://schema.org/suggestedGender).
+                  "A String",
+                ],
+              },
+              "availability": "A String", # The online availability of the Product. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+              "availableQuantity": 42, # The available quantity of the item.
+              "availableTime": "A String", # The timestamp when this Product becomes available for SearchService.Search. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT.
+              "brands": [ # The brands of the product. A maximum of 30 brands are allowed unless overridden through the Google Cloud console. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [brand](https://support.google.com/merchants/answer/6324351). Schema.org property [Product.brand](https://schema.org/brand).
+                "A String",
+              ],
+              "categories": [ # Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as: "categories": [ "Shoes & Accessories > Shoes", "Sports & Fitness > Athletic Clothing > Shoes" ] Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned. At most 250 values are allowed per Product unless overridden through the Google Cloud console. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property google_product_category. Schema.org property [Product.category] (https://schema.org/category). [mc_google_product_category]: https://support.google.com/merchants/answer/6324436
+                "A String",
+              ],
+              "collectionMemberIds": [ # The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.
+                "A String",
+              ],
+              "colorInfo": { # The color information of a Product. # The color of the product. Corresponding properties: Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                "colorFamilies": [ # The standard color families. Strongly recommended to use the following standard color groups: "Red", "Pink", "Orange", "Yellow", "Purple", "Green", "Cyan", "Blue", "Brown", "White", "Gray", "Black" and "Mixed". Normally it is expected to have only 1 color family. May consider using single "Mixed" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.
+                  "A String",
+                ],
+                "colors": [ # The color display names, which may be different from standard color family names, such as the color aliases used in the website frontend. Normally it is expected to have only 1 color. May consider using single "Mixed" instead of multiple values. A maximum of 75 colors are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                  "A String",
+                ],
+              },
+              "conditions": [ # The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used". A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [condition](https://support.google.com/merchants/answer/6324469). Schema.org property [Offer.itemCondition](https://schema.org/itemCondition).
+                "A String",
+              ],
+              "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
+              "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+              "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
+                { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
+                  "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                  "type": "A String", # The fulfillment type, including commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned.
+                },
+              ],
+              "gtin": "A String", # The Global Trade Item Number (GTIN) of the product. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [gtin](https://support.google.com/merchants/answer/6324461). Schema.org property [Product.isbn](https://schema.org/isbn), [Product.gtin8](https://schema.org/gtin8), [Product.gtin12](https://schema.org/gtin12), [Product.gtin13](https://schema.org/gtin13), or [Product.gtin14](https://schema.org/gtin14). If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.
+              "id": "A String", # Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1`. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [id](https://support.google.com/merchants/answer/6324405). Schema.org property [Product.sku](https://schema.org/sku).
+              "images": [ # Product images for the product. We highly recommend putting the main image first. A maximum of 300 images are allowed. Corresponding properties: Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                { # Product image. Recommendations AI and Retail Search use product images to improve prediction and search results. Product images can be returned in results, and are shown in prediction or search previews in the console. Please try to provide correct product images and avoid using images with size too small.
+                  "height": 42, # Height of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "uri": "A String", # Required. URI of the image. This field must be a valid UTF-8 encoded URI with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                  "width": 42, # Width of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                },
+              ],
+              "languageCode": "A String", # Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance. For product search this field is in use. It defaults to "en-US" if unset.
+              "localInventories": [ # Output only. A list of local inventories specific to different places. This field can be managed by ProductService.AddLocalInventories and ProductService.RemoveLocalInventories APIs if fine-grained, high-volume updates are necessary.
+                { # The inventory information at a place (e.g. a store) identified by a place ID.
+                  "attributes": { # Optional. Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.
+                    "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                      "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                      "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                        3.14,
+                      ],
+                      "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                      "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                        "A String",
+                      ],
+                    },
+                  },
+                  "fulfillmentTypes": [ # Optional. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                  "placeId": "A String", # Optional. The place ID for the current set of inventory information.
+                  "priceInfo": { # The price information of a Product. # Optional. Product price and cost information. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                    "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                    "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                    "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                    "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                    "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                    "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                    "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                      "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                        "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                        "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                        "maximum": 3.14, # Inclusive upper bound.
+                        "minimum": 3.14, # Inclusive lower bound.
+                      },
+                      "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                        "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                        "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                        "maximum": 3.14, # Inclusive upper bound.
+                        "minimum": 3.14, # Inclusive lower bound.
+                      },
+                    },
+                  },
+                },
+              ],
+              "materials": [ # The material of the product. For example, "leather", "wooden". A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [material](https://support.google.com/merchants/answer/6324410). Schema.org property [Product.material](https://schema.org/material).
+                "A String",
+              ],
+              "name": "A String", # Immutable. Full resource name of the product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id`.
+              "patterns": [ # The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [pattern](https://support.google.com/merchants/answer/6324483). Schema.org property [Product.pattern](https://schema.org/pattern).
+                "A String",
+              ],
+              "priceInfo": { # The price information of a Product. # Product price and cost information. Corresponding properties: Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                  "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                    "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                    "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                    "maximum": 3.14, # Inclusive upper bound.
+                    "minimum": 3.14, # Inclusive lower bound.
+                  },
+                  "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                    "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                    "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                    "maximum": 3.14, # Inclusive upper bound.
+                    "minimum": 3.14, # Inclusive lower bound.
+                  },
+                },
+              },
+              "primaryProductId": "A String", # Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown. For Type.PRIMARY Products, this field can only be empty or set to the same value as id. For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [item_group_id](https://support.google.com/merchants/answer/6324507). Schema.org property [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID).
+              "promotions": [ # The promotions applied to the product. A maximum of 10 values are allowed per Product. Only Promotion.promotion_id will be used, other fields will be ignored if set.
+                { # Promotion specification.
+                  "promotionId": "A String", # Promotion identifier, which is the final component of name. For example, this field is "free_gift", if name is `projects/*/locations/global/catalogs/default_catalog/promotions/free_gift`. The value must be a UTF-8 encoded string with a length limit of 128 characters, and match the pattern: `a-zA-Z*`. For example, id0LikeThis or ID_1_LIKE_THIS. Otherwise, an INVALID_ARGUMENT error is returned. Corresponds to Google Merchant Center property [promotion_id](https://support.google.com/merchants/answer/7050148).
+                },
+              ],
+              "publishTime": "A String", # The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.
+              "rating": { # The rating of a Product. # The rating of this product.
+                "averageRating": 3.14, # The average rating of the Product. The rating is scaled at 1-5. Otherwise, an INVALID_ARGUMENT error is returned.
+                "ratingCount": 42, # The total number of ratings. This value is independent of the value of rating_histogram. This value must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                "ratingHistogram": [ # List of rating counts per rating value (index = rating - 1). The list is empty if there is no rating. If the list is non-empty, its size is always 5. Otherwise, an INVALID_ARGUMENT error is returned. For example, [41, 14, 13, 47, 303]. It means that the Product got 41 ratings with 1 star, 14 ratings with 2 star, and so on.
+                  42,
+                ],
+              },
+              "retrievableFields": "A String", # Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
+              "sizes": [ # The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value]. For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [size](https://support.google.com/merchants/answer/6324492), [size_type](https://support.google.com/merchants/answer/6324497), and [size_system](https://support.google.com/merchants/answer/6324502). Schema.org property [Product.size](https://schema.org/size).
+                "A String",
+              ],
+              "tags": [ # Custom tags associated with the product. At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter. Corresponding properties: Google Merchant Center property [custom_label_0–4](https://support.google.com/merchants/answer/6324473).
+                "A String",
+              ],
+              "title": "A String", # Required. Product title. This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [title](https://support.google.com/merchants/answer/6324415). Schema.org property [Product.name](https://schema.org/name).
+              "ttl": "A String", # Input only. The TTL (time to live) of the product. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. If it is set, it must be a non-negative value, and expire_time is set as current timestamp plus ttl. The derived expire_time is returned in the output and ttl is left blank when retrieving the Product. If it is set, the product is not available for SearchService.Search after current timestamp plus ttl. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts.
+              "type": "A String", # Immutable. The type of the product. Default to Catalog.product_level_config.ingestion_product_type if unset.
+              "uri": "A String", # Canonical URL directly linking to the product detail page. It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [link](https://support.google.com/merchants/answer/6324416). Schema.org property [Offer.url](https://schema.org/url).
+              "variants": [ # Output only. Product variants grouped together on primary product which share similar product attributes. It's automatically grouped by primary_product_id for all the product variants. Only populated for Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                # Object with schema name: GoogleCloudRetailV2betaProduct
+              ],
+            },
+            "quantity": 42, # Quantity of the product associated with the user event. For example, this field will be 2 if two products are added to the shopping cart for `purchase-complete` event. Required for `add-to-cart` and `purchase-complete` event types.
+          },
+        ],
+        "totalPanels": 42, # Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.
+      },
+    ],
     "productDetails": [ # The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.
       { # Detailed product information associated with a user event.
         "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
diff --git a/docs/dyn/retail_v2beta.projects.locations.catalogs.servingConfigs.html b/docs/dyn/retail_v2beta.projects.locations.catalogs.servingConfigs.html
index 24acb24b364..3484f08ac4f 100644
--- a/docs/dyn/retail_v2beta.projects.locations.catalogs.servingConfigs.html
+++ b/docs/dyn/retail_v2beta.projects.locations.catalogs.servingConfigs.html
@@ -626,6 +626,184 @@ 
Method Details

       "A String",
     ],
     "pageViewId": "A String", # A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
+    "panels": [ # Optional. List of panels associated with this event. Used for panel-level impression data.
+      { # Detailed panel information associated with a user event.
+        "attributionToken": "A String", # Optional. The attribution token of the panel.
+        "displayName": "A String", # Optional. The display name of the panel.
+        "panelId": "A String", # Required. The panel ID.
+        "panelPosition": 42, # Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.
+        "productDetails": [ # Optional. The product details associated with the panel.
+          { # Detailed product information associated with a user event.
+            "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
+              "attributes": { # Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here. Features that can take on one of a limited number of possible values. Two types of features can be set are: Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer. For example: `{ "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": {"numbers":[2.3, 15.4]}, "heights_cm": {"numbers":[8.1, 6.4]} }`. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * Max entries count: 200. * The key must be a UTF-8 encoded string with a length limit of 128 characters. * For indexable attribute, the key must match the pattern: `a-zA-Z0-9*`. For example, `key0LikeThis` or `KEY_1_LIKE_THIS`. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed.
+                "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                  "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                  "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                    3.14,
+                  ],
+                  "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                  "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                },
+              },
+              "audience": { # An intended audience of the Product for whom it's sold. # The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product.
+                "ageGroups": [ # The age groups of the audience. Strongly encouraged to use the standard values: "newborn" (up to 3 months old), "infant" (3–12 months old), "toddler" (1–5 years old), "kids" (5–13 years old), "adult" (typically teens or older). At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [age_group](https://support.google.com/merchants/answer/6324463). Schema.org property [Product.audience.suggestedMinAge](https://schema.org/suggestedMinAge) and [Product.audience.suggestedMaxAge](https://schema.org/suggestedMaxAge).
+                  "A String",
+                ],
+                "genders": [ # The genders of the audience. Strongly encouraged to use the standard values: "male", "female", "unisex". At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [gender](https://support.google.com/merchants/answer/6324479). Schema.org property [Product.audience.suggestedGender](https://schema.org/suggestedGender).
+                  "A String",
+                ],
+              },
+              "availability": "A String", # The online availability of the Product. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+              "availableQuantity": 42, # The available quantity of the item.
+              "availableTime": "A String", # The timestamp when this Product becomes available for SearchService.Search. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT.
+              "brands": [ # The brands of the product. A maximum of 30 brands are allowed unless overridden through the Google Cloud console. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [brand](https://support.google.com/merchants/answer/6324351). Schema.org property [Product.brand](https://schema.org/brand).
+                "A String",
+              ],
+              "categories": [ # Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as: "categories": [ "Shoes & Accessories > Shoes", "Sports & Fitness > Athletic Clothing > Shoes" ] Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned. At most 250 values are allowed per Product unless overridden through the Google Cloud console. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property google_product_category. Schema.org property [Product.category] (https://schema.org/category). [mc_google_product_category]: https://support.google.com/merchants/answer/6324436
+                "A String",
+              ],
+              "collectionMemberIds": [ # The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.
+                "A String",
+              ],
+              "colorInfo": { # The color information of a Product. # The color of the product. Corresponding properties: Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                "colorFamilies": [ # The standard color families. Strongly recommended to use the following standard color groups: "Red", "Pink", "Orange", "Yellow", "Purple", "Green", "Cyan", "Blue", "Brown", "White", "Gray", "Black" and "Mixed". Normally it is expected to have only 1 color family. May consider using single "Mixed" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.
+                  "A String",
+                ],
+                "colors": [ # The color display names, which may be different from standard color family names, such as the color aliases used in the website frontend. Normally it is expected to have only 1 color. May consider using single "Mixed" instead of multiple values. A maximum of 75 colors are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                  "A String",
+                ],
+              },
+              "conditions": [ # The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used". A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [condition](https://support.google.com/merchants/answer/6324469). Schema.org property [Offer.itemCondition](https://schema.org/itemCondition).
+                "A String",
+              ],
+              "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
+              "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+              "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
+                { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
+                  "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                  "type": "A String", # The fulfillment type, including commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned.
+                },
+              ],
+              "gtin": "A String", # The Global Trade Item Number (GTIN) of the product. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [gtin](https://support.google.com/merchants/answer/6324461). Schema.org property [Product.isbn](https://schema.org/isbn), [Product.gtin8](https://schema.org/gtin8), [Product.gtin12](https://schema.org/gtin12), [Product.gtin13](https://schema.org/gtin13), or [Product.gtin14](https://schema.org/gtin14). If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.
+              "id": "A String", # Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1`. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [id](https://support.google.com/merchants/answer/6324405). Schema.org property [Product.sku](https://schema.org/sku).
+              "images": [ # Product images for the product. We highly recommend putting the main image first. A maximum of 300 images are allowed. Corresponding properties: Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                { # Product image. Recommendations AI and Retail Search use product images to improve prediction and search results. Product images can be returned in results, and are shown in prediction or search previews in the console. Please try to provide correct product images and avoid using images with size too small.
+                  "height": 42, # Height of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "uri": "A String", # Required. URI of the image. This field must be a valid UTF-8 encoded URI with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                  "width": 42, # Width of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                },
+              ],
+              "languageCode": "A String", # Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance. For product search this field is in use. It defaults to "en-US" if unset.
+              "localInventories": [ # Output only. A list of local inventories specific to different places. This field can be managed by ProductService.AddLocalInventories and ProductService.RemoveLocalInventories APIs if fine-grained, high-volume updates are necessary.
+                { # The inventory information at a place (e.g. a store) identified by a place ID.
+                  "attributes": { # Optional. Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.
+                    "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                      "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                      "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                        3.14,
+                      ],
+                      "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                      "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                        "A String",
+                      ],
+                    },
+                  },
+                  "fulfillmentTypes": [ # Optional. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.
+                    "A String",
+                  ],
+                  "placeId": "A String", # Optional. The place ID for the current set of inventory information.
+                  "priceInfo": { # The price information of a Product. # Optional. Product price and cost information. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                    "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                    "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                    "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                    "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                    "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                    "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                    "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                      "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                        "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                        "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                        "maximum": 3.14, # Inclusive upper bound.
+                        "minimum": 3.14, # Inclusive lower bound.
+                      },
+                      "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                        "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                        "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                        "maximum": 3.14, # Inclusive upper bound.
+                        "minimum": 3.14, # Inclusive lower bound.
+                      },
+                    },
+                  },
+                },
+              ],
+              "materials": [ # The material of the product. For example, "leather", "wooden". A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [material](https://support.google.com/merchants/answer/6324410). Schema.org property [Product.material](https://schema.org/material).
+                "A String",
+              ],
+              "name": "A String", # Immutable. Full resource name of the product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id`.
+              "patterns": [ # The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [pattern](https://support.google.com/merchants/answer/6324483). Schema.org property [Product.pattern](https://schema.org/pattern).
+                "A String",
+              ],
+              "priceInfo": { # The price information of a Product. # Product price and cost information. Corresponding properties: Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                  "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                    "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                    "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                    "maximum": 3.14, # Inclusive upper bound.
+                    "minimum": 3.14, # Inclusive lower bound.
+                  },
+                  "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                    "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                    "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                    "maximum": 3.14, # Inclusive upper bound.
+                    "minimum": 3.14, # Inclusive lower bound.
+                  },
+                },
+              },
+              "primaryProductId": "A String", # Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown. For Type.PRIMARY Products, this field can only be empty or set to the same value as id. For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [item_group_id](https://support.google.com/merchants/answer/6324507). Schema.org property [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID).
+              "promotions": [ # The promotions applied to the product. A maximum of 10 values are allowed per Product. Only Promotion.promotion_id will be used, other fields will be ignored if set.
+                { # Promotion specification.
+                  "promotionId": "A String", # Promotion identifier, which is the final component of name. For example, this field is "free_gift", if name is `projects/*/locations/global/catalogs/default_catalog/promotions/free_gift`. The value must be a UTF-8 encoded string with a length limit of 128 characters, and match the pattern: `a-zA-Z*`. For example, id0LikeThis or ID_1_LIKE_THIS. Otherwise, an INVALID_ARGUMENT error is returned. Corresponds to Google Merchant Center property [promotion_id](https://support.google.com/merchants/answer/7050148).
+                },
+              ],
+              "publishTime": "A String", # The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.
+              "rating": { # The rating of a Product. # The rating of this product.
+                "averageRating": 3.14, # The average rating of the Product. The rating is scaled at 1-5. Otherwise, an INVALID_ARGUMENT error is returned.
+                "ratingCount": 42, # The total number of ratings. This value is independent of the value of rating_histogram. This value must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                "ratingHistogram": [ # List of rating counts per rating value (index = rating - 1). The list is empty if there is no rating. If the list is non-empty, its size is always 5. Otherwise, an INVALID_ARGUMENT error is returned. For example, [41, 14, 13, 47, 303]. It means that the Product got 41 ratings with 1 star, 14 ratings with 2 star, and so on.
+                  42,
+                ],
+              },
+              "retrievableFields": "A String", # Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
+              "sizes": [ # The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value]. For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [size](https://support.google.com/merchants/answer/6324492), [size_type](https://support.google.com/merchants/answer/6324497), and [size_system](https://support.google.com/merchants/answer/6324502). Schema.org property [Product.size](https://schema.org/size).
+                "A String",
+              ],
+              "tags": [ # Custom tags associated with the product. At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter. Corresponding properties: Google Merchant Center property [custom_label_0–4](https://support.google.com/merchants/answer/6324473).
+                "A String",
+              ],
+              "title": "A String", # Required. Product title. This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [title](https://support.google.com/merchants/answer/6324415). Schema.org property [Product.name](https://schema.org/name).
+              "ttl": "A String", # Input only. The TTL (time to live) of the product. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. If it is set, it must be a non-negative value, and expire_time is set as current timestamp plus ttl. The derived expire_time is returned in the output and ttl is left blank when retrieving the Product. If it is set, the product is not available for SearchService.Search after current timestamp plus ttl. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts.
+              "type": "A String", # Immutable. The type of the product. Default to Catalog.product_level_config.ingestion_product_type if unset.
+              "uri": "A String", # Canonical URL directly linking to the product detail page. It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [link](https://support.google.com/merchants/answer/6324416). Schema.org property [Offer.url](https://schema.org/url).
+              "variants": [ # Output only. Product variants grouped together on primary product which share similar product attributes. It's automatically grouped by primary_product_id for all the product variants. Only populated for Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                # Object with schema name: GoogleCloudRetailV2betaProduct
+              ],
+            },
+            "quantity": 42, # Quantity of the product associated with the user event. For example, this field will be 2 if two products are added to the shopping cart for `purchase-complete` event. Required for `add-to-cart` and `purchase-complete` event types.
+          },
+        ],
+        "totalPanels": 42, # Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.
+      },
+    ],
     "productDetails": [ # The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.
       { # Detailed product information associated with a user event.
         "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
diff --git a/docs/dyn/retail_v2beta.projects.locations.catalogs.userEvents.html b/docs/dyn/retail_v2beta.projects.locations.catalogs.userEvents.html
index 5ce11f03e0e..819cadc6c45 100644
--- a/docs/dyn/retail_v2beta.projects.locations.catalogs.userEvents.html
+++ b/docs/dyn/retail_v2beta.projects.locations.catalogs.userEvents.html
@@ -256,6 +256,184 @@ 
Method Details

             "A String",
           ],
           "pageViewId": "A String", # A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
+          "panels": [ # Optional. List of panels associated with this event. Used for panel-level impression data.
+            { # Detailed panel information associated with a user event.
+              "attributionToken": "A String", # Optional. The attribution token of the panel.
+              "displayName": "A String", # Optional. The display name of the panel.
+              "panelId": "A String", # Required. The panel ID.
+              "panelPosition": 42, # Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.
+              "productDetails": [ # Optional. The product details associated with the panel.
+                { # Detailed product information associated with a user event.
+                  "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
+                    "attributes": { # Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here. Features that can take on one of a limited number of possible values. Two types of features can be set are: Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer. For example: `{ "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": {"numbers":[2.3, 15.4]}, "heights_cm": {"numbers":[8.1, 6.4]} }`. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * Max entries count: 200. * The key must be a UTF-8 encoded string with a length limit of 128 characters. * For indexable attribute, the key must match the pattern: `a-zA-Z0-9*`. For example, `key0LikeThis` or `KEY_1_LIKE_THIS`. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed.
+                      "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                        "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                        "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                          3.14,
+                        ],
+                        "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                        "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                          "A String",
+                        ],
+                      },
+                    },
+                    "audience": { # An intended audience of the Product for whom it's sold. # The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product.
+                      "ageGroups": [ # The age groups of the audience. Strongly encouraged to use the standard values: "newborn" (up to 3 months old), "infant" (3–12 months old), "toddler" (1–5 years old), "kids" (5–13 years old), "adult" (typically teens or older). At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [age_group](https://support.google.com/merchants/answer/6324463). Schema.org property [Product.audience.suggestedMinAge](https://schema.org/suggestedMinAge) and [Product.audience.suggestedMaxAge](https://schema.org/suggestedMaxAge).
+                        "A String",
+                      ],
+                      "genders": [ # The genders of the audience. Strongly encouraged to use the standard values: "male", "female", "unisex". At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [gender](https://support.google.com/merchants/answer/6324479). Schema.org property [Product.audience.suggestedGender](https://schema.org/suggestedGender).
+                        "A String",
+                      ],
+                    },
+                    "availability": "A String", # The online availability of the Product. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+                    "availableQuantity": 42, # The available quantity of the item.
+                    "availableTime": "A String", # The timestamp when this Product becomes available for SearchService.Search. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT.
+                    "brands": [ # The brands of the product. A maximum of 30 brands are allowed unless overridden through the Google Cloud console. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [brand](https://support.google.com/merchants/answer/6324351). Schema.org property [Product.brand](https://schema.org/brand).
+                      "A String",
+                    ],
+                    "categories": [ # Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as: "categories": [ "Shoes & Accessories > Shoes", "Sports & Fitness > Athletic Clothing > Shoes" ] Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned. At most 250 values are allowed per Product unless overridden through the Google Cloud console. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property google_product_category. Schema.org property [Product.category] (https://schema.org/category). [mc_google_product_category]: https://support.google.com/merchants/answer/6324436
+                      "A String",
+                    ],
+                    "collectionMemberIds": [ # The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.
+                      "A String",
+                    ],
+                    "colorInfo": { # The color information of a Product. # The color of the product. Corresponding properties: Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                      "colorFamilies": [ # The standard color families. Strongly recommended to use the following standard color groups: "Red", "Pink", "Orange", "Yellow", "Purple", "Green", "Cyan", "Blue", "Brown", "White", "Gray", "Black" and "Mixed". Normally it is expected to have only 1 color family. May consider using single "Mixed" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.
+                        "A String",
+                      ],
+                      "colors": [ # The color display names, which may be different from standard color family names, such as the color aliases used in the website frontend. Normally it is expected to have only 1 color. May consider using single "Mixed" instead of multiple values. A maximum of 75 colors are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                        "A String",
+                      ],
+                    },
+                    "conditions": [ # The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used". A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [condition](https://support.google.com/merchants/answer/6324469). Schema.org property [Offer.itemCondition](https://schema.org/itemCondition).
+                      "A String",
+                    ],
+                    "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
+                    "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+                    "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
+                      { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
+                        "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
+                          "A String",
+                        ],
+                        "type": "A String", # The fulfillment type, including commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned.
+                      },
+                    ],
+                    "gtin": "A String", # The Global Trade Item Number (GTIN) of the product. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [gtin](https://support.google.com/merchants/answer/6324461). Schema.org property [Product.isbn](https://schema.org/isbn), [Product.gtin8](https://schema.org/gtin8), [Product.gtin12](https://schema.org/gtin12), [Product.gtin13](https://schema.org/gtin13), or [Product.gtin14](https://schema.org/gtin14). If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.
+                    "id": "A String", # Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1`. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [id](https://support.google.com/merchants/answer/6324405). Schema.org property [Product.sku](https://schema.org/sku).
+                    "images": [ # Product images for the product. We highly recommend putting the main image first. A maximum of 300 images are allowed. Corresponding properties: Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                      { # Product image. Recommendations AI and Retail Search use product images to improve prediction and search results. Product images can be returned in results, and are shown in prediction or search previews in the console. Please try to provide correct product images and avoid using images with size too small.
+                        "height": 42, # Height of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                        "uri": "A String", # Required. URI of the image. This field must be a valid UTF-8 encoded URI with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                        "width": 42, # Width of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                      },
+                    ],
+                    "languageCode": "A String", # Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance. For product search this field is in use. It defaults to "en-US" if unset.
+                    "localInventories": [ # Output only. A list of local inventories specific to different places. This field can be managed by ProductService.AddLocalInventories and ProductService.RemoveLocalInventories APIs if fine-grained, high-volume updates are necessary.
+                      { # The inventory information at a place (e.g. a store) identified by a place ID.
+                        "attributes": { # Optional. Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.
+                          "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                            "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                            "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                              3.14,
+                            ],
+                            "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                            "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                              "A String",
+                            ],
+                          },
+                        },
+                        "fulfillmentTypes": [ # Optional. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.
+                          "A String",
+                        ],
+                        "placeId": "A String", # Optional. The place ID for the current set of inventory information.
+                        "priceInfo": { # The price information of a Product. # Optional. Product price and cost information. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                          "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                          "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                          "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                          "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                          "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                          "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                          "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                            "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                              "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                              "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                              "maximum": 3.14, # Inclusive upper bound.
+                              "minimum": 3.14, # Inclusive lower bound.
+                            },
+                            "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                              "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                              "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                              "maximum": 3.14, # Inclusive upper bound.
+                              "minimum": 3.14, # Inclusive lower bound.
+                            },
+                          },
+                        },
+                      },
+                    ],
+                    "materials": [ # The material of the product. For example, "leather", "wooden". A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [material](https://support.google.com/merchants/answer/6324410). Schema.org property [Product.material](https://schema.org/material).
+                      "A String",
+                    ],
+                    "name": "A String", # Immutable. Full resource name of the product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id`.
+                    "patterns": [ # The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [pattern](https://support.google.com/merchants/answer/6324483). Schema.org property [Product.pattern](https://schema.org/pattern).
+                      "A String",
+                    ],
+                    "priceInfo": { # The price information of a Product. # Product price and cost information. Corresponding properties: Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                      "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                      "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                      "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                      "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                      "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                      "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                      "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                        "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                          "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                          "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                          "maximum": 3.14, # Inclusive upper bound.
+                          "minimum": 3.14, # Inclusive lower bound.
+                        },
+                        "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                          "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                          "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                          "maximum": 3.14, # Inclusive upper bound.
+                          "minimum": 3.14, # Inclusive lower bound.
+                        },
+                      },
+                    },
+                    "primaryProductId": "A String", # Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown. For Type.PRIMARY Products, this field can only be empty or set to the same value as id. For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [item_group_id](https://support.google.com/merchants/answer/6324507). Schema.org property [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID).
+                    "promotions": [ # The promotions applied to the product. A maximum of 10 values are allowed per Product. Only Promotion.promotion_id will be used, other fields will be ignored if set.
+                      { # Promotion specification.
+                        "promotionId": "A String", # Promotion identifier, which is the final component of name. For example, this field is "free_gift", if name is `projects/*/locations/global/catalogs/default_catalog/promotions/free_gift`. The value must be a UTF-8 encoded string with a length limit of 128 characters, and match the pattern: `a-zA-Z*`. For example, id0LikeThis or ID_1_LIKE_THIS. Otherwise, an INVALID_ARGUMENT error is returned. Corresponds to Google Merchant Center property [promotion_id](https://support.google.com/merchants/answer/7050148).
+                      },
+                    ],
+                    "publishTime": "A String", # The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.
+                    "rating": { # The rating of a Product. # The rating of this product.
+                      "averageRating": 3.14, # The average rating of the Product. The rating is scaled at 1-5. Otherwise, an INVALID_ARGUMENT error is returned.
+                      "ratingCount": 42, # The total number of ratings. This value is independent of the value of rating_histogram. This value must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                      "ratingHistogram": [ # List of rating counts per rating value (index = rating - 1). The list is empty if there is no rating. If the list is non-empty, its size is always 5. Otherwise, an INVALID_ARGUMENT error is returned. For example, [41, 14, 13, 47, 303]. It means that the Product got 41 ratings with 1 star, 14 ratings with 2 star, and so on.
+                        42,
+                      ],
+                    },
+                    "retrievableFields": "A String", # Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
+                    "sizes": [ # The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value]. For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [size](https://support.google.com/merchants/answer/6324492), [size_type](https://support.google.com/merchants/answer/6324497), and [size_system](https://support.google.com/merchants/answer/6324502). Schema.org property [Product.size](https://schema.org/size).
+                      "A String",
+                    ],
+                    "tags": [ # Custom tags associated with the product. At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter. Corresponding properties: Google Merchant Center property [custom_label_0–4](https://support.google.com/merchants/answer/6324473).
+                      "A String",
+                    ],
+                    "title": "A String", # Required. Product title. This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [title](https://support.google.com/merchants/answer/6324415). Schema.org property [Product.name](https://schema.org/name).
+                    "ttl": "A String", # Input only. The TTL (time to live) of the product. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. If it is set, it must be a non-negative value, and expire_time is set as current timestamp plus ttl. The derived expire_time is returned in the output and ttl is left blank when retrieving the Product. If it is set, the product is not available for SearchService.Search after current timestamp plus ttl. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts.
+                    "type": "A String", # Immutable. The type of the product. Default to Catalog.product_level_config.ingestion_product_type if unset.
+                    "uri": "A String", # Canonical URL directly linking to the product detail page. It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [link](https://support.google.com/merchants/answer/6324416). Schema.org property [Offer.url](https://schema.org/url).
+                    "variants": [ # Output only. Product variants grouped together on primary product which share similar product attributes. It's automatically grouped by primary_product_id for all the product variants. Only populated for Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                      # Object with schema name: GoogleCloudRetailV2betaProduct
+                    ],
+                  },
+                  "quantity": 42, # Quantity of the product associated with the user event. For example, this field will be 2 if two products are added to the shopping cart for `purchase-complete` event. Required for `add-to-cart` and `purchase-complete` event types.
+                },
+              ],
+              "totalPanels": 42, # Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.
+            },
+          ],
           "productDetails": [ # The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.
             { # Detailed product information associated with a user event.
               "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
@@ -605,6 +783,184 @@ 
Method Details

     "A String",
   ],
   "pageViewId": "A String", # A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
+  "panels": [ # Optional. List of panels associated with this event. Used for panel-level impression data.
+    { # Detailed panel information associated with a user event.
+      "attributionToken": "A String", # Optional. The attribution token of the panel.
+      "displayName": "A String", # Optional. The display name of the panel.
+      "panelId": "A String", # Required. The panel ID.
+      "panelPosition": 42, # Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.
+      "productDetails": [ # Optional. The product details associated with the panel.
+        { # Detailed product information associated with a user event.
+          "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
+            "attributes": { # Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here. Features that can take on one of a limited number of possible values. Two types of features can be set are: Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer. For example: `{ "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": {"numbers":[2.3, 15.4]}, "heights_cm": {"numbers":[8.1, 6.4]} }`. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * Max entries count: 200. * The key must be a UTF-8 encoded string with a length limit of 128 characters. * For indexable attribute, the key must match the pattern: `a-zA-Z0-9*`. For example, `key0LikeThis` or `KEY_1_LIKE_THIS`. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed.
+              "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                  3.14,
+                ],
+                "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+              },
+            },
+            "audience": { # An intended audience of the Product for whom it's sold. # The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product.
+              "ageGroups": [ # The age groups of the audience. Strongly encouraged to use the standard values: "newborn" (up to 3 months old), "infant" (3–12 months old), "toddler" (1–5 years old), "kids" (5–13 years old), "adult" (typically teens or older). At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [age_group](https://support.google.com/merchants/answer/6324463). Schema.org property [Product.audience.suggestedMinAge](https://schema.org/suggestedMinAge) and [Product.audience.suggestedMaxAge](https://schema.org/suggestedMaxAge).
+                "A String",
+              ],
+              "genders": [ # The genders of the audience. Strongly encouraged to use the standard values: "male", "female", "unisex". At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [gender](https://support.google.com/merchants/answer/6324479). Schema.org property [Product.audience.suggestedGender](https://schema.org/suggestedGender).
+                "A String",
+              ],
+            },
+            "availability": "A String", # The online availability of the Product. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+            "availableQuantity": 42, # The available quantity of the item.
+            "availableTime": "A String", # The timestamp when this Product becomes available for SearchService.Search. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT.
+            "brands": [ # The brands of the product. A maximum of 30 brands are allowed unless overridden through the Google Cloud console. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [brand](https://support.google.com/merchants/answer/6324351). Schema.org property [Product.brand](https://schema.org/brand).
+              "A String",
+            ],
+            "categories": [ # Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as: "categories": [ "Shoes & Accessories > Shoes", "Sports & Fitness > Athletic Clothing > Shoes" ] Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned. At most 250 values are allowed per Product unless overridden through the Google Cloud console. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property google_product_category. Schema.org property [Product.category] (https://schema.org/category). [mc_google_product_category]: https://support.google.com/merchants/answer/6324436
+              "A String",
+            ],
+            "collectionMemberIds": [ # The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.
+              "A String",
+            ],
+            "colorInfo": { # The color information of a Product. # The color of the product. Corresponding properties: Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+              "colorFamilies": [ # The standard color families. Strongly recommended to use the following standard color groups: "Red", "Pink", "Orange", "Yellow", "Purple", "Green", "Cyan", "Blue", "Brown", "White", "Gray", "Black" and "Mixed". Normally it is expected to have only 1 color family. May consider using single "Mixed" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.
+                "A String",
+              ],
+              "colors": [ # The color display names, which may be different from standard color family names, such as the color aliases used in the website frontend. Normally it is expected to have only 1 color. May consider using single "Mixed" instead of multiple values. A maximum of 75 colors are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                "A String",
+              ],
+            },
+            "conditions": [ # The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used". A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [condition](https://support.google.com/merchants/answer/6324469). Schema.org property [Offer.itemCondition](https://schema.org/itemCondition).
+              "A String",
+            ],
+            "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
+            "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+            "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
+              { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
+                "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+                "type": "A String", # The fulfillment type, including commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned.
+              },
+            ],
+            "gtin": "A String", # The Global Trade Item Number (GTIN) of the product. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [gtin](https://support.google.com/merchants/answer/6324461). Schema.org property [Product.isbn](https://schema.org/isbn), [Product.gtin8](https://schema.org/gtin8), [Product.gtin12](https://schema.org/gtin12), [Product.gtin13](https://schema.org/gtin13), or [Product.gtin14](https://schema.org/gtin14). If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.
+            "id": "A String", # Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1`. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [id](https://support.google.com/merchants/answer/6324405). Schema.org property [Product.sku](https://schema.org/sku).
+            "images": [ # Product images for the product. We highly recommend putting the main image first. A maximum of 300 images are allowed. Corresponding properties: Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+              { # Product image. Recommendations AI and Retail Search use product images to improve prediction and search results. Product images can be returned in results, and are shown in prediction or search previews in the console. Please try to provide correct product images and avoid using images with size too small.
+                "height": 42, # Height of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                "uri": "A String", # Required. URI of the image. This field must be a valid UTF-8 encoded URI with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                "width": 42, # Width of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+              },
+            ],
+            "languageCode": "A String", # Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance. For product search this field is in use. It defaults to "en-US" if unset.
+            "localInventories": [ # Output only. A list of local inventories specific to different places. This field can be managed by ProductService.AddLocalInventories and ProductService.RemoveLocalInventories APIs if fine-grained, high-volume updates are necessary.
+              { # The inventory information at a place (e.g. a store) identified by a place ID.
+                "attributes": { # Optional. Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.
+                  "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                    "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                    "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                      3.14,
+                    ],
+                    "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                    "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                      "A String",
+                    ],
+                  },
+                },
+                "fulfillmentTypes": [ # Optional. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+                "placeId": "A String", # Optional. The place ID for the current set of inventory information.
+                "priceInfo": { # The price information of a Product. # Optional. Product price and cost information. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                  "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                  "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                  "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                  "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                  "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                  "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                  "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                    "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                      "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                      "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                      "maximum": 3.14, # Inclusive upper bound.
+                      "minimum": 3.14, # Inclusive lower bound.
+                    },
+                    "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                      "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                      "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                      "maximum": 3.14, # Inclusive upper bound.
+                      "minimum": 3.14, # Inclusive lower bound.
+                    },
+                  },
+                },
+              },
+            ],
+            "materials": [ # The material of the product. For example, "leather", "wooden". A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [material](https://support.google.com/merchants/answer/6324410). Schema.org property [Product.material](https://schema.org/material).
+              "A String",
+            ],
+            "name": "A String", # Immutable. Full resource name of the product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id`.
+            "patterns": [ # The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [pattern](https://support.google.com/merchants/answer/6324483). Schema.org property [Product.pattern](https://schema.org/pattern).
+              "A String",
+            ],
+            "priceInfo": { # The price information of a Product. # Product price and cost information. Corresponding properties: Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+              "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+              "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+              "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+              "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+              "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+              "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+              "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                  "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                  "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                  "maximum": 3.14, # Inclusive upper bound.
+                  "minimum": 3.14, # Inclusive lower bound.
+                },
+                "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                  "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                  "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                  "maximum": 3.14, # Inclusive upper bound.
+                  "minimum": 3.14, # Inclusive lower bound.
+                },
+              },
+            },
+            "primaryProductId": "A String", # Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown. For Type.PRIMARY Products, this field can only be empty or set to the same value as id. For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [item_group_id](https://support.google.com/merchants/answer/6324507). Schema.org property [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID).
+            "promotions": [ # The promotions applied to the product. A maximum of 10 values are allowed per Product. Only Promotion.promotion_id will be used, other fields will be ignored if set.
+              { # Promotion specification.
+                "promotionId": "A String", # Promotion identifier, which is the final component of name. For example, this field is "free_gift", if name is `projects/*/locations/global/catalogs/default_catalog/promotions/free_gift`. The value must be a UTF-8 encoded string with a length limit of 128 characters, and match the pattern: `a-zA-Z*`. For example, id0LikeThis or ID_1_LIKE_THIS. Otherwise, an INVALID_ARGUMENT error is returned. Corresponds to Google Merchant Center property [promotion_id](https://support.google.com/merchants/answer/7050148).
+              },
+            ],
+            "publishTime": "A String", # The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.
+            "rating": { # The rating of a Product. # The rating of this product.
+              "averageRating": 3.14, # The average rating of the Product. The rating is scaled at 1-5. Otherwise, an INVALID_ARGUMENT error is returned.
+              "ratingCount": 42, # The total number of ratings. This value is independent of the value of rating_histogram. This value must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+              "ratingHistogram": [ # List of rating counts per rating value (index = rating - 1). The list is empty if there is no rating. If the list is non-empty, its size is always 5. Otherwise, an INVALID_ARGUMENT error is returned. For example, [41, 14, 13, 47, 303]. It means that the Product got 41 ratings with 1 star, 14 ratings with 2 star, and so on.
+                42,
+              ],
+            },
+            "retrievableFields": "A String", # Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
+            "sizes": [ # The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value]. For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [size](https://support.google.com/merchants/answer/6324492), [size_type](https://support.google.com/merchants/answer/6324497), and [size_system](https://support.google.com/merchants/answer/6324502). Schema.org property [Product.size](https://schema.org/size).
+              "A String",
+            ],
+            "tags": [ # Custom tags associated with the product. At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter. Corresponding properties: Google Merchant Center property [custom_label_0–4](https://support.google.com/merchants/answer/6324473).
+              "A String",
+            ],
+            "title": "A String", # Required. Product title. This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [title](https://support.google.com/merchants/answer/6324415). Schema.org property [Product.name](https://schema.org/name).
+            "ttl": "A String", # Input only. The TTL (time to live) of the product. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. If it is set, it must be a non-negative value, and expire_time is set as current timestamp plus ttl. The derived expire_time is returned in the output and ttl is left blank when retrieving the Product. If it is set, the product is not available for SearchService.Search after current timestamp plus ttl. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts.
+            "type": "A String", # Immutable. The type of the product. Default to Catalog.product_level_config.ingestion_product_type if unset.
+            "uri": "A String", # Canonical URL directly linking to the product detail page. It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [link](https://support.google.com/merchants/answer/6324416). Schema.org property [Offer.url](https://schema.org/url).
+            "variants": [ # Output only. Product variants grouped together on primary product which share similar product attributes. It's automatically grouped by primary_product_id for all the product variants. Only populated for Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+              # Object with schema name: GoogleCloudRetailV2betaProduct
+            ],
+          },
+          "quantity": 42, # Quantity of the product associated with the user event. For example, this field will be 2 if two products are added to the shopping cart for `purchase-complete` event. Required for `add-to-cart` and `purchase-complete` event types.
+        },
+      ],
+      "totalPanels": 42, # Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.
+    },
+  ],
   "productDetails": [ # The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.
     { # Detailed product information associated with a user event.
       "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
@@ -836,6 +1192,184 @@ 
Method Details

     "A String",
   ],
   "pageViewId": "A String", # A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.
+  "panels": [ # Optional. List of panels associated with this event. Used for panel-level impression data.
+    { # Detailed panel information associated with a user event.
+      "attributionToken": "A String", # Optional. The attribution token of the panel.
+      "displayName": "A String", # Optional. The display name of the panel.
+      "panelId": "A String", # Required. The panel ID.
+      "panelPosition": 42, # Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.
+      "productDetails": [ # Optional. The product details associated with the panel.
+        { # Detailed product information associated with a user event.
+          "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
+            "attributes": { # Highly encouraged. Extra product attributes to be included. For example, for products, this could include the store name, vendor, style, color, etc. These are very strong signals for recommendation model, thus we highly recommend providing the attributes here. Features that can take on one of a limited number of possible values. Two types of features can be set are: Textual features. some examples would be the brand/maker of a product, or country of a customer. Numerical features. Some examples would be the height/weight of a product, or age of a customer. For example: `{ "vendor": {"text": ["vendor123", "vendor456"]}, "lengths_cm": {"numbers":[2.3, 15.4]}, "heights_cm": {"numbers":[8.1, 6.4]} }`. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * Max entries count: 200. * The key must be a UTF-8 encoded string with a length limit of 128 characters. * For indexable attribute, the key must match the pattern: `a-zA-Z0-9*`. For example, `key0LikeThis` or `KEY_1_LIKE_THIS`. * For text attributes, at most 400 values are allowed. Empty values are not allowed. Each value must be a non-empty UTF-8 encoded string with a length limit of 256 characters. * For number attributes, at most 400 values are allowed.
+              "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                  3.14,
+                ],
+                "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+              },
+            },
+            "audience": { # An intended audience of the Product for whom it's sold. # The target group associated with a given audience (e.g. male, veterans, car owners, musicians, etc.) of the product.
+              "ageGroups": [ # The age groups of the audience. Strongly encouraged to use the standard values: "newborn" (up to 3 months old), "infant" (3–12 months old), "toddler" (1–5 years old), "kids" (5–13 years old), "adult" (typically teens or older). At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [age_group](https://support.google.com/merchants/answer/6324463). Schema.org property [Product.audience.suggestedMinAge](https://schema.org/suggestedMinAge) and [Product.audience.suggestedMaxAge](https://schema.org/suggestedMaxAge).
+                "A String",
+              ],
+              "genders": [ # The genders of the audience. Strongly encouraged to use the standard values: "male", "female", "unisex". At most 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [gender](https://support.google.com/merchants/answer/6324479). Schema.org property [Product.audience.suggestedGender](https://schema.org/suggestedGender).
+                "A String",
+              ],
+            },
+            "availability": "A String", # The online availability of the Product. Default to Availability.IN_STOCK. For primary products with variants set the availability of the primary as Availability.OUT_OF_STOCK and set the true availability at the variant level. This way the primary product will be considered "in stock" as long as it has at least one variant in stock. For primary products with no variants set the true availability at the primary level. Corresponding properties: Google Merchant Center property [availability](https://support.google.com/merchants/answer/6324448). Schema.org property [Offer.availability](https://schema.org/availability).
+            "availableQuantity": 42, # The available quantity of the item.
+            "availableTime": "A String", # The timestamp when this Product becomes available for SearchService.Search. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT.
+            "brands": [ # The brands of the product. A maximum of 30 brands are allowed unless overridden through the Google Cloud console. Each brand must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [brand](https://support.google.com/merchants/answer/6324351). Schema.org property [Product.brand](https://schema.org/brand).
+              "A String",
+            ],
+            "categories": [ # Product categories. This field is repeated for supporting one product belonging to several parallel categories. Strongly recommended using the full path for better search / recommendation quality. To represent full path of category, use '>' sign to separate different hierarchies. If '>' is part of the category name, replace it with other character(s). For example, if a shoes product belongs to both ["Shoes & Accessories" -> "Shoes"] and ["Sports & Fitness" -> "Athletic Clothing" -> "Shoes"], it could be represented as: "categories": [ "Shoes & Accessories > Shoes", "Sports & Fitness > Athletic Clothing > Shoes" ] Must be set for Type.PRIMARY Product otherwise an INVALID_ARGUMENT error is returned. At most 250 values are allowed per Product unless overridden through the Google Cloud console. Empty values are not allowed. Each value must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property google_product_category. Schema.org property [Product.category] (https://schema.org/category). [mc_google_product_category]: https://support.google.com/merchants/answer/6324436
+              "A String",
+            ],
+            "collectionMemberIds": [ # The id of the collection members when type is Type.COLLECTION. Non-existent product ids are allowed. The type of the members must be either Type.PRIMARY or Type.VARIANT otherwise an INVALID_ARGUMENT error is thrown. Should not set it for other types. A maximum of 1000 values are allowed. Otherwise, an INVALID_ARGUMENT error is return.
+              "A String",
+            ],
+            "colorInfo": { # The color information of a Product. # The color of the product. Corresponding properties: Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+              "colorFamilies": [ # The standard color families. Strongly recommended to use the following standard color groups: "Red", "Pink", "Orange", "Yellow", "Purple", "Green", "Cyan", "Blue", "Brown", "White", "Gray", "Black" and "Mixed". Normally it is expected to have only 1 color family. May consider using single "Mixed" instead of multiple values. A maximum of 5 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color). The colorFamilies field as a system attribute is not a required field but strongly recommended to be specified. Google Search models treat this field as more important than a custom product attribute when specified.
+                "A String",
+              ],
+              "colors": [ # The color display names, which may be different from standard color family names, such as the color aliases used in the website frontend. Normally it is expected to have only 1 color. May consider using single "Mixed" instead of multiple values. A maximum of 75 colors are allowed. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [color](https://support.google.com/merchants/answer/6324487). Schema.org property [Product.color](https://schema.org/color).
+                "A String",
+              ],
+            },
+            "conditions": [ # The condition of the product. Strongly encouraged to use the standard values: "new", "refurbished", "used". A maximum of 1 value is allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [condition](https://support.google.com/merchants/answer/6324469). Schema.org property [Offer.itemCondition](https://schema.org/itemCondition).
+              "A String",
+            ],
+            "description": "A String", # Product description. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [description](https://support.google.com/merchants/answer/6324468). Schema.org property [Product.description](https://schema.org/description).
+            "expireTime": "A String", # Note that this field is applied in the following ways: * If the Product is already expired when it is uploaded, this product is not indexed for search. * If the Product is not expired when it is uploaded, only the Type.PRIMARY's and Type.COLLECTION's expireTime is respected, and Type.VARIANT's expireTime is not used. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. expire_time must be later than available_time and publish_time, otherwise an INVALID_ARGUMENT error is thrown. Corresponding properties: Google Merchant Center property [expiration_date](https://support.google.com/merchants/answer/6324499).
+            "fulfillmentInfo": [ # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods. All the elements must have distinct FulfillmentInfo.type. Otherwise, an INVALID_ARGUMENT error is returned.
+              { # Fulfillment information, such as the store IDs for in-store pickup or region IDs for different shipping methods.
+                "placeIds": [ # The IDs for this type, such as the store IDs for FulfillmentInfo.type.pickup-in-store or the region IDs for FulfillmentInfo.type.same-day-delivery. A maximum of 3000 values are allowed. Each value must be a string with a length limit of 30 characters, matching the pattern `[a-zA-Z0-9_-]+`, such as "store1" or "REGION-2". Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+                "type": "A String", # The fulfillment type, including commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned.
+              },
+            ],
+            "gtin": "A String", # The Global Trade Item Number (GTIN) of the product. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. This field must be a Unigram. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [gtin](https://support.google.com/merchants/answer/6324461). Schema.org property [Product.isbn](https://schema.org/isbn), [Product.gtin8](https://schema.org/gtin8), [Product.gtin12](https://schema.org/gtin12), [Product.gtin13](https://schema.org/gtin13), or [Product.gtin14](https://schema.org/gtin14). If the value is not a valid GTIN, an INVALID_ARGUMENT error is returned.
+            "id": "A String", # Immutable. Product identifier, which is the final component of name. For example, this field is "id_1", if name is `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/id_1`. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [id](https://support.google.com/merchants/answer/6324405). Schema.org property [Product.sku](https://schema.org/sku).
+            "images": [ # Product images for the product. We highly recommend putting the main image first. A maximum of 300 images are allowed. Corresponding properties: Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+              { # Product image. Recommendations AI and Retail Search use product images to improve prediction and search results. Product images can be returned in results, and are shown in prediction or search previews in the console. Please try to provide correct product images and avoid using images with size too small.
+                "height": 42, # Height of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+                "uri": "A String", # Required. URI of the image. This field must be a valid UTF-8 encoded URI with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Google Merchant Center property [image_link](https://support.google.com/merchants/answer/6324350). Schema.org property [Product.image](https://schema.org/image).
+                "width": 42, # Width of the image in number of pixels. This field must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+              },
+            ],
+            "languageCode": "A String", # Language of the title/description and other string attributes. Use language tags defined by [BCP 47](https://www.rfc-editor.org/rfc/bcp/bcp47.txt). For product prediction, this field is ignored and the model automatically detects the text language. The Product can include text in different languages, but duplicating Products to provide text in multiple languages can result in degraded model performance. For product search this field is in use. It defaults to "en-US" if unset.
+            "localInventories": [ # Output only. A list of local inventories specific to different places. This field can be managed by ProductService.AddLocalInventories and ProductService.RemoveLocalInventories APIs if fine-grained, high-volume updates are necessary.
+              { # The inventory information at a place (e.g. a store) identified by a place ID.
+                "attributes": { # Optional. Additional local inventory attributes, for example, store name, promotion tags, etc. This field needs to pass all below criteria, otherwise an INVALID_ARGUMENT error is returned: * At most 30 attributes are allowed. * The key must be a UTF-8 encoded string with a length limit of 32 characters. * The key must match the pattern: `a-zA-Z0-9*`. For example, key0LikeThis or KEY_1_LIKE_THIS. * The attribute values must be of the same type (text or number). * Only 1 value is allowed for each attribute. * For text values, the length limit is 256 UTF-8 characters. * The attribute does not support search. The `searchable` field should be unset or set to false. * The max summed total bytes of custom attribute keys and values per product is 5MiB.
+                  "a_key": { # A custom attribute that is not explicitly modeled in Product.
+                    "indexable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are indexed, so that they can be filtered, faceted or boosted in SearchService.Search. This field is ignored in a UserEvent. See SearchRequest.filter, SearchRequest.facet_specs and SearchRequest.boost_spec for more details.
+                    "numbers": [ # The numerical values of this custom attribute. For example, `[2.3, 15.4]` when the key is "lengths_cm". Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                      3.14,
+                    ],
+                    "searchable": True or False, # This field is normally ignored unless AttributesConfig.attribute_config_level of the Catalog is set to the deprecated 'PRODUCT_LEVEL_ATTRIBUTE_CONFIG' mode. For information about product-level attribute configuration, see [Configuration modes](https://cloud.google.com/retail/docs/attribute-config#config-modes). If true, custom attribute values are searchable by text queries in SearchService.Search. This field is ignored in a UserEvent. Only set if type text is set. Otherwise, a INVALID_ARGUMENT error is returned.
+                    "text": [ # The textual values of this custom attribute. For example, `["yellow", "green"]` when the key is "color". Empty string is not allowed. Otherwise, an INVALID_ARGUMENT error is returned. Exactly one of text or numbers should be set. Otherwise, an INVALID_ARGUMENT error is returned.
+                      "A String",
+                    ],
+                  },
+                },
+                "fulfillmentTypes": [ # Optional. Supported fulfillment types. Valid fulfillment type values include commonly used types (such as pickup in store and same day delivery), and custom types. Customers have to map custom types to their display names before rendering UI. Supported values: * "pickup-in-store" * "ship-to-store" * "same-day-delivery" * "next-day-delivery" * "custom-type-1" * "custom-type-2" * "custom-type-3" * "custom-type-4" * "custom-type-5" If this field is set to an invalid value other than these, an INVALID_ARGUMENT error is returned. All the elements must be distinct. Otherwise, an INVALID_ARGUMENT error is returned.
+                  "A String",
+                ],
+                "placeId": "A String", # Optional. The place ID for the current set of inventory information.
+                "priceInfo": { # The price information of a Product. # Optional. Product price and cost information. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+                  "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+                  "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+                  "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+                  "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+                  "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+                  "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+                  "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                    "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                      "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                      "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                      "maximum": 3.14, # Inclusive upper bound.
+                      "minimum": 3.14, # Inclusive lower bound.
+                    },
+                    "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                      "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                      "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                      "maximum": 3.14, # Inclusive upper bound.
+                      "minimum": 3.14, # Inclusive lower bound.
+                    },
+                  },
+                },
+              },
+            ],
+            "materials": [ # The material of the product. For example, "leather", "wooden". A maximum of 20 values are allowed. Each value must be a UTF-8 encoded string with a length limit of 200 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [material](https://support.google.com/merchants/answer/6324410). Schema.org property [Product.material](https://schema.org/material).
+              "A String",
+            ],
+            "name": "A String", # Immutable. Full resource name of the product, such as `projects/*/locations/global/catalogs/default_catalog/branches/default_branch/products/product_id`.
+            "patterns": [ # The pattern or graphic print of the product. For example, "striped", "polka dot", "paisley". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [pattern](https://support.google.com/merchants/answer/6324483). Schema.org property [Product.pattern](https://schema.org/pattern).
+              "A String",
+            ],
+            "priceInfo": { # The price information of a Product. # Product price and cost information. Corresponding properties: Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371).
+              "cost": 3.14, # The costs associated with the sale of a particular product. Used for gross profit reporting. * Profit = price - cost Google Merchant Center property [cost_of_goods_sold](https://support.google.com/merchants/answer/9017895).
+              "currencyCode": "A String", # The 3-letter currency code defined in [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). If this field is an unrecognizable currency code, an INVALID_ARGUMENT error is returned. The Product.Type.VARIANT Products with the same Product.primary_product_id must share the same currency_code. Otherwise, a FAILED_PRECONDITION error is returned.
+              "originalPrice": 3.14, # Price of the product without any discount. If zero, by default set to be the price. If set, original_price should be greater than or equal to price, otherwise an INVALID_ARGUMENT error is thrown.
+              "price": 3.14, # Price of the product. Google Merchant Center property [price](https://support.google.com/merchants/answer/6324371). Schema.org property [Offer.price](https://schema.org/price).
+              "priceEffectiveTime": "A String", # The timestamp when the price starts to be effective. This can be set as a future timestamp, and the price is only used for search after price_effective_time. If so, the original_price must be set and original_price is used before price_effective_time. Do not set if price is always effective because it will cause additional latency during search.
+              "priceExpireTime": "A String", # The timestamp when the price stops to be effective. The price is used for search before price_expire_time. If this field is set, the original_price must be set and original_price is used after price_expire_time. Do not set if price is always effective because it will cause additional latency during search.
+              "priceRange": { # The price range of all variant Product having the same Product.primary_product_id. # Output only. The price range of all the child Product.Type.VARIANT Products grouped together on the Product.Type.PRIMARY Product. Only populated for Product.Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+                "originalPrice": { # A floating point interval. # The inclusive Product.pricing_info.original_price internal of all variant Product having the same Product.primary_product_id.
+                  "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                  "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                  "maximum": 3.14, # Inclusive upper bound.
+                  "minimum": 3.14, # Inclusive lower bound.
+                },
+                "price": { # A floating point interval. # The inclusive Product.pricing_info.price interval of all variant Product having the same Product.primary_product_id.
+                  "exclusiveMaximum": 3.14, # Exclusive upper bound.
+                  "exclusiveMinimum": 3.14, # Exclusive lower bound.
+                  "maximum": 3.14, # Inclusive upper bound.
+                  "minimum": 3.14, # Inclusive lower bound.
+                },
+              },
+            },
+            "primaryProductId": "A String", # Variant group identifier. Must be an id, with the same parent branch with this product. Otherwise, an error is thrown. For Type.PRIMARY Products, this field can only be empty or set to the same value as id. For VARIANT Products, this field cannot be empty. A maximum of 2,000 products are allowed to share the same Type.PRIMARY Product. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [item_group_id](https://support.google.com/merchants/answer/6324507). Schema.org property [Product.inProductGroupWithID](https://schema.org/inProductGroupWithID).
+            "promotions": [ # The promotions applied to the product. A maximum of 10 values are allowed per Product. Only Promotion.promotion_id will be used, other fields will be ignored if set.
+              { # Promotion specification.
+                "promotionId": "A String", # Promotion identifier, which is the final component of name. For example, this field is "free_gift", if name is `projects/*/locations/global/catalogs/default_catalog/promotions/free_gift`. The value must be a UTF-8 encoded string with a length limit of 128 characters, and match the pattern: `a-zA-Z*`. For example, id0LikeThis or ID_1_LIKE_THIS. Otherwise, an INVALID_ARGUMENT error is returned. Corresponds to Google Merchant Center property [promotion_id](https://support.google.com/merchants/answer/7050148).
+              },
+            ],
+            "publishTime": "A String", # The timestamp when the product is published by the retailer for the first time, which indicates the freshness of the products. Note that this field is different from available_time, given it purely describes product freshness regardless of when it is available on search and recommendation.
+            "rating": { # The rating of a Product. # The rating of this product.
+              "averageRating": 3.14, # The average rating of the Product. The rating is scaled at 1-5. Otherwise, an INVALID_ARGUMENT error is returned.
+              "ratingCount": 42, # The total number of ratings. This value is independent of the value of rating_histogram. This value must be nonnegative. Otherwise, an INVALID_ARGUMENT error is returned.
+              "ratingHistogram": [ # List of rating counts per rating value (index = rating - 1). The list is empty if there is no rating. If the list is non-empty, its size is always 5. Otherwise, an INVALID_ARGUMENT error is returned. For example, [41, 14, 13, 47, 303]. It means that the Product got 41 ratings with 1 star, 14 ratings with 2 star, and so on.
+                42,
+              ],
+            },
+            "retrievableFields": "A String", # Indicates which fields in the Products are returned in SearchResponse. Supported fields for all types: * audience * availability * brands * color_info * conditions * gtin * materials * name * patterns * price_info * rating * sizes * title * uri Supported fields only for Type.PRIMARY and Type.COLLECTION: * categories * description * images Supported fields only for Type.VARIANT: * Only the first image in images To mark attributes as retrievable, include paths of the form "attributes.key" where "key" is the key of a custom attribute, as specified in attributes. For Type.PRIMARY and Type.COLLECTION, the following fields are always returned in SearchResponse by default: * name For Type.VARIANT, the following fields are always returned in by default: * name * color_info Note: Returning more fields in SearchResponse can increase response payload size and serving latency. This field is deprecated. Use the retrievable site-wide control instead.
+            "sizes": [ # The size of the product. To represent different size systems or size types, consider using this format: [[[size_system:]size_type:]size_value]. For example, in "US:MENS:M", "US" represents size system; "MENS" represents size type; "M" represents size value. In "GIRLS:27", size system is empty; "GIRLS" represents size type; "27" represents size value. In "32 inches", both size system and size type are empty, while size value is "32 inches". A maximum of 20 values are allowed per Product. Each value must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [size](https://support.google.com/merchants/answer/6324492), [size_type](https://support.google.com/merchants/answer/6324497), and [size_system](https://support.google.com/merchants/answer/6324502). Schema.org property [Product.size](https://schema.org/size).
+              "A String",
+            ],
+            "tags": [ # Custom tags associated with the product. At most 250 values are allowed per Product. This value must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. This tag can be used for filtering recommendation results by passing the tag as part of the PredictRequest.filter. Corresponding properties: Google Merchant Center property [custom_label_0–4](https://support.google.com/merchants/answer/6324473).
+              "A String",
+            ],
+            "title": "A String", # Required. Product title. This field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [title](https://support.google.com/merchants/answer/6324415). Schema.org property [Product.name](https://schema.org/name).
+            "ttl": "A String", # Input only. The TTL (time to live) of the product. Note that this is only applicable to Type.PRIMARY and Type.COLLECTION, and ignored for Type.VARIANT. In general, we suggest the users to delete the stale products explicitly, instead of using this field to determine staleness. If it is set, it must be a non-negative value, and expire_time is set as current timestamp plus ttl. The derived expire_time is returned in the output and ttl is left blank when retrieving the Product. If it is set, the product is not available for SearchService.Search after current timestamp plus ttl. However, the product can still be retrieved by ProductService.GetProduct and ProductService.ListProducts.
+            "type": "A String", # Immutable. The type of the product. Default to Catalog.product_level_config.ingestion_product_type if unset.
+            "uri": "A String", # Canonical URL directly linking to the product detail page. It is strongly recommended to provide a valid uri for the product, otherwise the service performance could be significantly degraded. This field must be a UTF-8 encoded string with a length limit of 5,000 characters. Otherwise, an INVALID_ARGUMENT error is returned. Corresponding properties: Google Merchant Center property [link](https://support.google.com/merchants/answer/6324416). Schema.org property [Offer.url](https://schema.org/url).
+            "variants": [ # Output only. Product variants grouped together on primary product which share similar product attributes. It's automatically grouped by primary_product_id for all the product variants. Only populated for Type.PRIMARY Products. Note: This field is OUTPUT_ONLY for ProductService.GetProduct. Do not set this field in API requests.
+              # Object with schema name: GoogleCloudRetailV2betaProduct
+            ],
+          },
+          "quantity": 42, # Quantity of the product associated with the user event. For example, this field will be 2 if two products are added to the shopping cart for `purchase-complete` event. Required for `add-to-cart` and `purchase-complete` event types.
+        },
+      ],
+      "totalPanels": 42, # Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.
+    },
+  ],
   "productDetails": [ # The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.
     { # Detailed product information associated with a user event.
       "product": { # Product captures all metadata information of items to be recommended or searched. # Required. Product information. Required field(s): * Product.id Optional override field(s): * Product.price_info If any supported optional fields are provided, we will treat them as a full override when looking up product information from the catalog. Thus, it is important to ensure that the overriding fields are accurate and complete. All other product fields are ignored and instead populated via catalog lookup after event ingestion.
diff --git a/googleapiclient/discovery_cache/documents/retail.v2.json b/googleapiclient/discovery_cache/documents/retail.v2.json
index a2b7864d986..d04b4479068 100644
--- a/googleapiclient/discovery_cache/documents/retail.v2.json
+++ b/googleapiclient/discovery_cache/documents/retail.v2.json
@@ -2282,7 +2282,7 @@
 }
 }
 },
-"revision": "20250703",
+"revision": "20250717",
 "rootUrl": "https://retail.googleapis.com/",
 "schemas": {
 "GoogleApiHttpBody": {
@@ -4236,6 +4236,42 @@
 },
 "type": "object"
 },
+"GoogleCloudRetailV2PanelInfo": {
+"description": "Detailed panel information associated with a user event.",
+"id": "GoogleCloudRetailV2PanelInfo",
+"properties": {
+"attributionToken": {
+"description": "Optional. The attribution token of the panel.",
+"type": "string"
+},
+"displayName": {
+"description": "Optional. The display name of the panel.",
+"type": "string"
+},
+"panelId": {
+"description": "Required. The panel ID.",
+"type": "string"
+},
+"panelPosition": {
+"description": "Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.",
+"format": "int32",
+"type": "integer"
+},
+"productDetails": {
+"description": "Optional. The product details associated with the panel.",
+"items": {
+"$ref": "GoogleCloudRetailV2ProductDetail"
+},
+"type": "array"
+},
+"totalPanels": {
+"description": "Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "GoogleCloudRetailV2PauseModelRequest": {
 "description": "Request for pausing training of a model.",
 "id": "GoogleCloudRetailV2PauseModelRequest",
@@ -6331,6 +6367,13 @@
 "description": "A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.",
 "type": "string"
 },
+"panels": {
+"description": "Optional. List of panels associated with this event. Used for panel-level impression data.",
+"items": {
+"$ref": "GoogleCloudRetailV2PanelInfo"
+},
+"type": "array"
+},
 "productDetails": {
 "description": "The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.",
 "items": {
diff --git a/googleapiclient/discovery_cache/documents/retail.v2alpha.json b/googleapiclient/discovery_cache/documents/retail.v2alpha.json
index ffad4faa0c3..442732565b2 100644
--- a/googleapiclient/discovery_cache/documents/retail.v2alpha.json
+++ b/googleapiclient/discovery_cache/documents/retail.v2alpha.json
@@ -2859,7 +2859,7 @@
 }
 }
 },
-"revision": "20250710",
+"revision": "20250717",
 "rootUrl": "https://retail.googleapis.com/",
 "schemas": {
 "GoogleApiHttpBody": {
@@ -4662,6 +4662,13 @@
 "description": "Optional. Raw search query to be searched for. If this field is empty, the request is considered a category browsing request.",
 "type": "string"
 },
+"safetySettings": {
+"description": "Optional. The safety settings to be applied to the generated content.",
+"items": {
+"$ref": "GoogleCloudRetailV2alphaSafetySetting"
+},
+"type": "array"
+},
 "searchParams": {
 "$ref": "GoogleCloudRetailV2alphaConversationalSearchRequestSearchParams",
 "description": "Optional. Search parameters."
@@ -5975,6 +5982,12 @@
 "format": "int64",
 "type": "string"
 },
+"primaryFeedId": {
+"deprecated": true,
+"description": "Merchant Center primary feed ID. Deprecated: use data_source_id instead.",
+"format": "int64",
+"type": "string"
+},
 "primaryFeedName": {
 "description": "Merchant Center primary feed name. The name is used for the display purposes only.",
 "type": "string"
@@ -6353,6 +6366,42 @@
 },
 "type": "object"
 },
+"GoogleCloudRetailV2alphaPanelInfo": {
+"description": "Detailed panel information associated with a user event.",
+"id": "GoogleCloudRetailV2alphaPanelInfo",
+"properties": {
+"attributionToken": {
+"description": "Optional. The attribution token of the panel.",
+"type": "string"
+},
+"displayName": {
+"description": "Optional. The display name of the panel.",
+"type": "string"
+},
+"panelId": {
+"description": "Required. The panel ID.",
+"type": "string"
+},
+"panelPosition": {
+"description": "Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.",
+"format": "int32",
+"type": "integer"
+},
+"productDetails": {
+"description": "Optional. The product details associated with the panel.",
+"items": {
+"$ref": "GoogleCloudRetailV2alphaProductDetail"
+},
+"type": "array"
+},
+"totalPanels": {
+"description": "Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "GoogleCloudRetailV2alphaPauseModelRequest": {
 "description": "Request for pausing training of a model.",
 "id": "GoogleCloudRetailV2alphaPauseModelRequest",
@@ -7458,6 +7507,67 @@
 },
 "type": "object"
 },
+"GoogleCloudRetailV2alphaSafetySetting": {
+"description": "Safety settings.",
+"id": "GoogleCloudRetailV2alphaSafetySetting",
+"properties": {
+"category": {
+"description": "Harm category.",
+"enum": [
+"HARM_CATEGORY_UNSPECIFIED",
+"HARM_CATEGORY_HATE_SPEECH",
+"HARM_CATEGORY_DANGEROUS_CONTENT",
+"HARM_CATEGORY_HARASSMENT",
+"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 civic integrity."
+],
+"type": "string"
+},
+"method": {
+"description": "Optional. Specify if the threshold is used for probability or severity score. If not specified, the threshold is used for probability score.",
+"enum": [
+"HARM_BLOCK_METHOD_UNSPECIFIED",
+"SEVERITY",
+"PROBABILITY"
+],
+"enumDescriptions": [
+"The harm block method is unspecified.",
+"The harm block method uses both probability and severity scores.",
+"The harm block method uses the probability score."
+],
+"type": "string"
+},
+"threshold": {
+"description": "The harm block threshold.",
+"enum": [
+"HARM_BLOCK_THRESHOLD_UNSPECIFIED",
+"BLOCK_LOW_AND_ABOVE",
+"BLOCK_MEDIUM_AND_ABOVE",
+"BLOCK_ONLY_HIGH",
+"BLOCK_NONE",
+"OFF"
+],
+"enumDescriptions": [
+"Unspecified harm block threshold.",
+"Block low threshold and above (i.e. block more).",
+"Block medium threshold and above.",
+"Block only high threshold (i.e. block less).",
+"Block none.",
+"Turn off the safety filter."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudRetailV2alphaSearchRequest": {
 "description": "Request message for SearchService.Search method.",
 "id": "GoogleCloudRetailV2alphaSearchRequest",
@@ -8517,6 +8627,13 @@
 "description": "A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.",
 "type": "string"
 },
+"panels": {
+"description": "Optional. List of panels associated with this event. Used for panel-level impression data.",
+"items": {
+"$ref": "GoogleCloudRetailV2alphaPanelInfo"
+},
+"type": "array"
+},
 "productDetails": {
 "description": "The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.",
 "items": {
diff --git a/googleapiclient/discovery_cache/documents/retail.v2beta.json b/googleapiclient/discovery_cache/documents/retail.v2beta.json
index f326c8d5caa..ea508250a99 100644
--- a/googleapiclient/discovery_cache/documents/retail.v2beta.json
+++ b/googleapiclient/discovery_cache/documents/retail.v2beta.json
@@ -2427,7 +2427,7 @@
 }
 }
 },
-"revision": "20250710",
+"revision": "20250717",
 "rootUrl": "https://retail.googleapis.com/",
 "schemas": {
 "GoogleApiHttpBody": {
@@ -5738,6 +5738,12 @@
 "format": "int64",
 "type": "string"
 },
+"primaryFeedId": {
+"deprecated": true,
+"description": "Merchant Center primary feed ID. Deprecated: use data_source_id instead.",
+"format": "int64",
+"type": "string"
+},
 "primaryFeedName": {
 "description": "Merchant Center primary feed name. The name is used for the display purposes only.",
 "type": "string"
@@ -6043,6 +6049,42 @@
 },
 "type": "object"
 },
+"GoogleCloudRetailV2betaPanelInfo": {
+"description": "Detailed panel information associated with a user event.",
+"id": "GoogleCloudRetailV2betaPanelInfo",
+"properties": {
+"attributionToken": {
+"description": "Optional. The attribution token of the panel.",
+"type": "string"
+},
+"displayName": {
+"description": "Optional. The display name of the panel.",
+"type": "string"
+},
+"panelId": {
+"description": "Required. The panel ID.",
+"type": "string"
+},
+"panelPosition": {
+"description": "Optional. The ordered position of the panel, if shown to the user with other panels. If set, then total_panels must also be set.",
+"format": "int32",
+"type": "integer"
+},
+"productDetails": {
+"description": "Optional. The product details associated with the panel.",
+"items": {
+"$ref": "GoogleCloudRetailV2betaProductDetail"
+},
+"type": "array"
+},
+"totalPanels": {
+"description": "Optional. The total number of panels, including this one, shown to the user. Must be set if panel_position is set.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "GoogleCloudRetailV2betaPauseModelRequest": {
 "description": "Request for pausing training of a model.",
 "id": "GoogleCloudRetailV2betaPauseModelRequest",
@@ -8138,6 +8180,13 @@
 "description": "A unique ID of a web page view. This should be kept the same for all user events triggered from the same pageview. For example, an item detail page view could trigger multiple events as the user is browsing the page. The `pageViewId` property should be kept the same for all these events so that they can be grouped together properly. When using the client side event reporting with JavaScript pixel and Google Tag Manager, this value is filled in automatically.",
 "type": "string"
 },
+"panels": {
+"description": "Optional. List of panels associated with this event. Used for panel-level impression data.",
+"items": {
+"$ref": "GoogleCloudRetailV2betaPanelInfo"
+},
+"type": "array"
+},
 "productDetails": {
 "description": "The main product details related to the event. This field is optional except for the following event types: * `add-to-cart` * `detail-page-view` * `purchase-complete` In a `search` event, this field represents the products returned to the end user on the current page (the end user may have not finished browsing the whole page yet). When a new page is returned to the end user, after pagination/filtering/ordering even for the same query, a new `search` event with different product_details is desired. The end user may have not finished browsing the whole page yet.",
 "items": {

From 4f14e0a6f9fca7841942a8fd0a32d56ea1cea73c Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:13 +0000
Subject: [PATCH 27/36] feat(searchads360): update the api

#### searchads360:v0

The following keys were added:
- schemas.GoogleAdsSearchads360V0Errors__ErrorCode.properties.conversionCustomVariableError.type (Total Keys: 1)
---
 ...earchads360_v0.customers.searchAds360.html |  4 +-
 .../documents/searchads360.v0.json            | 42 +++++++++++++++++--
 2 files changed, 40 insertions(+), 6 deletions(-)

diff --git a/docs/dyn/searchads360_v0.customers.searchAds360.html b/docs/dyn/searchads360_v0.customers.searchAds360.html
index 5fc38197482..cf33a34c3ef 100644
--- a/docs/dyn/searchads360_v0.customers.searchAds360.html
+++ b/docs/dyn/searchads360_v0.customers.searchAds360.html
@@ -233,7 +233,7 @@ 
Method Details

             "A String",
           ],
           "id": "A String", # Output only. The ID of the ad.
-          "name": "A String", # Immutable. The name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. The name field is currently only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd.
+          "name": "A String", # Immutable. The name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad.
           "productAd": { # A Search Ads 360 product ad. # Immutable. Details pertaining to a product ad.
           },
           "resourceName": "A String", # Immutable. The resource name of the ad. Ad resource names have the form: `customers/{customer_id}/ads/{ad_id}`
@@ -1413,7 +1413,7 @@ 
Method Details

           "A String",
         ],
         "id": "A String", # Output only. The ID of the ad.
-        "name": "A String", # Immutable. The name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. The name field is currently only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd.
+        "name": "A String", # Immutable. The name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad.
         "productAd": { # A Search Ads 360 product ad. # Immutable. Details pertaining to a product ad.
         },
         "resourceName": "A String", # Immutable. The resource name of the ad. Ad resource names have the form: `customers/{customer_id}/ads/{ad_id}`
diff --git a/googleapiclient/discovery_cache/documents/searchads360.v0.json b/googleapiclient/discovery_cache/documents/searchads360.v0.json
index 21cf95b40a4..e24ed995200 100644
--- a/googleapiclient/discovery_cache/documents/searchads360.v0.json
+++ b/googleapiclient/discovery_cache/documents/searchads360.v0.json
@@ -260,7 +260,7 @@
 }
 }
 },
-"revision": "20250407",
+"revision": "20250721",
 "rootUrl": "https://searchads360.googleapis.com/",
 "schemas": {
 "GoogleAdsSearchads360V0Common__AdScheduleInfo": {
@@ -447,7 +447,8 @@
 "PROMOTION",
 "AD_IMAGE",
 "LEAD_FORM",
-"BUSINESS_LOGO"
+"BUSINESS_LOGO",
+"DESCRIPTION_PREFIX"
 ],
 "enumDescriptions": [
 "No value has been specified.",
@@ -481,7 +482,8 @@
 "This asset is used as a promotion.",
 "This asset is used as an image.",
 "The asset is used as a lead form.",
-"The asset is used as a business logo."
+"The asset is used as a business logo.",
+"The asset is used as a description prefix."
 ],
 "type": "string"
 }
@@ -2686,6 +2688,38 @@
 ],
 "type": "string"
 },
+"conversionCustomVariableError": {
+"description": "The reasons for the conversion custom variable error",
+"enum": [
+"UNSPECIFIED",
+"UNKNOWN",
+"DUPLICATE_NAME",
+"DUPLICATE_TAG",
+"RESERVED_TAG",
+"NOT_FOUND",
+"NOT_AVAILABLE",
+"INCOMPATIBLE_TYPE",
+"INVALID_METRIC",
+"EXCEEDS_CARDINALITY_LIMIT",
+"INVALID_DIMENSION",
+"INCOMPATIBLE_WITH_SELECTED_RESOURCE"
+],
+"enumDescriptions": [
+"Enum unspecified.",
+"The received error code is not known in this version.",
+"A conversion custom variable with the specified name already exists.",
+"A conversion custom variable with the specified tag already exists.",
+"A conversion custom variable with the specified tag is reserved for other uses.",
+"The conversion custom variable is not found.",
+"The conversion custom variable is not available for use.",
+"The conversion custom variable requested is incompatible with the current request.",
+"The conversion custom variable requested is not of type METRIC.",
+"The conversion custom variable's cardinality exceeds the segmentation limit.",
+"The conversion custom variable requested is not of type DIMENSION.",
+"The conversion custom variable requested is incompatible with the selected resource."
+],
+"type": "string"
+},
 "customColumnError": {
 "description": "The reasons for the custom column error",
 "enum": [
@@ -3909,7 +3943,7 @@
 "type": "string"
 },
 "name": {
-"description": "Immutable. The name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad. The name field is currently only supported for DisplayUploadAd, ImageAd, ShoppingComparisonListingAd and VideoAd.",
+"description": "Immutable. The name of the ad. This is only used to be able to identify the ad. It does not need to be unique and does not affect the served ad.",
 "type": "string"
 },
 "productAd": {

From 46921e1615157ab1a258c311646d1f82344b6859 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:13 +0000
Subject: [PATCH 28/36] feat(securitycenter): update the api

#### securitycenter:v1

The following keys were added:
- schemas.CloudControl (Total Keys: 7)
- schemas.ComplianceDetails (Total Keys: 7)
- schemas.Control (Total Keys: 4)
- schemas.Finding.properties.complianceDetails.$ref (Total Keys: 1)
- schemas.Framework (Total Keys: 9)
- schemas.GoogleCloudSecuritycenterV2CloudControl (Total Keys: 7)
- schemas.GoogleCloudSecuritycenterV2ComplianceDetails (Total Keys: 7)
- schemas.GoogleCloudSecuritycenterV2Control (Total Keys: 4)
- schemas.GoogleCloudSecuritycenterV2Finding.properties.complianceDetails.$ref (Total Keys: 1)
- schemas.GoogleCloudSecuritycenterV2Framework (Total Keys: 9)

#### securitycenter:v1beta1

The following keys were added:
- schemas.CloudControl (Total Keys: 7)
- schemas.ComplianceDetails (Total Keys: 7)
- schemas.Control (Total Keys: 4)
- schemas.Finding.properties.complianceDetails.$ref (Total Keys: 1)
- schemas.Framework (Total Keys: 9)
- schemas.GoogleCloudSecuritycenterV2CloudControl (Total Keys: 7)
- schemas.GoogleCloudSecuritycenterV2ComplianceDetails (Total Keys: 7)
- schemas.GoogleCloudSecuritycenterV2Control (Total Keys: 4)
- schemas.GoogleCloudSecuritycenterV2Finding.properties.complianceDetails.$ref (Total Keys: 1)
- schemas.GoogleCloudSecuritycenterV2Framework (Total Keys: 9)

#### securitycenter:v1beta2

The following keys were added:
- schemas.CloudControl (Total Keys: 7)
- schemas.ComplianceDetails (Total Keys: 7)
- schemas.Control (Total Keys: 4)
- schemas.Finding.properties.complianceDetails.$ref (Total Keys: 1)
- schemas.Framework (Total Keys: 9)
- schemas.GoogleCloudSecuritycenterV2CloudControl (Total Keys: 7)
- schemas.GoogleCloudSecuritycenterV2ComplianceDetails (Total Keys: 7)
- schemas.GoogleCloudSecuritycenterV2Control (Total Keys: 4)
- schemas.GoogleCloudSecuritycenterV2Finding.properties.complianceDetails.$ref (Total Keys: 1)
- schemas.GoogleCloudSecuritycenterV2Framework (Total Keys: 9)
---
 ...HealthAnalyticsSettings.customModules.html |  27 ++
 ...itycenter_v1.folders.sources.findings.html | 135 +++++++++
 ...HealthAnalyticsSettings.customModules.html |  27 ++
 ...ter_v1.organizations.sources.findings.html | 189 ++++++++++++
 ...HealthAnalyticsSettings.customModules.html |  27 ++
 ...tycenter_v1.projects.sources.findings.html | 135 +++++++++
 .../documents/securitycenter.v1.json          | 274 +++++++++++++++++-
 .../documents/securitycenter.v1beta1.json     | 274 +++++++++++++++++-
 .../documents/securitycenter.v1beta2.json     | 274 +++++++++++++++++-
 9 files changed, 1356 insertions(+), 6 deletions(-)

diff --git a/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.customModules.html b/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.customModules.html
index badaec42e1d..265932a2dc0 100644
--- a/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.customModules.html
+++ b/docs/dyn/securitycenter_v1.folders.securityHealthAnalyticsSettings.customModules.html
@@ -728,6 +728,33 @@ 
Method Details

         "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
         "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
       },
+      "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+        "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+          "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+          "policyType": "A String", # Policy type of the CloudControl
+          "type": "A String", # Type of cloud control.
+          "version": 42, # Version of the Cloud Control
+        },
+        "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+          "A String",
+        ],
+        "frameworks": [ # Details of Frameworks associated with the finding
+          { # Compliance framework associated with the finding.
+            "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+              "A String",
+            ],
+            "controls": [ # The controls associated with the framework.
+              { # Compliance control associated with the finding.
+                "controlName": "A String", # Name of the Control
+                "displayName": "A String", # Display name of the control. For example, AU-02.
+              },
+            ],
+            "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+            "name": "A String", # Name of the framework associated with the finding
+            "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+          },
+        ],
+      },
       "compliances": [ # Contains compliance information for security standards associated to the finding.
         { # Contains compliance information about a security standard indicating unmet recommendations.
           "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
diff --git a/docs/dyn/securitycenter_v1.folders.sources.findings.html b/docs/dyn/securitycenter_v1.folders.sources.findings.html
index de54d07c167..53200f35d73 100644
--- a/docs/dyn/securitycenter_v1.folders.sources.findings.html
+++ b/docs/dyn/securitycenter_v1.folders.sources.findings.html
@@ -297,6 +297,33 @@ 
Method Details

           "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
           "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
         },
+        "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+          "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+            "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+            "policyType": "A String", # Policy type of the CloudControl
+            "type": "A String", # Type of cloud control.
+            "version": 42, # Version of the Cloud Control
+          },
+          "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+            "A String",
+          ],
+          "frameworks": [ # Details of Frameworks associated with the finding
+            { # Compliance framework associated with the finding.
+              "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+                "A String",
+              ],
+              "controls": [ # The controls associated with the framework.
+                { # Compliance control associated with the finding.
+                  "controlName": "A String", # Name of the Control
+                  "displayName": "A String", # Display name of the control. For example, AU-02.
+                },
+              ],
+              "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+              "name": "A String", # Name of the framework associated with the finding
+              "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+            },
+          ],
+        },
         "compliances": [ # Contains compliance information for security standards associated to the finding.
           { # Contains compliance information about a security standard indicating unmet recommendations.
             "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
@@ -1088,6 +1115,33 @@ 
Method Details

     "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
     "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
   },
+  "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+    "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+      "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+      "policyType": "A String", # Policy type of the CloudControl
+      "type": "A String", # Type of cloud control.
+      "version": 42, # Version of the Cloud Control
+    },
+    "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+      "A String",
+    ],
+    "frameworks": [ # Details of Frameworks associated with the finding
+      { # Compliance framework associated with the finding.
+        "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+          "A String",
+        ],
+        "controls": [ # The controls associated with the framework.
+          { # Compliance control associated with the finding.
+            "controlName": "A String", # Name of the Control
+            "displayName": "A String", # Display name of the control. For example, AU-02.
+          },
+        ],
+        "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+        "name": "A String", # Name of the framework associated with the finding
+        "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+      },
+    ],
+  },
   "compliances": [ # Contains compliance information for security standards associated to the finding.
     { # Contains compliance information about a security standard indicating unmet recommendations.
       "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
@@ -1793,6 +1847,33 @@ 
Method Details

     "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
     "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
   },
+  "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+    "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+      "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+      "policyType": "A String", # Policy type of the CloudControl
+      "type": "A String", # Type of cloud control.
+      "version": 42, # Version of the Cloud Control
+    },
+    "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+      "A String",
+    ],
+    "frameworks": [ # Details of Frameworks associated with the finding
+      { # Compliance framework associated with the finding.
+        "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+          "A String",
+        ],
+        "controls": [ # The controls associated with the framework.
+          { # Compliance control associated with the finding.
+            "controlName": "A String", # Name of the Control
+            "displayName": "A String", # Display name of the control. For example, AU-02.
+          },
+        ],
+        "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+        "name": "A String", # Name of the framework associated with the finding
+        "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+      },
+    ],
+  },
   "compliances": [ # Contains compliance information for security standards associated to the finding.
     { # Contains compliance information about a security standard indicating unmet recommendations.
       "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
@@ -2511,6 +2592,33 @@ 
Method Details

     "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
     "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
   },
+  "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+    "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+      "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+      "policyType": "A String", # Policy type of the CloudControl
+      "type": "A String", # Type of cloud control.
+      "version": 42, # Version of the Cloud Control
+    },
+    "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+      "A String",
+    ],
+    "frameworks": [ # Details of Frameworks associated with the finding
+      { # Compliance framework associated with the finding.
+        "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+          "A String",
+        ],
+        "controls": [ # The controls associated with the framework.
+          { # Compliance control associated with the finding.
+            "controlName": "A String", # Name of the Control
+            "displayName": "A String", # Display name of the control. For example, AU-02.
+          },
+        ],
+        "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+        "name": "A String", # Name of the framework associated with the finding
+        "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+      },
+    ],
+  },
   "compliances": [ # Contains compliance information for security standards associated to the finding.
     { # Contains compliance information about a security standard indicating unmet recommendations.
       "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
@@ -3230,6 +3338,33 @@ 
Method Details

     "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
     "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
   },
+  "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+    "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+      "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+      "policyType": "A String", # Policy type of the CloudControl
+      "type": "A String", # Type of cloud control.
+      "version": 42, # Version of the Cloud Control
+    },
+    "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+      "A String",
+    ],
+    "frameworks": [ # Details of Frameworks associated with the finding
+      { # Compliance framework associated with the finding.
+        "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+          "A String",
+        ],
+        "controls": [ # The controls associated with the framework.
+          { # Compliance control associated with the finding.
+            "controlName": "A String", # Name of the Control
+            "displayName": "A String", # Display name of the control. For example, AU-02.
+          },
+        ],
+        "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+        "name": "A String", # Name of the framework associated with the finding
+        "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+      },
+    ],
+  },
   "compliances": [ # Contains compliance information for security standards associated to the finding.
     { # Contains compliance information about a security standard indicating unmet recommendations.
       "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
diff --git a/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.customModules.html b/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.customModules.html
index 2e246ffdac2..a77fc119bec 100644
--- a/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.customModules.html
+++ b/docs/dyn/securitycenter_v1.organizations.securityHealthAnalyticsSettings.customModules.html
@@ -728,6 +728,33 @@ 
Method Details

         "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
         "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
       },
+      "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+        "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+          "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+          "policyType": "A String", # Policy type of the CloudControl
+          "type": "A String", # Type of cloud control.
+          "version": 42, # Version of the Cloud Control
+        },
+        "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+          "A String",
+        ],
+        "frameworks": [ # Details of Frameworks associated with the finding
+          { # Compliance framework associated with the finding.
+            "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+              "A String",
+            ],
+            "controls": [ # The controls associated with the framework.
+              { # Compliance control associated with the finding.
+                "controlName": "A String", # Name of the Control
+                "displayName": "A String", # Display name of the control. For example, AU-02.
+              },
+            ],
+            "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+            "name": "A String", # Name of the framework associated with the finding
+            "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+          },
+        ],
+      },
       "compliances": [ # Contains compliance information for security standards associated to the finding.
         { # Contains compliance information about a security standard indicating unmet recommendations.
           "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
diff --git a/docs/dyn/securitycenter_v1.organizations.sources.findings.html b/docs/dyn/securitycenter_v1.organizations.sources.findings.html
index c9f1c8b3522..7bd554f4801 100644
--- a/docs/dyn/securitycenter_v1.organizations.sources.findings.html
+++ b/docs/dyn/securitycenter_v1.organizations.sources.findings.html
@@ -230,6 +230,33 @@ 
Method Details

     "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
     "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
   },
+  "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+    "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+      "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+      "policyType": "A String", # Policy type of the CloudControl
+      "type": "A String", # Type of cloud control.
+      "version": 42, # Version of the Cloud Control
+    },
+    "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+      "A String",
+    ],
+    "frameworks": [ # Details of Frameworks associated with the finding
+      { # Compliance framework associated with the finding.
+        "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+          "A String",
+        ],
+        "controls": [ # The controls associated with the framework.
+          { # Compliance control associated with the finding.
+            "controlName": "A String", # Name of the Control
+            "displayName": "A String", # Display name of the control. For example, AU-02.
+          },
+        ],
+        "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+        "name": "A String", # Name of the framework associated with the finding
+        "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+      },
+    ],
+  },
   "compliances": [ # Contains compliance information for security standards associated to the finding.
     { # Contains compliance information about a security standard indicating unmet recommendations.
       "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
@@ -935,6 +962,33 @@ 
Method Details

     "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
     "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
   },
+  "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+    "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+      "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+      "policyType": "A String", # Policy type of the CloudControl
+      "type": "A String", # Type of cloud control.
+      "version": 42, # Version of the Cloud Control
+    },
+    "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+      "A String",
+    ],
+    "frameworks": [ # Details of Frameworks associated with the finding
+      { # Compliance framework associated with the finding.
+        "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+          "A String",
+        ],
+        "controls": [ # The controls associated with the framework.
+          { # Compliance control associated with the finding.
+            "controlName": "A String", # Name of the Control
+            "displayName": "A String", # Display name of the control. For example, AU-02.
+          },
+        ],
+        "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+        "name": "A String", # Name of the framework associated with the finding
+        "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+      },
+    ],
+  },
   "compliances": [ # Contains compliance information for security standards associated to the finding.
     { # Contains compliance information about a security standard indicating unmet recommendations.
       "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
@@ -1711,6 +1765,33 @@ 
Method Details

           "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
           "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
         },
+        "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+          "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+            "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+            "policyType": "A String", # Policy type of the CloudControl
+            "type": "A String", # Type of cloud control.
+            "version": 42, # Version of the Cloud Control
+          },
+          "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+            "A String",
+          ],
+          "frameworks": [ # Details of Frameworks associated with the finding
+            { # Compliance framework associated with the finding.
+              "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+                "A String",
+              ],
+              "controls": [ # The controls associated with the framework.
+                { # Compliance control associated with the finding.
+                  "controlName": "A String", # Name of the Control
+                  "displayName": "A String", # Display name of the control. For example, AU-02.
+                },
+              ],
+              "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+              "name": "A String", # Name of the framework associated with the finding
+              "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+            },
+          ],
+        },
         "compliances": [ # Contains compliance information for security standards associated to the finding.
           { # Contains compliance information about a security standard indicating unmet recommendations.
             "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
@@ -2502,6 +2583,33 @@ 
Method Details

     "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
     "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
   },
+  "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+    "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+      "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+      "policyType": "A String", # Policy type of the CloudControl
+      "type": "A String", # Type of cloud control.
+      "version": 42, # Version of the Cloud Control
+    },
+    "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+      "A String",
+    ],
+    "frameworks": [ # Details of Frameworks associated with the finding
+      { # Compliance framework associated with the finding.
+        "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+          "A String",
+        ],
+        "controls": [ # The controls associated with the framework.
+          { # Compliance control associated with the finding.
+            "controlName": "A String", # Name of the Control
+            "displayName": "A String", # Display name of the control. For example, AU-02.
+          },
+        ],
+        "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+        "name": "A String", # Name of the framework associated with the finding
+        "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+      },
+    ],
+  },
   "compliances": [ # Contains compliance information for security standards associated to the finding.
     { # Contains compliance information about a security standard indicating unmet recommendations.
       "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
@@ -3207,6 +3315,33 @@ 
Method Details

     "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
     "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
   },
+  "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+    "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+      "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+      "policyType": "A String", # Policy type of the CloudControl
+      "type": "A String", # Type of cloud control.
+      "version": 42, # Version of the Cloud Control
+    },
+    "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+      "A String",
+    ],
+    "frameworks": [ # Details of Frameworks associated with the finding
+      { # Compliance framework associated with the finding.
+        "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+          "A String",
+        ],
+        "controls": [ # The controls associated with the framework.
+          { # Compliance control associated with the finding.
+            "controlName": "A String", # Name of the Control
+            "displayName": "A String", # Display name of the control. For example, AU-02.
+          },
+        ],
+        "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+        "name": "A String", # Name of the framework associated with the finding
+        "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+      },
+    ],
+  },
   "compliances": [ # Contains compliance information for security standards associated to the finding.
     { # Contains compliance information about a security standard indicating unmet recommendations.
       "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
@@ -3925,6 +4060,33 @@ 
Method Details

     "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
     "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
   },
+  "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+    "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+      "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+      "policyType": "A String", # Policy type of the CloudControl
+      "type": "A String", # Type of cloud control.
+      "version": 42, # Version of the Cloud Control
+    },
+    "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+      "A String",
+    ],
+    "frameworks": [ # Details of Frameworks associated with the finding
+      { # Compliance framework associated with the finding.
+        "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+          "A String",
+        ],
+        "controls": [ # The controls associated with the framework.
+          { # Compliance control associated with the finding.
+            "controlName": "A String", # Name of the Control
+            "displayName": "A String", # Display name of the control. For example, AU-02.
+          },
+        ],
+        "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+        "name": "A String", # Name of the framework associated with the finding
+        "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+      },
+    ],
+  },
   "compliances": [ # Contains compliance information for security standards associated to the finding.
     { # Contains compliance information about a security standard indicating unmet recommendations.
       "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
@@ -4644,6 +4806,33 @@ 
Method Details

     "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
     "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
   },
+  "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+    "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+      "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+      "policyType": "A String", # Policy type of the CloudControl
+      "type": "A String", # Type of cloud control.
+      "version": 42, # Version of the Cloud Control
+    },
+    "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+      "A String",
+    ],
+    "frameworks": [ # Details of Frameworks associated with the finding
+      { # Compliance framework associated with the finding.
+        "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+          "A String",
+        ],
+        "controls": [ # The controls associated with the framework.
+          { # Compliance control associated with the finding.
+            "controlName": "A String", # Name of the Control
+            "displayName": "A String", # Display name of the control. For example, AU-02.
+          },
+        ],
+        "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+        "name": "A String", # Name of the framework associated with the finding
+        "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+      },
+    ],
+  },
   "compliances": [ # Contains compliance information for security standards associated to the finding.
     { # Contains compliance information about a security standard indicating unmet recommendations.
       "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
diff --git a/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.customModules.html b/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.customModules.html
index e757d05d475..06c8cadf1a9 100644
--- a/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.customModules.html
+++ b/docs/dyn/securitycenter_v1.projects.securityHealthAnalyticsSettings.customModules.html
@@ -728,6 +728,33 @@ 
Method Details

         "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
         "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
       },
+      "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+        "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+          "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+          "policyType": "A String", # Policy type of the CloudControl
+          "type": "A String", # Type of cloud control.
+          "version": 42, # Version of the Cloud Control
+        },
+        "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+          "A String",
+        ],
+        "frameworks": [ # Details of Frameworks associated with the finding
+          { # Compliance framework associated with the finding.
+            "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+              "A String",
+            ],
+            "controls": [ # The controls associated with the framework.
+              { # Compliance control associated with the finding.
+                "controlName": "A String", # Name of the Control
+                "displayName": "A String", # Display name of the control. For example, AU-02.
+              },
+            ],
+            "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+            "name": "A String", # Name of the framework associated with the finding
+            "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+          },
+        ],
+      },
       "compliances": [ # Contains compliance information for security standards associated to the finding.
         { # Contains compliance information about a security standard indicating unmet recommendations.
           "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
diff --git a/docs/dyn/securitycenter_v1.projects.sources.findings.html b/docs/dyn/securitycenter_v1.projects.sources.findings.html
index cb7f43371ee..70dc64a7153 100644
--- a/docs/dyn/securitycenter_v1.projects.sources.findings.html
+++ b/docs/dyn/securitycenter_v1.projects.sources.findings.html
@@ -297,6 +297,33 @@ 
Method Details

           "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
           "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
         },
+        "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+          "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+            "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+            "policyType": "A String", # Policy type of the CloudControl
+            "type": "A String", # Type of cloud control.
+            "version": 42, # Version of the Cloud Control
+          },
+          "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+            "A String",
+          ],
+          "frameworks": [ # Details of Frameworks associated with the finding
+            { # Compliance framework associated with the finding.
+              "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+                "A String",
+              ],
+              "controls": [ # The controls associated with the framework.
+                { # Compliance control associated with the finding.
+                  "controlName": "A String", # Name of the Control
+                  "displayName": "A String", # Display name of the control. For example, AU-02.
+                },
+              ],
+              "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+              "name": "A String", # Name of the framework associated with the finding
+              "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+            },
+          ],
+        },
         "compliances": [ # Contains compliance information for security standards associated to the finding.
           { # Contains compliance information about a security standard indicating unmet recommendations.
             "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
@@ -1088,6 +1115,33 @@ 
Method Details

     "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
     "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
   },
+  "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+    "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+      "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+      "policyType": "A String", # Policy type of the CloudControl
+      "type": "A String", # Type of cloud control.
+      "version": 42, # Version of the Cloud Control
+    },
+    "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+      "A String",
+    ],
+    "frameworks": [ # Details of Frameworks associated with the finding
+      { # Compliance framework associated with the finding.
+        "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+          "A String",
+        ],
+        "controls": [ # The controls associated with the framework.
+          { # Compliance control associated with the finding.
+            "controlName": "A String", # Name of the Control
+            "displayName": "A String", # Display name of the control. For example, AU-02.
+          },
+        ],
+        "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+        "name": "A String", # Name of the framework associated with the finding
+        "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+      },
+    ],
+  },
   "compliances": [ # Contains compliance information for security standards associated to the finding.
     { # Contains compliance information about a security standard indicating unmet recommendations.
       "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
@@ -1793,6 +1847,33 @@ 
Method Details

     "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
     "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
   },
+  "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+    "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+      "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+      "policyType": "A String", # Policy type of the CloudControl
+      "type": "A String", # Type of cloud control.
+      "version": 42, # Version of the Cloud Control
+    },
+    "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+      "A String",
+    ],
+    "frameworks": [ # Details of Frameworks associated with the finding
+      { # Compliance framework associated with the finding.
+        "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+          "A String",
+        ],
+        "controls": [ # The controls associated with the framework.
+          { # Compliance control associated with the finding.
+            "controlName": "A String", # Name of the Control
+            "displayName": "A String", # Display name of the control. For example, AU-02.
+          },
+        ],
+        "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+        "name": "A String", # Name of the framework associated with the finding
+        "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+      },
+    ],
+  },
   "compliances": [ # Contains compliance information for security standards associated to the finding.
     { # Contains compliance information about a security standard indicating unmet recommendations.
       "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
@@ -2511,6 +2592,33 @@ 
Method Details

     "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
     "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
   },
+  "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+    "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+      "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+      "policyType": "A String", # Policy type of the CloudControl
+      "type": "A String", # Type of cloud control.
+      "version": 42, # Version of the Cloud Control
+    },
+    "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+      "A String",
+    ],
+    "frameworks": [ # Details of Frameworks associated with the finding
+      { # Compliance framework associated with the finding.
+        "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+          "A String",
+        ],
+        "controls": [ # The controls associated with the framework.
+          { # Compliance control associated with the finding.
+            "controlName": "A String", # Name of the Control
+            "displayName": "A String", # Display name of the control. For example, AU-02.
+          },
+        ],
+        "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+        "name": "A String", # Name of the framework associated with the finding
+        "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+      },
+    ],
+  },
   "compliances": [ # Contains compliance information for security standards associated to the finding.
     { # Contains compliance information about a security standard indicating unmet recommendations.
       "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
@@ -3230,6 +3338,33 @@ 
Method Details

     "infoTypeCount": "A String", # The number of times Cloud DLP found this infoType within this job and resource.
     "inspectJob": "A String", # Name of the inspection job, for example, `projects/123/locations/europe/dlpJobs/i-8383929`.
   },
+  "complianceDetails": { # Compliance Details associated with the finding. # Details about the compliance implications of the finding.
+    "cloudControl": { # CloudControl associated with the finding. # CloudControl associated with the finding
+      "cloudControlName": "A String", # Name of the CloudControl associated with the finding.
+      "policyType": "A String", # Policy type of the CloudControl
+      "type": "A String", # Type of cloud control.
+      "version": 42, # Version of the Cloud Control
+    },
+    "cloudControlDeploymentNames": [ # Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier
+      "A String",
+    ],
+    "frameworks": [ # Details of Frameworks associated with the finding
+      { # Compliance framework associated with the finding.
+        "category": [ # Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads
+          "A String",
+        ],
+        "controls": [ # The controls associated with the framework.
+          { # Compliance control associated with the finding.
+            "controlName": "A String", # Name of the Control
+            "displayName": "A String", # Display name of the control. For example, AU-02.
+          },
+        ],
+        "displayName": "A String", # Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework
+        "name": "A String", # Name of the framework associated with the finding
+        "type": "A String", # Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)
+      },
+    ],
+  },
   "compliances": [ # Contains compliance information for security standards associated to the finding.
     { # Contains compliance information about a security standard indicating unmet recommendations.
       "ids": [ # Policies within the standard or benchmark, for example, A.12.4.1
diff --git a/googleapiclient/discovery_cache/documents/securitycenter.v1.json b/googleapiclient/discovery_cache/documents/securitycenter.v1.json
index 7657f4420c2..95d0c450bff 100644
--- a/googleapiclient/discovery_cache/documents/securitycenter.v1.json
+++ b/googleapiclient/discovery_cache/documents/securitycenter.v1.json
@@ -5938,7 +5938,7 @@
 }
 }
 },
-"revision": "20250707",
+"revision": "20250721",
 "rootUrl": "https://securitycenter.googleapis.com/",
 "schemas": {
 "Access": {
@@ -6802,6 +6802,40 @@
 },
 "type": "object"
 },
+"CloudControl": {
+"description": "CloudControl associated with the finding.",
+"id": "CloudControl",
+"properties": {
+"cloudControlName": {
+"description": "Name of the CloudControl associated with the finding.",
+"type": "string"
+},
+"policyType": {
+"description": "Policy type of the CloudControl",
+"type": "string"
+},
+"type": {
+"description": "Type of cloud control.",
+"enum": [
+"CLOUD_CONTROL_TYPE_UNSPECIFIED",
+"BUILT_IN",
+"CUSTOM"
+],
+"enumDescriptions": [
+"Unspecified.",
+"Built in Cloud Control.",
+"Custom Cloud Control."
+],
+"type": "string"
+},
+"version": {
+"description": "Version of the Cloud Control",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "CloudDlpDataProfile": {
 "description": "The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding.",
 "id": "CloudDlpDataProfile",
@@ -6897,6 +6931,31 @@
 },
 "type": "object"
 },
+"ComplianceDetails": {
+"description": "Compliance Details associated with the finding.",
+"id": "ComplianceDetails",
+"properties": {
+"cloudControl": {
+"$ref": "CloudControl",
+"description": "CloudControl associated with the finding"
+},
+"cloudControlDeploymentNames": {
+"description": "Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"frameworks": {
+"description": "Details of Frameworks associated with the finding",
+"items": {
+"$ref": "Framework"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "Connection": {
 "description": "Contains information about the IP connection associated with the finding.",
 "id": "Connection",
@@ -6998,6 +7057,21 @@
 },
 "type": "object"
 },
+"Control": {
+"description": "Compliance control associated with the finding.",
+"id": "Control",
+"properties": {
+"controlName": {
+"description": "Name of the Control",
+"type": "string"
+},
+"displayName": {
+"description": "Display name of the control. For example, AU-02.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "CreateResourceValueConfigRequest": {
 "description": "Request message to create single resource value config",
 "id": "CreateResourceValueConfigRequest",
@@ -7900,6 +7974,10 @@
 "$ref": "CloudDlpInspection",
 "description": "Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding."
 },
+"complianceDetails": {
+"$ref": "ComplianceDetails",
+"description": "Details about the compliance implications of the finding."
+},
 "compliances": {
 "description": "Contains compliance information for security standards associated to the finding.",
 "items": {
@@ -8234,6 +8312,63 @@
 },
 "type": "object"
 },
+"Framework": {
+"description": "Compliance framework associated with the finding.",
+"id": "Framework",
+"properties": {
+"category": {
+"description": "Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads",
+"items": {
+"enum": [
+"FRAMEWORK_CATEGORY_UNSPECIFIED",
+"SECURITY_BENCHMARKS",
+"ASSURED_WORKLOADS",
+"DATA_SECURITY",
+"GOOGLE_BEST_PRACTICES"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"Security Benchmarks framework",
+"Assured Workloads framework",
+"Data Security framework",
+"Google Best Practices framework"
+],
+"type": "string"
+},
+"type": "array"
+},
+"controls": {
+"description": "The controls associated with the framework.",
+"items": {
+"$ref": "Control"
+},
+"type": "array"
+},
+"displayName": {
+"description": "Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework",
+"type": "string"
+},
+"name": {
+"description": "Name of the framework associated with the finding",
+"type": "string"
+},
+"type": {
+"description": "Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)",
+"enum": [
+"FRAMEWORK_TYPE_UNSPECIFIED",
+"FRAMEWORK_TYPE_BUILT_IN",
+"FRAMEWORK_TYPE_CUSTOM"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The framework is a built-in framework if it is created and managed by GCP.",
+"The framework is a custom framework if it is created and managed by the user."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GcpMetadata": {
 "description": "Google Cloud metadata associated with the resource. Only applicable if the finding's cloud provider is Google Cloud.",
 "id": "GcpMetadata",
@@ -9802,6 +9937,40 @@
 },
 "type": "object"
 },
+"GoogleCloudSecuritycenterV2CloudControl": {
+"description": "CloudControl associated with the finding.",
+"id": "GoogleCloudSecuritycenterV2CloudControl",
+"properties": {
+"cloudControlName": {
+"description": "Name of the CloudControl associated with the finding.",
+"type": "string"
+},
+"policyType": {
+"description": "Policy type of the CloudControl",
+"type": "string"
+},
+"type": {
+"description": "Type of cloud control.",
+"enum": [
+"CLOUD_CONTROL_TYPE_UNSPECIFIED",
+"BUILT_IN",
+"CUSTOM"
+],
+"enumDescriptions": [
+"Unspecified.",
+"Built in Cloud Control.",
+"Custom Cloud Control."
+],
+"type": "string"
+},
+"version": {
+"description": "Version of the Cloud Control",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "GoogleCloudSecuritycenterV2CloudDlpDataProfile": {
 "description": "The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding.",
 "id": "GoogleCloudSecuritycenterV2CloudDlpDataProfile",
@@ -9897,6 +10066,31 @@
 },
 "type": "object"
 },
+"GoogleCloudSecuritycenterV2ComplianceDetails": {
+"description": "Compliance Details associated with the finding.",
+"id": "GoogleCloudSecuritycenterV2ComplianceDetails",
+"properties": {
+"cloudControl": {
+"$ref": "GoogleCloudSecuritycenterV2CloudControl",
+"description": "CloudControl associated with the finding"
+},
+"cloudControlDeploymentNames": {
+"description": "Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"frameworks": {
+"description": "Details of Frameworks associated with the finding",
+"items": {
+"$ref": "GoogleCloudSecuritycenterV2Framework"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "GoogleCloudSecuritycenterV2Connection": {
 "description": "Contains information about the IP connection associated with the finding.",
 "id": "GoogleCloudSecuritycenterV2Connection",
@@ -9998,6 +10192,21 @@
 },
 "type": "object"
 },
+"GoogleCloudSecuritycenterV2Control": {
+"description": "Compliance control associated with the finding.",
+"id": "GoogleCloudSecuritycenterV2Control",
+"properties": {
+"controlName": {
+"description": "Name of the Control",
+"type": "string"
+},
+"displayName": {
+"description": "Display name of the control. For example, AU-02.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudSecuritycenterV2Cve": {
 "description": "CVE stands for Common Vulnerabilities and Exposures. Information from the [CVE record](https://www.cve.org/ResourcesSupport/Glossary) that describes this vulnerability.",
 "id": "GoogleCloudSecuritycenterV2Cve",
@@ -10710,6 +10919,10 @@
 "$ref": "GoogleCloudSecuritycenterV2CloudDlpInspection",
 "description": "Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding."
 },
+"complianceDetails": {
+"$ref": "GoogleCloudSecuritycenterV2ComplianceDetails",
+"description": "Details about the compliance implications of the finding."
+},
 "compliances": {
 "description": "Contains compliance information for security standards associated to the finding.",
 "items": {
@@ -11046,6 +11259,63 @@
 },
 "type": "object"
 },
+"GoogleCloudSecuritycenterV2Framework": {
+"description": "Compliance framework associated with the finding.",
+"id": "GoogleCloudSecuritycenterV2Framework",
+"properties": {
+"category": {
+"description": "Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads",
+"items": {
+"enum": [
+"FRAMEWORK_CATEGORY_UNSPECIFIED",
+"SECURITY_BENCHMARKS",
+"ASSURED_WORKLOADS",
+"DATA_SECURITY",
+"GOOGLE_BEST_PRACTICES"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"Security Benchmarks framework",
+"Assured Workloads framework",
+"Data Security framework",
+"Google Best Practices framework"
+],
+"type": "string"
+},
+"type": "array"
+},
+"controls": {
+"description": "The controls associated with the framework.",
+"items": {
+"$ref": "GoogleCloudSecuritycenterV2Control"
+},
+"type": "array"
+},
+"displayName": {
+"description": "Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework",
+"type": "string"
+},
+"name": {
+"description": "Name of the framework associated with the finding",
+"type": "string"
+},
+"type": {
+"description": "Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)",
+"enum": [
+"FRAMEWORK_TYPE_UNSPECIFIED",
+"FRAMEWORK_TYPE_BUILT_IN",
+"FRAMEWORK_TYPE_CUSTOM"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The framework is a built-in framework if it is created and managed by GCP.",
+"The framework is a custom framework if it is created and managed by the user."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudSecuritycenterV2Geolocation": {
 "description": "Represents a geographical location for a given access.",
 "id": "GoogleCloudSecuritycenterV2Geolocation",
@@ -12938,7 +13208,7 @@
 },
 "gcpMetadata": {
 "$ref": "GcpMetadata",
-"description": "The GCP metadata associated with the finding."
+"description": "The Google Cloud metadata associated with the finding."
 },
 "location": {
 "description": "The region or location of the service (if applicable).",
diff --git a/googleapiclient/discovery_cache/documents/securitycenter.v1beta1.json b/googleapiclient/discovery_cache/documents/securitycenter.v1beta1.json
index 8d0b55a5217..743a7ef43ba 100644
--- a/googleapiclient/discovery_cache/documents/securitycenter.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/securitycenter.v1beta1.json
@@ -913,7 +913,7 @@
 }
 }
 },
-"revision": "20250707",
+"revision": "20250721",
 "rootUrl": "https://securitycenter.googleapis.com/",
 "schemas": {
 "Access": {
@@ -1589,6 +1589,40 @@
 },
 "type": "object"
 },
+"CloudControl": {
+"description": "CloudControl associated with the finding.",
+"id": "CloudControl",
+"properties": {
+"cloudControlName": {
+"description": "Name of the CloudControl associated with the finding.",
+"type": "string"
+},
+"policyType": {
+"description": "Policy type of the CloudControl",
+"type": "string"
+},
+"type": {
+"description": "Type of cloud control.",
+"enum": [
+"CLOUD_CONTROL_TYPE_UNSPECIFIED",
+"BUILT_IN",
+"CUSTOM"
+],
+"enumDescriptions": [
+"Unspecified.",
+"Built in Cloud Control.",
+"Custom Cloud Control."
+],
+"type": "string"
+},
+"version": {
+"description": "Version of the Cloud Control",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "CloudDlpDataProfile": {
 "description": "The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding.",
 "id": "CloudDlpDataProfile",
@@ -1684,6 +1718,31 @@
 },
 "type": "object"
 },
+"ComplianceDetails": {
+"description": "Compliance Details associated with the finding.",
+"id": "ComplianceDetails",
+"properties": {
+"cloudControl": {
+"$ref": "CloudControl",
+"description": "CloudControl associated with the finding"
+},
+"cloudControlDeploymentNames": {
+"description": "Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"frameworks": {
+"description": "Details of Frameworks associated with the finding",
+"items": {
+"$ref": "Framework"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "Connection": {
 "description": "Contains information about the IP connection associated with the finding.",
 "id": "Connection",
@@ -1785,6 +1844,21 @@
 },
 "type": "object"
 },
+"Control": {
+"description": "Compliance control associated with the finding.",
+"id": "Control",
+"properties": {
+"controlName": {
+"description": "Name of the Control",
+"type": "string"
+},
+"displayName": {
+"description": "Display name of the control. For example, AU-02.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "Cve": {
 "description": "CVE stands for Common Vulnerabilities and Exposures. Information from the [CVE record](https://www.cve.org/ResourcesSupport/Glossary) that describes this vulnerability.",
 "id": "Cve",
@@ -2489,6 +2563,10 @@
 "$ref": "CloudDlpInspection",
 "description": "Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding."
 },
+"complianceDetails": {
+"$ref": "ComplianceDetails",
+"description": "Details about the compliance implications of the finding."
+},
 "compliances": {
 "description": "Contains compliance information for security standards associated to the finding.",
 "items": {
@@ -2823,6 +2901,63 @@
 },
 "type": "object"
 },
+"Framework": {
+"description": "Compliance framework associated with the finding.",
+"id": "Framework",
+"properties": {
+"category": {
+"description": "Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads",
+"items": {
+"enum": [
+"FRAMEWORK_CATEGORY_UNSPECIFIED",
+"SECURITY_BENCHMARKS",
+"ASSURED_WORKLOADS",
+"DATA_SECURITY",
+"GOOGLE_BEST_PRACTICES"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"Security Benchmarks framework",
+"Assured Workloads framework",
+"Data Security framework",
+"Google Best Practices framework"
+],
+"type": "string"
+},
+"type": "array"
+},
+"controls": {
+"description": "The controls associated with the framework.",
+"items": {
+"$ref": "Control"
+},
+"type": "array"
+},
+"displayName": {
+"description": "Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework",
+"type": "string"
+},
+"name": {
+"description": "Name of the framework associated with the finding",
+"type": "string"
+},
+"type": {
+"description": "Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)",
+"enum": [
+"FRAMEWORK_TYPE_UNSPECIFIED",
+"FRAMEWORK_TYPE_BUILT_IN",
+"FRAMEWORK_TYPE_CUSTOM"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The framework is a built-in framework if it is created and managed by GCP.",
+"The framework is a custom framework if it is created and managed by the user."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GcpMetadata": {
 "description": "Google Cloud metadata associated with the resource. Only applicable if the finding's cloud provider is Google Cloud.",
 "id": "GcpMetadata",
@@ -4472,6 +4607,40 @@
 },
 "type": "object"
 },
+"GoogleCloudSecuritycenterV2CloudControl": {
+"description": "CloudControl associated with the finding.",
+"id": "GoogleCloudSecuritycenterV2CloudControl",
+"properties": {
+"cloudControlName": {
+"description": "Name of the CloudControl associated with the finding.",
+"type": "string"
+},
+"policyType": {
+"description": "Policy type of the CloudControl",
+"type": "string"
+},
+"type": {
+"description": "Type of cloud control.",
+"enum": [
+"CLOUD_CONTROL_TYPE_UNSPECIFIED",
+"BUILT_IN",
+"CUSTOM"
+],
+"enumDescriptions": [
+"Unspecified.",
+"Built in Cloud Control.",
+"Custom Cloud Control."
+],
+"type": "string"
+},
+"version": {
+"description": "Version of the Cloud Control",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "GoogleCloudSecuritycenterV2CloudDlpDataProfile": {
 "description": "The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding.",
 "id": "GoogleCloudSecuritycenterV2CloudDlpDataProfile",
@@ -4567,6 +4736,31 @@
 },
 "type": "object"
 },
+"GoogleCloudSecuritycenterV2ComplianceDetails": {
+"description": "Compliance Details associated with the finding.",
+"id": "GoogleCloudSecuritycenterV2ComplianceDetails",
+"properties": {
+"cloudControl": {
+"$ref": "GoogleCloudSecuritycenterV2CloudControl",
+"description": "CloudControl associated with the finding"
+},
+"cloudControlDeploymentNames": {
+"description": "Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"frameworks": {
+"description": "Details of Frameworks associated with the finding",
+"items": {
+"$ref": "GoogleCloudSecuritycenterV2Framework"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "GoogleCloudSecuritycenterV2Connection": {
 "description": "Contains information about the IP connection associated with the finding.",
 "id": "GoogleCloudSecuritycenterV2Connection",
@@ -4668,6 +4862,21 @@
 },
 "type": "object"
 },
+"GoogleCloudSecuritycenterV2Control": {
+"description": "Compliance control associated with the finding.",
+"id": "GoogleCloudSecuritycenterV2Control",
+"properties": {
+"controlName": {
+"description": "Name of the Control",
+"type": "string"
+},
+"displayName": {
+"description": "Display name of the control. For example, AU-02.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudSecuritycenterV2Cve": {
 "description": "CVE stands for Common Vulnerabilities and Exposures. Information from the [CVE record](https://www.cve.org/ResourcesSupport/Glossary) that describes this vulnerability.",
 "id": "GoogleCloudSecuritycenterV2Cve",
@@ -5380,6 +5589,10 @@
 "$ref": "GoogleCloudSecuritycenterV2CloudDlpInspection",
 "description": "Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding."
 },
+"complianceDetails": {
+"$ref": "GoogleCloudSecuritycenterV2ComplianceDetails",
+"description": "Details about the compliance implications of the finding."
+},
 "compliances": {
 "description": "Contains compliance information for security standards associated to the finding.",
 "items": {
@@ -5716,6 +5929,63 @@
 },
 "type": "object"
 },
+"GoogleCloudSecuritycenterV2Framework": {
+"description": "Compliance framework associated with the finding.",
+"id": "GoogleCloudSecuritycenterV2Framework",
+"properties": {
+"category": {
+"description": "Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads",
+"items": {
+"enum": [
+"FRAMEWORK_CATEGORY_UNSPECIFIED",
+"SECURITY_BENCHMARKS",
+"ASSURED_WORKLOADS",
+"DATA_SECURITY",
+"GOOGLE_BEST_PRACTICES"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"Security Benchmarks framework",
+"Assured Workloads framework",
+"Data Security framework",
+"Google Best Practices framework"
+],
+"type": "string"
+},
+"type": "array"
+},
+"controls": {
+"description": "The controls associated with the framework.",
+"items": {
+"$ref": "GoogleCloudSecuritycenterV2Control"
+},
+"type": "array"
+},
+"displayName": {
+"description": "Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework",
+"type": "string"
+},
+"name": {
+"description": "Name of the framework associated with the finding",
+"type": "string"
+},
+"type": {
+"description": "Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)",
+"enum": [
+"FRAMEWORK_TYPE_UNSPECIFIED",
+"FRAMEWORK_TYPE_BUILT_IN",
+"FRAMEWORK_TYPE_CUSTOM"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The framework is a built-in framework if it is created and managed by GCP.",
+"The framework is a custom framework if it is created and managed by the user."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudSecuritycenterV2Geolocation": {
 "description": "Represents a geographical location for a given access.",
 "id": "GoogleCloudSecuritycenterV2Geolocation",
@@ -7608,7 +7878,7 @@
 },
 "gcpMetadata": {
 "$ref": "GcpMetadata",
-"description": "The GCP metadata associated with the finding."
+"description": "The Google Cloud metadata associated with the finding."
 },
 "location": {
 "description": "The region or location of the service (if applicable).",
diff --git a/googleapiclient/discovery_cache/documents/securitycenter.v1beta2.json b/googleapiclient/discovery_cache/documents/securitycenter.v1beta2.json
index 830ec5f7453..9af13cef44e 100644
--- a/googleapiclient/discovery_cache/documents/securitycenter.v1beta2.json
+++ b/googleapiclient/discovery_cache/documents/securitycenter.v1beta2.json
@@ -2003,7 +2003,7 @@
 }
 }
 },
-"revision": "20250707",
+"revision": "20250721",
 "rootUrl": "https://securitycenter.googleapis.com/",
 "schemas": {
 "Access": {
@@ -2539,6 +2539,40 @@
 },
 "type": "object"
 },
+"CloudControl": {
+"description": "CloudControl associated with the finding.",
+"id": "CloudControl",
+"properties": {
+"cloudControlName": {
+"description": "Name of the CloudControl associated with the finding.",
+"type": "string"
+},
+"policyType": {
+"description": "Policy type of the CloudControl",
+"type": "string"
+},
+"type": {
+"description": "Type of cloud control.",
+"enum": [
+"CLOUD_CONTROL_TYPE_UNSPECIFIED",
+"BUILT_IN",
+"CUSTOM"
+],
+"enumDescriptions": [
+"Unspecified.",
+"Built in Cloud Control.",
+"Custom Cloud Control."
+],
+"type": "string"
+},
+"version": {
+"description": "Version of the Cloud Control",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "CloudDlpDataProfile": {
 "description": "The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding.",
 "id": "CloudDlpDataProfile",
@@ -2634,6 +2668,31 @@
 },
 "type": "object"
 },
+"ComplianceDetails": {
+"description": "Compliance Details associated with the finding.",
+"id": "ComplianceDetails",
+"properties": {
+"cloudControl": {
+"$ref": "CloudControl",
+"description": "CloudControl associated with the finding"
+},
+"cloudControlDeploymentNames": {
+"description": "Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"frameworks": {
+"description": "Details of Frameworks associated with the finding",
+"items": {
+"$ref": "Framework"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "Config": {
 "description": "Configuration of a module.",
 "id": "Config",
@@ -2811,6 +2870,21 @@
 },
 "type": "object"
 },
+"Control": {
+"description": "Compliance control associated with the finding.",
+"id": "Control",
+"properties": {
+"controlName": {
+"description": "Name of the Control",
+"type": "string"
+},
+"displayName": {
+"description": "Display name of the control. For example, AU-02.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "Cve": {
 "description": "CVE stands for Common Vulnerabilities and Exposures. Information from the [CVE record](https://www.cve.org/ResourcesSupport/Glossary) that describes this vulnerability.",
 "id": "Cve",
@@ -3586,6 +3660,10 @@
 "$ref": "CloudDlpInspection",
 "description": "Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding."
 },
+"complianceDetails": {
+"$ref": "ComplianceDetails",
+"description": "Details about the compliance implications of the finding."
+},
 "compliances": {
 "description": "Contains compliance information for security standards associated to the finding.",
 "items": {
@@ -3920,6 +3998,63 @@
 },
 "type": "object"
 },
+"Framework": {
+"description": "Compliance framework associated with the finding.",
+"id": "Framework",
+"properties": {
+"category": {
+"description": "Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads",
+"items": {
+"enum": [
+"FRAMEWORK_CATEGORY_UNSPECIFIED",
+"SECURITY_BENCHMARKS",
+"ASSURED_WORKLOADS",
+"DATA_SECURITY",
+"GOOGLE_BEST_PRACTICES"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"Security Benchmarks framework",
+"Assured Workloads framework",
+"Data Security framework",
+"Google Best Practices framework"
+],
+"type": "string"
+},
+"type": "array"
+},
+"controls": {
+"description": "The controls associated with the framework.",
+"items": {
+"$ref": "Control"
+},
+"type": "array"
+},
+"displayName": {
+"description": "Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework",
+"type": "string"
+},
+"name": {
+"description": "Name of the framework associated with the finding",
+"type": "string"
+},
+"type": {
+"description": "Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)",
+"enum": [
+"FRAMEWORK_TYPE_UNSPECIFIED",
+"FRAMEWORK_TYPE_BUILT_IN",
+"FRAMEWORK_TYPE_CUSTOM"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The framework is a built-in framework if it is created and managed by GCP.",
+"The framework is a custom framework if it is created and managed by the user."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GcpMetadata": {
 "description": "Google Cloud metadata associated with the resource. Only applicable if the finding's cloud provider is Google Cloud.",
 "id": "GcpMetadata",
@@ -5465,6 +5600,40 @@
 },
 "type": "object"
 },
+"GoogleCloudSecuritycenterV2CloudControl": {
+"description": "CloudControl associated with the finding.",
+"id": "GoogleCloudSecuritycenterV2CloudControl",
+"properties": {
+"cloudControlName": {
+"description": "Name of the CloudControl associated with the finding.",
+"type": "string"
+},
+"policyType": {
+"description": "Policy type of the CloudControl",
+"type": "string"
+},
+"type": {
+"description": "Type of cloud control.",
+"enum": [
+"CLOUD_CONTROL_TYPE_UNSPECIFIED",
+"BUILT_IN",
+"CUSTOM"
+],
+"enumDescriptions": [
+"Unspecified.",
+"Built in Cloud Control.",
+"Custom Cloud Control."
+],
+"type": "string"
+},
+"version": {
+"description": "Version of the Cloud Control",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
 "GoogleCloudSecuritycenterV2CloudDlpDataProfile": {
 "description": "The [data profile](https://cloud.google.com/dlp/docs/data-profiles) associated with the finding.",
 "id": "GoogleCloudSecuritycenterV2CloudDlpDataProfile",
@@ -5560,6 +5729,31 @@
 },
 "type": "object"
 },
+"GoogleCloudSecuritycenterV2ComplianceDetails": {
+"description": "Compliance Details associated with the finding.",
+"id": "GoogleCloudSecuritycenterV2ComplianceDetails",
+"properties": {
+"cloudControl": {
+"$ref": "GoogleCloudSecuritycenterV2CloudControl",
+"description": "CloudControl associated with the finding"
+},
+"cloudControlDeploymentNames": {
+"description": "Cloud Control Deployments associated with the finding. For example, organizations/123/locations/global/cloudControlDeployments/deploymentIdentifier",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"frameworks": {
+"description": "Details of Frameworks associated with the finding",
+"items": {
+"$ref": "GoogleCloudSecuritycenterV2Framework"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "GoogleCloudSecuritycenterV2Connection": {
 "description": "Contains information about the IP connection associated with the finding.",
 "id": "GoogleCloudSecuritycenterV2Connection",
@@ -5661,6 +5855,21 @@
 },
 "type": "object"
 },
+"GoogleCloudSecuritycenterV2Control": {
+"description": "Compliance control associated with the finding.",
+"id": "GoogleCloudSecuritycenterV2Control",
+"properties": {
+"controlName": {
+"description": "Name of the Control",
+"type": "string"
+},
+"displayName": {
+"description": "Display name of the control. For example, AU-02.",
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudSecuritycenterV2Cve": {
 "description": "CVE stands for Common Vulnerabilities and Exposures. Information from the [CVE record](https://www.cve.org/ResourcesSupport/Glossary) that describes this vulnerability.",
 "id": "GoogleCloudSecuritycenterV2Cve",
@@ -6373,6 +6582,10 @@
 "$ref": "GoogleCloudSecuritycenterV2CloudDlpInspection",
 "description": "Cloud Data Loss Prevention (Cloud DLP) inspection results that are associated with the finding."
 },
+"complianceDetails": {
+"$ref": "GoogleCloudSecuritycenterV2ComplianceDetails",
+"description": "Details about the compliance implications of the finding."
+},
 "compliances": {
 "description": "Contains compliance information for security standards associated to the finding.",
 "items": {
@@ -6709,6 +6922,63 @@
 },
 "type": "object"
 },
+"GoogleCloudSecuritycenterV2Framework": {
+"description": "Compliance framework associated with the finding.",
+"id": "GoogleCloudSecuritycenterV2Framework",
+"properties": {
+"category": {
+"description": "Category of the framework associated with the finding. E.g. Security Benchmark, or Assured Workloads",
+"items": {
+"enum": [
+"FRAMEWORK_CATEGORY_UNSPECIFIED",
+"SECURITY_BENCHMARKS",
+"ASSURED_WORKLOADS",
+"DATA_SECURITY",
+"GOOGLE_BEST_PRACTICES"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"Security Benchmarks framework",
+"Assured Workloads framework",
+"Data Security framework",
+"Google Best Practices framework"
+],
+"type": "string"
+},
+"type": "array"
+},
+"controls": {
+"description": "The controls associated with the framework.",
+"items": {
+"$ref": "GoogleCloudSecuritycenterV2Control"
+},
+"type": "array"
+},
+"displayName": {
+"description": "Display name of the framework. For a standard framework, this will look like e.g. PCI DSS 3.2.1, whereas for a custom framework it can be a user defined string like MyFramework",
+"type": "string"
+},
+"name": {
+"description": "Name of the framework associated with the finding",
+"type": "string"
+},
+"type": {
+"description": "Type of the framework associated with the finding, to specify whether the framework is built-in (pre-defined and immutable) or a custom framework defined by the customer (equivalent to security posture)",
+"enum": [
+"FRAMEWORK_TYPE_UNSPECIFIED",
+"FRAMEWORK_TYPE_BUILT_IN",
+"FRAMEWORK_TYPE_CUSTOM"
+],
+"enumDescriptions": [
+"Default value. This value is unused.",
+"The framework is a built-in framework if it is created and managed by GCP.",
+"The framework is a custom framework if it is created and managed by the user."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudSecuritycenterV2Geolocation": {
 "description": "Represents a geographical location for a given access.",
 "id": "GoogleCloudSecuritycenterV2Geolocation",
@@ -8601,7 +8871,7 @@
 },
 "gcpMetadata": {
 "$ref": "GcpMetadata",
-"description": "The GCP metadata associated with the finding."
+"description": "The Google Cloud metadata associated with the finding."
 },
 "location": {
 "description": "The region or location of the service (if applicable).",

From 0dc0025ccc0072ead1b960a0eaec36660e20ff45 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:13 +0000
Subject: [PATCH 29/36] feat(serviceconsumermanagement): update the api

#### serviceconsumermanagement:v1

The following keys were added:
- schemas.PhpSettings.properties.libraryPackage.type (Total Keys: 1)

#### serviceconsumermanagement:v1beta1

The following keys were added:
- schemas.PhpSettings.properties.libraryPackage.type (Total Keys: 1)
---
 .../documents/serviceconsumermanagement.v1.json             | 6 +++++-
 .../documents/serviceconsumermanagement.v1beta1.json        | 6 +++++-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1.json b/googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1.json
index 9a078b38527..a32360d08c7 100644
--- a/googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1.json
+++ b/googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1.json
@@ -542,7 +542,7 @@
 }
 }
 },
-"revision": "20250515",
+"revision": "20250619",
 "rootUrl": "https://serviceconsumermanagement.googleapis.com/",
 "schemas": {
 "AddTenantProjectRequest": {
@@ -2390,6 +2390,10 @@
 "common": {
 "$ref": "CommonLanguageSettings",
 "description": "Some settings."
+},
+"libraryPackage": {
+"description": "The package name to use in Php. Clobbers the php_namespace option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.php.package_name\" field in gapic.yaml. API teams should use the protobuf php_namespace option where possible. Example of a YAML configuration:: publishing: library_settings: php_settings: library_package: Google\\Cloud\\PubSub\\V1",
+"type": "string"
 }
 },
 "type": "object"
diff --git a/googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1beta1.json b/googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1beta1.json
index 3cc6cec43c8..e5d6b274460 100644
--- a/googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/serviceconsumermanagement.v1beta1.json
@@ -724,7 +724,7 @@
 }
 }
 },
-"revision": "20250515",
+"revision": "20250619",
 "rootUrl": "https://serviceconsumermanagement.googleapis.com/",
 "schemas": {
 "Api": {
@@ -2448,6 +2448,10 @@
 "common": {
 "$ref": "CommonLanguageSettings",
 "description": "Some settings."
+},
+"libraryPackage": {
+"description": "The package name to use in Php. Clobbers the php_namespace option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.php.package_name\" field in gapic.yaml. API teams should use the protobuf php_namespace option where possible. Example of a YAML configuration:: publishing: library_settings: php_settings: library_package: Google\\Cloud\\PubSub\\V1",
+"type": "string"
 }
 },
 "type": "object"

From a29f62ac7ad4e23efef6f1a799b79d3c553111c8 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:14 +0000
Subject: [PATCH 30/36] feat(servicenetworking): update the api

#### servicenetworking:v1

The following keys were added:
- schemas.Method.properties.edition.deprecated (Total Keys: 1)
- schemas.Method.properties.syntax.deprecated (Total Keys: 1)

#### servicenetworking:v1beta

The following keys were added:
- schemas.Method.properties.edition.deprecated (Total Keys: 1)
- schemas.Method.properties.syntax.deprecated (Total Keys: 1)
---
 .../documents/servicenetworking.v1.json       | 22 ++++++++++---------
 .../documents/servicenetworking.v1beta.json   | 22 ++++++++++---------
 2 files changed, 24 insertions(+), 20 deletions(-)

diff --git a/googleapiclient/discovery_cache/documents/servicenetworking.v1.json b/googleapiclient/discovery_cache/documents/servicenetworking.v1.json
index c14765b3cb7..faa0c4fd11f 100644
--- a/googleapiclient/discovery_cache/documents/servicenetworking.v1.json
+++ b/googleapiclient/discovery_cache/documents/servicenetworking.v1.json
@@ -1029,7 +1029,7 @@
 }
 }
 },
-"revision": "20250713",
+"revision": "20250722",
 "rootUrl": "https://servicenetworking.googleapis.com/",
 "schemas": {
 "AddDnsRecordSetMetadata": {
@@ -1234,7 +1234,7 @@
 "type": "object"
 },
 "Api": {
-"description": "Api is a light-weight descriptor for an API Interface. Interfaces are also described as \"protocol buffer services\" in some contexts, such as by the \"service\" keyword in a .proto file, but they are different from API Services, which represent a concrete implementation of an interface as opposed to simply a description of methods and bindings. They are also sometimes simply referred to as \"APIs\" in other contexts, such as the name of this message itself. See https://cloud.google.com/apis/design/glossary for detailed terminology.",
+"description": "Api is a light-weight descriptor for an API Interface. Interfaces are also described as \"protocol buffer services\" in some contexts, such as by the \"service\" keyword in a .proto file, but they are different from API Services, which represent a concrete implementation of an interface as opposed to simply a description of methods and bindings. They are also sometimes simply referred to as \"APIs\" in other contexts, such as the name of this message itself. See https://cloud.google.com/apis/design/glossary for detailed terminology. New usages of this message as an alternative to ServiceDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.",
 "id": "Api",
 "properties": {
 "edition": {
@@ -2254,7 +2254,7 @@
 "type": "object"
 },
 "Enum": {
-"description": "Enum type definition.",
+"description": "Enum type definition. New usages of this message as an alternative to EnumDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.",
 "id": "Enum",
 "properties": {
 "edition": {
@@ -2301,7 +2301,7 @@
 "type": "object"
 },
 "EnumValue": {
-"description": "Enum value definition.",
+"description": "Enum value definition. New usages of this message as an alternative to EnumValueDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.",
 "id": "EnumValue",
 "properties": {
 "name": {
@@ -2343,7 +2343,7 @@
 "type": "object"
 },
 "Field": {
-"description": "A single field of a message type.",
+"description": "A single field of a message type. New usages of this message as an alternative to FieldDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.",
 "id": "Field",
 "properties": {
 "cardinality": {
@@ -2878,11 +2878,12 @@
 "type": "object"
 },
 "Method": {
-"description": "Method represents a method of an API interface.",
+"description": "Method represents a method of an API interface. New usages of this message as an alternative to MethodDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.",
 "id": "Method",
 "properties": {
 "edition": {
-"description": "The source edition string, only valid when syntax is SYNTAX_EDITIONS.",
+"deprecated": true,
+"description": "The source edition string, only valid when syntax is SYNTAX_EDITIONS. This field should be ignored, instead the edition should be inherited from Api. This is similar to Field and EnumValue.",
 "type": "string"
 },
 "name": {
@@ -2913,7 +2914,8 @@
 "type": "string"
 },
 "syntax": {
-"description": "The source syntax of this method.",
+"deprecated": true,
+"description": "The source syntax of this method. This field should be ignored, instead the syntax should be inherited from Api. This is similar to Field and EnumValue.",
 "enum": [
 "SYNTAX_PROTO2",
 "SYNTAX_PROTO3",
@@ -3326,7 +3328,7 @@
 "type": "object"
 },
 "Option": {
-"description": "A protocol buffer option, which can be attached to a message, field, enumeration, etc.",
+"description": "A protocol buffer option, which can be attached to a message, field, enumeration, etc. New usages of this message as an alternative to FileOptions, MessageOptions, FieldOptions, EnumOptions, EnumValueOptions, ServiceOptions, or MethodOptions are strongly discouraged.",
 "id": "Option",
 "properties": {
 "name": {
@@ -4098,7 +4100,7 @@
 "type": "object"
 },
 "Type": {
-"description": "A protocol buffer message type.",
+"description": "A protocol buffer message type. New usages of this message as an alternative to DescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.",
 "id": "Type",
 "properties": {
 "edition": {
diff --git a/googleapiclient/discovery_cache/documents/servicenetworking.v1beta.json b/googleapiclient/discovery_cache/documents/servicenetworking.v1beta.json
index 167bfc4e780..cdb5a0cbbfa 100644
--- a/googleapiclient/discovery_cache/documents/servicenetworking.v1beta.json
+++ b/googleapiclient/discovery_cache/documents/servicenetworking.v1beta.json
@@ -307,7 +307,7 @@
 }
 }
 },
-"revision": "20250713",
+"revision": "20250722",
 "rootUrl": "https://servicenetworking.googleapis.com/",
 "schemas": {
 "AddDnsRecordSetMetadata": {
@@ -401,7 +401,7 @@
 "type": "object"
 },
 "Api": {
-"description": "Api is a light-weight descriptor for an API Interface. Interfaces are also described as \"protocol buffer services\" in some contexts, such as by the \"service\" keyword in a .proto file, but they are different from API Services, which represent a concrete implementation of an interface as opposed to simply a description of methods and bindings. They are also sometimes simply referred to as \"APIs\" in other contexts, such as the name of this message itself. See https://cloud.google.com/apis/design/glossary for detailed terminology.",
+"description": "Api is a light-weight descriptor for an API Interface. Interfaces are also described as \"protocol buffer services\" in some contexts, such as by the \"service\" keyword in a .proto file, but they are different from API Services, which represent a concrete implementation of an interface as opposed to simply a description of methods and bindings. They are also sometimes simply referred to as \"APIs\" in other contexts, such as the name of this message itself. See https://cloud.google.com/apis/design/glossary for detailed terminology. New usages of this message as an alternative to ServiceDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.",
 "id": "Api",
 "properties": {
 "edition": {
@@ -1349,7 +1349,7 @@
 "type": "object"
 },
 "Enum": {
-"description": "Enum type definition.",
+"description": "Enum type definition. New usages of this message as an alternative to EnumDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.",
 "id": "Enum",
 "properties": {
 "edition": {
@@ -1396,7 +1396,7 @@
 "type": "object"
 },
 "EnumValue": {
-"description": "Enum value definition.",
+"description": "Enum value definition. New usages of this message as an alternative to EnumValueDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.",
 "id": "EnumValue",
 "properties": {
 "name": {
@@ -1438,7 +1438,7 @@
 "type": "object"
 },
 "Field": {
-"description": "A single field of a message type.",
+"description": "A single field of a message type. New usages of this message as an alternative to FieldDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.",
 "id": "Field",
 "properties": {
 "cardinality": {
@@ -1898,11 +1898,12 @@
 "type": "object"
 },
 "Method": {
-"description": "Method represents a method of an API interface.",
+"description": "Method represents a method of an API interface. New usages of this message as an alternative to MethodDescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.",
 "id": "Method",
 "properties": {
 "edition": {
-"description": "The source edition string, only valid when syntax is SYNTAX_EDITIONS.",
+"deprecated": true,
+"description": "The source edition string, only valid when syntax is SYNTAX_EDITIONS. This field should be ignored, instead the edition should be inherited from Api. This is similar to Field and EnumValue.",
 "type": "string"
 },
 "name": {
@@ -1933,7 +1934,8 @@
 "type": "string"
 },
 "syntax": {
-"description": "The source syntax of this method.",
+"deprecated": true,
+"description": "The source syntax of this method. This field should be ignored, instead the syntax should be inherited from Api. This is similar to Field and EnumValue.",
 "enum": [
 "SYNTAX_PROTO2",
 "SYNTAX_PROTO3",
@@ -2346,7 +2348,7 @@
 "type": "object"
 },
 "Option": {
-"description": "A protocol buffer option, which can be attached to a message, field, enumeration, etc.",
+"description": "A protocol buffer option, which can be attached to a message, field, enumeration, etc. New usages of this message as an alternative to FileOptions, MessageOptions, FieldOptions, EnumOptions, EnumValueOptions, ServiceOptions, or MethodOptions are strongly discouraged.",
 "id": "Option",
 "properties": {
 "name": {
@@ -3027,7 +3029,7 @@
 "type": "object"
 },
 "Type": {
-"description": "A protocol buffer message type.",
+"description": "A protocol buffer message type. New usages of this message as an alternative to DescriptorProto are strongly discouraged. This message does not reliability preserve all information necessary to model the schema and preserve semantics. Instead make use of FileDescriptorSet which preserves the necessary information.",
 "id": "Type",
 "properties": {
 "edition": {

From 575b01176d531e0ce14312390e82c912dbc9b84f Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:14 +0000
Subject: [PATCH 31/36] feat(serviceusage): update the api

#### serviceusage:v1

The following keys were added:
- schemas.PhpSettings.properties.libraryPackage.type (Total Keys: 1)

#### serviceusage:v1beta1

The following keys were added:
- schemas.PhpSettings.properties.libraryPackage.type (Total Keys: 1)
---
 .../discovery_cache/documents/serviceusage.v1.json          | 6 +++++-
 .../discovery_cache/documents/serviceusage.v1beta1.json     | 6 +++++-
 2 files changed, 10 insertions(+), 2 deletions(-)

diff --git a/googleapiclient/discovery_cache/documents/serviceusage.v1.json b/googleapiclient/discovery_cache/documents/serviceusage.v1.json
index e4e278c19cc..b3c50794101 100644
--- a/googleapiclient/discovery_cache/documents/serviceusage.v1.json
+++ b/googleapiclient/discovery_cache/documents/serviceusage.v1.json
@@ -426,7 +426,7 @@
 }
 }
 },
-"revision": "20250515",
+"revision": "20250619",
 "rootUrl": "https://serviceusage.googleapis.com/",
 "schemas": {
 "AddEnableRulesMetadata": {
@@ -3222,6 +3222,10 @@
 "common": {
 "$ref": "CommonLanguageSettings",
 "description": "Some settings."
+},
+"libraryPackage": {
+"description": "The package name to use in Php. Clobbers the php_namespace option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.php.package_name\" field in gapic.yaml. API teams should use the protobuf php_namespace option where possible. Example of a YAML configuration:: publishing: library_settings: php_settings: library_package: Google\\Cloud\\PubSub\\V1",
+"type": "string"
 }
 },
 "type": "object"
diff --git a/googleapiclient/discovery_cache/documents/serviceusage.v1beta1.json b/googleapiclient/discovery_cache/documents/serviceusage.v1beta1.json
index 36d9ded1374..8ebdd8e5a7f 100644
--- a/googleapiclient/discovery_cache/documents/serviceusage.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/serviceusage.v1beta1.json
@@ -964,7 +964,7 @@
 }
 }
 },
-"revision": "20250515",
+"revision": "20250619",
 "rootUrl": "https://serviceusage.googleapis.com/",
 "schemas": {
 "AddEnableRulesMetadata": {
@@ -3931,6 +3931,10 @@
 "common": {
 "$ref": "CommonLanguageSettings",
 "description": "Some settings."
+},
+"libraryPackage": {
+"description": "The package name to use in Php. Clobbers the php_namespace option set in the protobuf. This should be used **only** by APIs who have already set the language_settings.php.package_name\" field in gapic.yaml. API teams should use the protobuf php_namespace option where possible. Example of a YAML configuration:: publishing: library_settings: php_settings: library_package: Google\\Cloud\\PubSub\\V1",
+"type": "string"
 }
 },
 "type": "object"

From bef3e004b437408880a95f7752241f7d92c74fe9 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:14 +0000
Subject: [PATCH 32/36] feat(storage): update the api

#### storage:v1

The following keys were added:
- schemas.Bucket.properties.encryption.properties.customerManagedEncryptionEnforcementConfig (Total Keys: 4)
- schemas.Bucket.properties.encryption.properties.customerSuppliedEncryptionEnforcementConfig (Total Keys: 4)
- schemas.Bucket.properties.encryption.properties.googleManagedEncryptionEnforcementConfig (Total Keys: 4)
---
 docs/dyn/storage_v1.buckets.html              | 120 ++++++++++++++++++
 .../discovery_cache/documents/storage.v1.json |  73 ++++++++++-
 2 files changed, 191 insertions(+), 2 deletions(-)

diff --git a/docs/dyn/storage_v1.buckets.html b/docs/dyn/storage_v1.buckets.html
index e62181c1487..89040c890d7 100644
--- a/docs/dyn/storage_v1.buckets.html
+++ b/docs/dyn/storage_v1.buckets.html
@@ -247,7 +247,19 @@ 
Method Details

     },
   ],
   "encryption": { # Encryption configuration for a bucket.
+    "customerManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Managed Encryption Keys. Defaults to NotRestricted.
+    },
+    "customerSuppliedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Supplied Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Supplied Encryption Keys. Defaults to NotRestricted.
+    },
     "defaultKmsKeyName": "A String", # A Cloud KMS key that will be used to encrypt objects inserted into this bucket, if no encryption method is specified.
+    "googleManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Google Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Google-Managed Encryption Keys. Defaults to NotRestricted.
+    },
   },
   "etag": "A String", # HTTP 1.1 Entity tag for the bucket.
   "generation": "A String", # The generation of this bucket.
@@ -542,7 +554,19 @@ 
Method Details

     },
   ],
   "encryption": { # Encryption configuration for a bucket.
+    "customerManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Managed Encryption Keys. Defaults to NotRestricted.
+    },
+    "customerSuppliedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Supplied Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Supplied Encryption Keys. Defaults to NotRestricted.
+    },
     "defaultKmsKeyName": "A String", # A Cloud KMS key that will be used to encrypt objects inserted into this bucket, if no encryption method is specified.
+    "googleManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Google Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Google-Managed Encryption Keys. Defaults to NotRestricted.
+    },
   },
   "etag": "A String", # HTTP 1.1 Entity tag for the bucket.
   "generation": "A String", # The generation of this bucket.
@@ -772,7 +796,19 @@ 
Method Details

     },
   ],
   "encryption": { # Encryption configuration for a bucket.
+    "customerManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Managed Encryption Keys. Defaults to NotRestricted.
+    },
+    "customerSuppliedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Supplied Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Supplied Encryption Keys. Defaults to NotRestricted.
+    },
     "defaultKmsKeyName": "A String", # A Cloud KMS key that will be used to encrypt objects inserted into this bucket, if no encryption method is specified.
+    "googleManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Google Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Google-Managed Encryption Keys. Defaults to NotRestricted.
+    },
   },
   "etag": "A String", # HTTP 1.1 Entity tag for the bucket.
   "generation": "A String", # The generation of this bucket.
@@ -999,7 +1035,19 @@ 
Method Details

         },
       ],
       "encryption": { # Encryption configuration for a bucket.
+        "customerManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Managed Encryption type by default.
+          "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+          "restrictionMode": "A String", # Restriction mode for Customer-Managed Encryption Keys. Defaults to NotRestricted.
+        },
+        "customerSuppliedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Supplied Encryption type by default.
+          "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+          "restrictionMode": "A String", # Restriction mode for Customer-Supplied Encryption Keys. Defaults to NotRestricted.
+        },
         "defaultKmsKeyName": "A String", # A Cloud KMS key that will be used to encrypt objects inserted into this bucket, if no encryption method is specified.
+        "googleManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Google Managed Encryption type by default.
+          "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+          "restrictionMode": "A String", # Restriction mode for Google-Managed Encryption Keys. Defaults to NotRestricted.
+        },
       },
       "etag": "A String", # HTTP 1.1 Entity tag for the bucket.
       "generation": "A String", # The generation of this bucket.
@@ -1235,7 +1283,19 @@ 
Method Details

     },
   ],
   "encryption": { # Encryption configuration for a bucket.
+    "customerManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Managed Encryption Keys. Defaults to NotRestricted.
+    },
+    "customerSuppliedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Supplied Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Supplied Encryption Keys. Defaults to NotRestricted.
+    },
     "defaultKmsKeyName": "A String", # A Cloud KMS key that will be used to encrypt objects inserted into this bucket, if no encryption method is specified.
+    "googleManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Google Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Google-Managed Encryption Keys. Defaults to NotRestricted.
+    },
   },
   "etag": "A String", # HTTP 1.1 Entity tag for the bucket.
   "generation": "A String", # The generation of this bucket.
@@ -1450,7 +1510,19 @@ 
Method Details

     },
   ],
   "encryption": { # Encryption configuration for a bucket.
+    "customerManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Managed Encryption Keys. Defaults to NotRestricted.
+    },
+    "customerSuppliedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Supplied Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Supplied Encryption Keys. Defaults to NotRestricted.
+    },
     "defaultKmsKeyName": "A String", # A Cloud KMS key that will be used to encrypt objects inserted into this bucket, if no encryption method is specified.
+    "googleManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Google Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Google-Managed Encryption Keys. Defaults to NotRestricted.
+    },
   },
   "etag": "A String", # HTTP 1.1 Entity tag for the bucket.
   "generation": "A String", # The generation of this bucket.
@@ -1681,7 +1753,19 @@ 
Method Details

     },
   ],
   "encryption": { # Encryption configuration for a bucket.
+    "customerManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Managed Encryption Keys. Defaults to NotRestricted.
+    },
+    "customerSuppliedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Supplied Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Supplied Encryption Keys. Defaults to NotRestricted.
+    },
     "defaultKmsKeyName": "A String", # A Cloud KMS key that will be used to encrypt objects inserted into this bucket, if no encryption method is specified.
+    "googleManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Google Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Google-Managed Encryption Keys. Defaults to NotRestricted.
+    },
   },
   "etag": "A String", # HTTP 1.1 Entity tag for the bucket.
   "generation": "A String", # The generation of this bucket.
@@ -1949,7 +2033,19 @@ 
Method Details

     },
   ],
   "encryption": { # Encryption configuration for a bucket.
+    "customerManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Managed Encryption Keys. Defaults to NotRestricted.
+    },
+    "customerSuppliedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Supplied Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Supplied Encryption Keys. Defaults to NotRestricted.
+    },
     "defaultKmsKeyName": "A String", # A Cloud KMS key that will be used to encrypt objects inserted into this bucket, if no encryption method is specified.
+    "googleManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Google Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Google-Managed Encryption Keys. Defaults to NotRestricted.
+    },
   },
   "etag": "A String", # HTTP 1.1 Entity tag for the bucket.
   "generation": "A String", # The generation of this bucket.
@@ -2299,7 +2395,19 @@ 
Method Details

     },
   ],
   "encryption": { # Encryption configuration for a bucket.
+    "customerManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Managed Encryption Keys. Defaults to NotRestricted.
+    },
+    "customerSuppliedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Supplied Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Supplied Encryption Keys. Defaults to NotRestricted.
+    },
     "defaultKmsKeyName": "A String", # A Cloud KMS key that will be used to encrypt objects inserted into this bucket, if no encryption method is specified.
+    "googleManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Google Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Google-Managed Encryption Keys. Defaults to NotRestricted.
+    },
   },
   "etag": "A String", # HTTP 1.1 Entity tag for the bucket.
   "generation": "A String", # The generation of this bucket.
@@ -2530,7 +2638,19 @@ 
Method Details

     },
   ],
   "encryption": { # Encryption configuration for a bucket.
+    "customerManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Managed Encryption Keys. Defaults to NotRestricted.
+    },
+    "customerSuppliedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Supplied Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Customer-Supplied Encryption Keys. Defaults to NotRestricted.
+    },
     "defaultKmsKeyName": "A String", # A Cloud KMS key that will be used to encrypt objects inserted into this bucket, if no encryption method is specified.
+    "googleManagedEncryptionEnforcementConfig": { # If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Google Managed Encryption type by default.
+      "effectiveTime": "A String", # Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.
+      "restrictionMode": "A String", # Restriction mode for Google-Managed Encryption Keys. Defaults to NotRestricted.
+    },
   },
   "etag": "A String", # HTTP 1.1 Entity tag for the bucket.
   "generation": "A String", # The generation of this bucket.
diff --git a/googleapiclient/discovery_cache/documents/storage.v1.json b/googleapiclient/discovery_cache/documents/storage.v1.json
index 907b528155b..3f7c9cfbf90 100644
--- a/googleapiclient/discovery_cache/documents/storage.v1.json
+++ b/googleapiclient/discovery_cache/documents/storage.v1.json
@@ -253,7 +253,7 @@
 "location": "northamerica-south1"
 }
 ],
-"etag": "\"31353834363234393531343533373938353433\"",
+"etag": "\"31383438373536343936353833383831333836\"",
 "icons": {
 "x16": "https://www.google.com/images/icons/product/cloud_storage-16.png",
 "x32": "https://www.google.com/images/icons/product/cloud_storage-32.png"
@@ -4544,7 +4544,7 @@
 }
 }
 },
-"revision": "20250629",
+"revision": "20250718",
 "rootUrl": "https://storage.googleapis.com/",
 "schemas": {
 "AdvanceRelocateBucketOperationRequest": {
@@ -4758,9 +4758,78 @@
 "encryption": {
 "description": "Encryption configuration for a bucket.",
 "properties": {
+"customerManagedEncryptionEnforcementConfig": {
+"description": "If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Managed Encryption type by default.",
+"properties": {
+"effectiveTime": {
+"description": "Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.",
+"format": "date-time",
+"type": "string"
+},
+"restrictionMode": {
+"description": "Restriction mode for Customer-Managed Encryption Keys. Defaults to NotRestricted.",
+"enum": [
+"NotRestricted",
+"FullyRestricted"
+],
+"enumDescriptions": [
+"Creation of new objects with Customer-Managed Encryption is not restricted.",
+"Creation of new objects with Customer-Managed Encryption is fully restricted."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"customerSuppliedEncryptionEnforcementConfig": {
+"description": "If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Customer Supplied Encryption type by default.",
+"properties": {
+"effectiveTime": {
+"description": "Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.",
+"format": "date-time",
+"type": "string"
+},
+"restrictionMode": {
+"description": "Restriction mode for Customer-Supplied Encryption Keys. Defaults to NotRestricted.",
+"enum": [
+"NotRestricted",
+"FullyRestricted"
+],
+"enumDescriptions": [
+"Creation of new objects with Customer-Supplied Encryption is not restricted.",
+"Creation of new objects with Customer-Supplied Encryption is fully restricted."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "defaultKmsKeyName": {
 "description": "A Cloud KMS key that will be used to encrypt objects inserted into this bucket, if no encryption method is specified.",
 "type": "string"
+},
+"googleManagedEncryptionEnforcementConfig": {
+"description": "If set, the new objects created in this bucket must comply with this enforcement config. Changing this has no effect on existing objects; it applies to new objects only. If omitted, the new objects are allowed to be encrypted with Google Managed Encryption type by default.",
+"properties": {
+"effectiveTime": {
+"description": "Server-determined value that indicates the time from which configuration was enforced and effective. This value is in RFC 3339 format.",
+"format": "date-time",
+"type": "string"
+},
+"restrictionMode": {
+"description": "Restriction mode for Google-Managed Encryption Keys. Defaults to NotRestricted.",
+"enum": [
+"NotRestricted",
+"FullyRestricted"
+],
+"enumDescriptions": [
+"Creation of new objects with Google Managed Encryption is not restricted.",
+"Creation of new objects with Google Managed Encryption is fully restricted."
+],
+"type": "string"
+}
+},
+"type": "object"
 }
 },
 "type": "object"

From e3ac88a91db0699462f6ef2988b0203932d92261 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:14 +0000
Subject: [PATCH 33/36] feat(videointelligence): update the api

#### videointelligence:v1

The following keys were added:
- schemas.GoogleCloudVideointelligenceV1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1beta2_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1p1beta1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1p2beta1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1p3beta1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)

#### videointelligence:v1beta2

The following keys were added:
- schemas.GoogleCloudVideointelligenceV1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1beta2_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1p1beta1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1p2beta1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1p3beta1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)

#### videointelligence:v1p1beta1

The following keys were added:
- schemas.GoogleCloudVideointelligenceV1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1beta2_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1p1beta1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1p2beta1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1p3beta1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)

#### videointelligence:v1p2beta1

The following keys were added:
- schemas.GoogleCloudVideointelligenceV1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1beta2_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1p1beta1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1p2beta1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1p3beta1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)

#### videointelligence:v1p3beta1

The following keys were added:
- schemas.GoogleCloudVideointelligenceV1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1beta2_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1p1beta1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1p2beta1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
- schemas.GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus (Total Keys: 6)
- schemas.GoogleCloudVideointelligenceV1p3beta1_VideoAnnotationProgress.properties.exportStatus.$ref (Total Keys: 1)
---
 .../documents/videointelligence.v1.json       | 177 ++++++++++++++++--
 .../documents/videointelligence.v1beta2.json  | 177 ++++++++++++++++--
 .../videointelligence.v1p1beta1.json          | 177 ++++++++++++++++--
 .../videointelligence.v1p2beta1.json          | 177 ++++++++++++++++--
 .../videointelligence.v1p3beta1.json          | 177 ++++++++++++++++--
 5 files changed, 830 insertions(+), 55 deletions(-)

diff --git a/googleapiclient/discovery_cache/documents/videointelligence.v1.json b/googleapiclient/discovery_cache/documents/videointelligence.v1.json
index 78290577940..a17318846ed 100644
--- a/googleapiclient/discovery_cache/documents/videointelligence.v1.json
+++ b/googleapiclient/discovery_cache/documents/videointelligence.v1.json
@@ -350,7 +350,7 @@
 }
 }
 },
-"revision": "20250710",
+"revision": "20250724",
 "rootUrl": "https://videointelligence.googleapis.com/",
 "schemas": {
 "GoogleCloudVideointelligenceV1_AnnotateVideoProgress": {
@@ -475,7 +475,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -560,6 +560,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -823,7 +850,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -1217,6 +1244,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -1545,7 +1576,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1beta2_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -1619,6 +1650,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1beta2_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -1822,7 +1880,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1beta2_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1beta2_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -2091,6 +2149,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1beta2_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -2373,7 +2435,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1p1beta1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -2447,6 +2509,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -2650,7 +2739,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1p1beta1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1p1beta1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -2919,6 +3008,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1p1beta1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -3201,7 +3294,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1p2beta1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -3275,6 +3368,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -3478,7 +3598,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1p2beta1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1p2beta1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -3747,6 +3867,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1p2beta1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -4084,7 +4208,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1p3beta1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -4158,6 +4282,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -4361,7 +4512,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1p3beta1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1p3beta1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -4702,6 +4853,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1p3beta1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
diff --git a/googleapiclient/discovery_cache/documents/videointelligence.v1beta2.json b/googleapiclient/discovery_cache/documents/videointelligence.v1beta2.json
index 60f8c96f6fc..32a856609ab 100644
--- a/googleapiclient/discovery_cache/documents/videointelligence.v1beta2.json
+++ b/googleapiclient/discovery_cache/documents/videointelligence.v1beta2.json
@@ -128,7 +128,7 @@
 }
 }
 },
-"revision": "20250710",
+"revision": "20250724",
 "rootUrl": "https://videointelligence.googleapis.com/",
 "schemas": {
 "GoogleCloudVideointelligenceV1_AnnotateVideoProgress": {
@@ -194,7 +194,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -268,6 +268,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -471,7 +498,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -740,6 +767,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -1081,7 +1112,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1beta2_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -1166,6 +1197,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1beta2_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -1429,7 +1487,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1beta2_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1beta2_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -1823,6 +1881,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1beta2_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -2151,7 +2213,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1p1beta1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -2225,6 +2287,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -2428,7 +2517,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1p1beta1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1p1beta1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -2697,6 +2786,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1p1beta1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -2979,7 +3072,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1p2beta1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -3053,6 +3146,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -3256,7 +3376,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1p2beta1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1p2beta1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -3525,6 +3645,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1p2beta1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -3862,7 +3986,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1p3beta1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -3936,6 +4060,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -4139,7 +4290,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1p3beta1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1p3beta1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -4480,6 +4631,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1p3beta1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
diff --git a/googleapiclient/discovery_cache/documents/videointelligence.v1p1beta1.json b/googleapiclient/discovery_cache/documents/videointelligence.v1p1beta1.json
index dd137b4eab4..502afdb2ee8 100644
--- a/googleapiclient/discovery_cache/documents/videointelligence.v1p1beta1.json
+++ b/googleapiclient/discovery_cache/documents/videointelligence.v1p1beta1.json
@@ -128,7 +128,7 @@
 }
 }
 },
-"revision": "20250710",
+"revision": "20250724",
 "rootUrl": "https://videointelligence.googleapis.com/",
 "schemas": {
 "GoogleCloudVideointelligenceV1_AnnotateVideoProgress": {
@@ -194,7 +194,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -268,6 +268,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -471,7 +498,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -740,6 +767,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -1022,7 +1053,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1beta2_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -1096,6 +1127,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1beta2_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -1299,7 +1357,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1beta2_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1beta2_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -1568,6 +1626,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1beta2_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -1909,7 +1971,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1p1beta1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -1994,6 +2056,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -2257,7 +2346,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1p1beta1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1p1beta1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -2651,6 +2740,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1p1beta1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -2979,7 +3072,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1p2beta1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -3053,6 +3146,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -3256,7 +3376,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1p2beta1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1p2beta1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -3525,6 +3645,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1p2beta1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -3862,7 +3986,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1p3beta1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -3936,6 +4060,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -4139,7 +4290,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1p3beta1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1p3beta1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -4480,6 +4631,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1p3beta1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
diff --git a/googleapiclient/discovery_cache/documents/videointelligence.v1p2beta1.json b/googleapiclient/discovery_cache/documents/videointelligence.v1p2beta1.json
index 3b966bdc88f..13a94800b02 100644
--- a/googleapiclient/discovery_cache/documents/videointelligence.v1p2beta1.json
+++ b/googleapiclient/discovery_cache/documents/videointelligence.v1p2beta1.json
@@ -128,7 +128,7 @@
 }
 }
 },
-"revision": "20250710",
+"revision": "20250724",
 "rootUrl": "https://videointelligence.googleapis.com/",
 "schemas": {
 "GoogleCloudVideointelligenceV1_AnnotateVideoProgress": {
@@ -194,7 +194,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -268,6 +268,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -471,7 +498,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -740,6 +767,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -1022,7 +1053,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1beta2_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -1096,6 +1127,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1beta2_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -1299,7 +1357,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1beta2_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1beta2_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -1568,6 +1626,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1beta2_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -1850,7 +1912,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1p1beta1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -1924,6 +1986,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -2127,7 +2216,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1p1beta1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1p1beta1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -2396,6 +2485,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1p1beta1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -2737,7 +2830,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1p2beta1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -2822,6 +2915,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -3085,7 +3205,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1p2beta1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1p2beta1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -3479,6 +3599,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1p2beta1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -3862,7 +3986,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1p3beta1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -3936,6 +4060,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -4139,7 +4290,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1p3beta1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1p3beta1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -4480,6 +4631,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1p3beta1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
diff --git a/googleapiclient/discovery_cache/documents/videointelligence.v1p3beta1.json b/googleapiclient/discovery_cache/documents/videointelligence.v1p3beta1.json
index 3e6ccac8d30..23045257e34 100644
--- a/googleapiclient/discovery_cache/documents/videointelligence.v1p3beta1.json
+++ b/googleapiclient/discovery_cache/documents/videointelligence.v1p3beta1.json
@@ -128,7 +128,7 @@
 }
 }
 },
-"revision": "20250710",
+"revision": "20250724",
 "rootUrl": "https://videointelligence.googleapis.com/",
 "schemas": {
 "GoogleCloudVideointelligenceV1_AnnotateVideoProgress": {
@@ -194,7 +194,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -268,6 +268,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -471,7 +498,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -740,6 +767,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -1022,7 +1053,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1beta2_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -1096,6 +1127,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1beta2_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -1299,7 +1357,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1beta2_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1beta2_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -1568,6 +1626,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1beta2_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1beta2_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -1850,7 +1912,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1p1beta1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -1924,6 +1986,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1p1beta1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -2127,7 +2216,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1p1beta1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1p1beta1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -2396,6 +2485,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1p1beta1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1p1beta1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -2678,7 +2771,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1p2beta1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -2752,6 +2845,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1p2beta1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -2955,7 +3075,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1p2beta1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1p2beta1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -3224,6 +3344,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1p2beta1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1p2beta1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [
@@ -3622,7 +3746,7 @@
 },
 "point": {
 "$ref": "GoogleCloudVideointelligenceV1p3beta1_NormalizedVertex",
-"description": "The 2D point of the detected landmark using the normalized image coordindate system. The normalized coordinates have the range from 0 to 1."
+"description": "The 2D point of the detected landmark using the normalized image coordinate system. The normalized coordinates have the range from 0 to 1."
 }
 },
 "type": "object"
@@ -3707,6 +3831,33 @@
 },
 "type": "object"
 },
+"GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus": {
+"description": "Status of exporting annotation response to user specified `output_uri`.",
+"id": "GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus",
+"properties": {
+"state": {
+"description": "Output only. State of the `output_uri` export.",
+"enum": [
+"STATE_UNSPECIFIED",
+"SUCCEEDED",
+"FAILED"
+],
+"enumDescriptions": [
+"Default value.",
+"Export succeeded.",
+"Export failed."
+],
+"readOnly": true,
+"type": "string"
+},
+"status": {
+"$ref": "GoogleRpc_Status",
+"description": "Output only. Only set if state is FAILED.",
+"readOnly": true
+}
+},
+"type": "object"
+},
 "GoogleCloudVideointelligenceV1p3beta1_FaceAnnotation": {
 "deprecated": true,
 "description": "Deprecated. No effect.",
@@ -3970,7 +4121,7 @@
 "type": "object"
 },
 "GoogleCloudVideointelligenceV1p3beta1_NormalizedBoundingPoly": {
-"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trignometric calculations for location of the box.",
+"description": "Normalized bounding polygon for text (that might not be aligned with axis). Contains list of the corner points in clockwise order starting from top-left corner. For example, for a rectangular bounding box: When the text is horizontal it might look like: 0----1 | | 3----2 When it's clockwise rotated 180 degrees around the top-left corner it becomes: 2----3 | | 1----0 and the vertex order will still be (0, 1, 2, 3). Note that values can be less than 0, or greater than 1 due to trigonometric calculations for location of the box.",
 "id": "GoogleCloudVideointelligenceV1p3beta1_NormalizedBoundingPoly",
 "properties": {
 "vertices": {
@@ -4436,6 +4587,10 @@
 "description": "Annotation progress for a single video.",
 "id": "GoogleCloudVideointelligenceV1p3beta1_VideoAnnotationProgress",
 "properties": {
+"exportStatus": {
+"$ref": "GoogleCloudVideointelligenceV1p3beta1_ExportToOutputUriStatus",
+"description": "Status of exporting annotation response to user specified `output_uri`. Only set if `output_uri` is set in the request."
+},
 "feature": {
 "description": "Specifies which feature is being tracked if the request contains more than one feature.",
 "enum": [

From da9ab1ec4258a9a4c6b0799f7a57e8d462a63fd2 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:14 +0000
Subject: [PATCH 34/36] feat(workloadmanager): update the api

#### workloadmanager:v1

The following keys were added:
- schemas.AgentStatus.properties.instanceUri (Total Keys: 2)
---
 .../workloadmanager_v1.projects.locations.insights.html    | 1 +
 .../discovery_cache/documents/workloadmanager.v1.json      | 7 ++++++-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/docs/dyn/workloadmanager_v1.projects.locations.insights.html b/docs/dyn/workloadmanager_v1.projects.locations.insights.html
index 4a3bab5cf1c..637d8db3c39 100644
--- a/docs/dyn/workloadmanager_v1.projects.locations.insights.html
+++ b/docs/dyn/workloadmanager_v1.projects.locations.insights.html
@@ -128,6 +128,7 @@ 
Method Details

       "configurationFilePath": "A String", # Output only. The path to the agent configuration file.
       "configurationValid": "A String", # Output only. Whether the agent configuration is valid.
       "installedVersion": "A String", # Output only. The installed version of the agent on the host.
+      "instanceUri": "A String", # Output only. The URI of the instance. Format: projects//zones//instances/
       "kernelVersion": { # KernelVersion encapsulates the kernel version data for the system. # Output only. The kernel version of the system.
         "distroKernel": { # Version is reported as Major.Minor.Build.Patch. # Optional. Captures the distro-specific kernel version, the portion of the string following the first dash.
           "build": 42, # Optional. The build version number.
diff --git a/googleapiclient/discovery_cache/documents/workloadmanager.v1.json b/googleapiclient/discovery_cache/documents/workloadmanager.v1.json
index 476e6b32bee..bd2502e85f6 100644
--- a/googleapiclient/discovery_cache/documents/workloadmanager.v1.json
+++ b/googleapiclient/discovery_cache/documents/workloadmanager.v1.json
@@ -879,7 +879,7 @@ true
 }
 }
 },
-"revision": "20250630",
+"revision": "20250714",
 "rootUrl": "https://workloadmanager.googleapis.com/",
 "schemas": {
 "AgentCommand": {
@@ -963,6 +963,11 @@ true
 "readOnly": true,
 "type": "string"
 },
+"instanceUri": {
+"description": "Output only. The URI of the instance. Format: projects//zones//instances/",
+"readOnly": true,
+"type": "string"
+},
 "kernelVersion": {
 "$ref": "SapDiscoveryResourceInstancePropertiesKernelVersion",
 "description": "Output only. The kernel version of the system.",

From 53be948b67e079e73286a62711381b287aa07a32 Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:14 +0000
Subject: [PATCH 35/36] feat(workstations): update the api

#### workstations:v1beta

The following keys were added:
- schemas.WorkstationBoostConfig.properties.running (Total Keys: 2)
---
 ...orkstationClusters.workstationConfigs.workstations.html | 5 +++++
 .../discovery_cache/documents/workstations.v1beta.json     | 7 ++++++-
 2 files changed, 11 insertions(+), 1 deletion(-)

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 f0ea15a2f91..ab1fc2f014f 100644
--- a/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.workstations.html
+++ b/docs/dyn/workstations_v1beta.projects.locations.workstationClusters.workstationConfigs.workstations.html
@@ -141,6 +141,7 @@ 
Method Details

   "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.
+      "running": True or False, # Output only. Whether or not the current workstation is actively boosted with this id.
     },
   ],
   "conditions": [ # Output only. Status conditions describing the workstation's current state.
@@ -303,6 +304,7 @@ 
Method Details

   "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.
+      "running": True or False, # Output only. Whether or not the current workstation is actively boosted with this id.
     },
   ],
   "conditions": [ # Output only. Status conditions describing the workstation's current state.
@@ -426,6 +428,7 @@ 
Method Details

       "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.
+          "running": True or False, # Output only. Whether or not the current workstation is actively boosted with this id.
         },
       ],
       "conditions": [ # Output only. Status conditions describing the workstation's current state.
@@ -502,6 +505,7 @@ 
Method Details

       "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.
+          "running": True or False, # Output only. Whether or not the current workstation is actively boosted with this id.
         },
       ],
       "conditions": [ # Output only. Status conditions describing the workstation's current state.
@@ -593,6 +597,7 @@ 
Method Details

   "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.
+      "running": True or False, # Output only. Whether or not the current workstation is actively boosted with this id.
     },
   ],
   "conditions": [ # Output only. Status conditions describing the workstation's current state.
diff --git a/googleapiclient/discovery_cache/documents/workstations.v1beta.json b/googleapiclient/discovery_cache/documents/workstations.v1beta.json
index 293000ac316..50815993cdd 100644
--- a/googleapiclient/discovery_cache/documents/workstations.v1beta.json
+++ b/googleapiclient/discovery_cache/documents/workstations.v1beta.json
@@ -1142,7 +1142,7 @@
 }
 }
 },
-"revision": "20250625",
+"revision": "20250716",
 "rootUrl": "https://workstations.googleapis.com/",
 "schemas": {
 "Accelerator": {
@@ -2296,6 +2296,11 @@
 "description": "Output only. Boost configuration ID.",
 "readOnly": true,
 "type": "string"
+},
+"running": {
+"description": "Output only. Whether or not the current workstation is actively boosted with this id.",
+"readOnly": true,
+"type": "boolean"
 }
 },
 "type": "object"

From dba8ce3681c46012c1d30e3a7b5afb144f0d8b4c Mon Sep 17 00:00:00 2001
From: Yoshi Automation 
Date: Tue, 29 Jul 2025 07:12:14 +0000
Subject: [PATCH 36/36] chore(docs): Add new discovery artifacts and artifacts
 with minor updates

---
 ...1.organizations.gcpUserAccessBindings.html |  8 +--
 ...nts.apis.revisions.debugsessions.data.html |  2 +-
 ...ronments.apis.revisions.debugsessions.html |  6 +-
 ...izations.securityMonitoringConditions.html |  2 +-
 ...agement_v1.customers.telemetry.events.html |  2 +-
 docs/dyn/content_v2_1.conversionsources.html  |  2 +-
 ...ts.locations.entryGroups.entries.tags.html |  2 +-
 ...anizations.locations.discoveryConfigs.html | 72 +++++++++----------
 ...lp_v2.organizations.locations.dlpJobs.html | 14 ++--
 ...tions.locations.fileStoreDataProfiles.html | 24 +++----
 ...nizations.locations.tableDataProfiles.html | 24 +++----
 docs/dyn/dlp_v2.projects.dlpJobs.html         | 48 ++++++-------
 docs/dyn/dlp_v2.projects.jobTriggers.html     | 14 ++--
 ...2.projects.locations.discoveryConfigs.html | 72 +++++++++----------
 .../dlp_v2.projects.locations.dlpJobs.html    | 48 ++++++-------
 ...jects.locations.fileStoreDataProfiles.html | 24 +++----
 ...dlp_v2.projects.locations.jobTriggers.html | 14 ++--
 ....projects.locations.tableDataProfiles.html | 24 +++----
 docs/dyn/fcm_v1.projects.messages.html        |  8 +--
 docs/dyn/homegraph_v1.devices.html            |  2 +-
 docs/dyn/run_v2.projects.locations.jobs.html  |  8 +--
 .../run_v2.projects.locations.services.html   |  8 +--
 ...run_v2.projects.locations.workerPools.html |  8 +--
 ...ojects.locations.sources.migratingVms.html |  8 +--
 ...ojects.locations.sources.migratingVms.html |  8 +--
 .../documents/accesscontextmanager.v1.json    |  4 +-
 .../discovery_cache/documents/apigee.v1.json  | 12 ++--
 .../discovery_cache/documents/batch.v1.json   | 20 ++++--
 .../documents/chromemanagement.v1.json        | 20 ++++--
 .../documents/content.v2.1.json               |  4 +-
 .../documents/datacatalog.v1.json             |  3 +-
 .../discovery_cache/documents/dlp.v2.json     | 32 +++++----
 .../discovery_cache/documents/fcm.v1.json     |  6 +-
 .../discovery_cache/documents/gkehub.v1.json  | 20 ++++--
 .../documents/gkehub.v1alpha.json             | 20 ++++--
 .../documents/gkehub.v1beta.json              | 20 ++++--
 .../discovery_cache/documents/gkehub.v2.json  | 20 ++++--
 .../documents/gkehub.v2alpha.json             | 20 ++++--
 .../documents/gkehub.v2beta.json              | 20 ++++--
 .../documents/homegraph.v1.json               |  4 +-
 .../discovery_cache/documents/run.v2.json     | 11 ++-
 .../documents/texttospeech.v1.json            |  4 +-
 .../documents/texttospeech.v1beta1.json       |  4 +-
 .../documents/vmmigration.v1.json             |  4 +-
 .../documents/vmmigration.v1alpha1.json       |  4 +-
 45 files changed, 376 insertions(+), 328 deletions(-)

diff --git a/docs/dyn/accesscontextmanager_v1.organizations.gcpUserAccessBindings.html b/docs/dyn/accesscontextmanager_v1.organizations.gcpUserAccessBindings.html
index 8a074e83fab..bde399dcf64 100644
--- a/docs/dyn/accesscontextmanager_v1.organizations.gcpUserAccessBindings.html
+++ b/docs/dyn/accesscontextmanager_v1.organizations.gcpUserAccessBindings.html
@@ -117,7 +117,7 @@ 
Method Details

   "dryRunAccessLevels": [ # Optional. Dry run access level that will be evaluated but will not be enforced. The access denial based on dry run policy will be logged. Only one access level is supported, not multiple. This list must have exactly one element. Example: "accessPolicies/9522/accessLevels/device_trusted"
     "A String",
   ],
-  "groupKey": "A String", # Required. Immutable. Google Group id whose members are subject to this binding's restrictions. See "id" in the [G Suite Directory API's Groups resource] (https://developers.google.com/admin-sdk/directory/v1/reference/groups#resource). If a group's email address/alias is changed, this resource will continue to point at the changed group. This field does not accept group email addresses or aliases. Example: "01d520gv4vjcrht"
+  "groupKey": "A String", # Optional. Immutable. Google Group id whose users are subject to this binding's restrictions. See "id" in the [Google Workspace Directory API's Group Resource] (https://developers.google.com/admin-sdk/directory/v1/reference/groups#resource). If a group's email address/alias is changed, this resource will continue to point at the changed group. This field does not accept group email addresses or aliases. Example: "01d520gv4vjcrht"
   "name": "A String", # Immutable. Assigned by the server during creation. The last segment has an arbitrary length and has only URI unreserved characters (as defined by [RFC 3986 Section 2.3](https://tools.ietf.org/html/rfc3986#section-2.3)). Should not be specified by the client during creation. Example: "organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N"
   "restrictedClientApplications": [ # Optional. A list of applications that are subject to this binding's restrictions. If the list is empty, the binding restrictions will universally apply to all applications.
     { # An application that accesses Google Cloud APIs.
@@ -255,7 +255,7 @@ 
Method Details

   "dryRunAccessLevels": [ # Optional. Dry run access level that will be evaluated but will not be enforced. The access denial based on dry run policy will be logged. Only one access level is supported, not multiple. This list must have exactly one element. Example: "accessPolicies/9522/accessLevels/device_trusted"
     "A String",
   ],
-  "groupKey": "A String", # Required. Immutable. Google Group id whose members are subject to this binding's restrictions. See "id" in the [G Suite Directory API's Groups resource] (https://developers.google.com/admin-sdk/directory/v1/reference/groups#resource). If a group's email address/alias is changed, this resource will continue to point at the changed group. This field does not accept group email addresses or aliases. Example: "01d520gv4vjcrht"
+  "groupKey": "A String", # Optional. Immutable. Google Group id whose users are subject to this binding's restrictions. See "id" in the [Google Workspace Directory API's Group Resource] (https://developers.google.com/admin-sdk/directory/v1/reference/groups#resource). If a group's email address/alias is changed, this resource will continue to point at the changed group. This field does not accept group email addresses or aliases. Example: "01d520gv4vjcrht"
   "name": "A String", # Immutable. Assigned by the server during creation. The last segment has an arbitrary length and has only URI unreserved characters (as defined by [RFC 3986 Section 2.3](https://tools.ietf.org/html/rfc3986#section-2.3)). Should not be specified by the client during creation. Example: "organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N"
   "restrictedClientApplications": [ # Optional. A list of applications that are subject to this binding's restrictions. If the list is empty, the binding restrictions will universally apply to all applications.
     { # An application that accesses Google Cloud APIs.
@@ -334,7 +334,7 @@ 
Method Details

       "dryRunAccessLevels": [ # Optional. Dry run access level that will be evaluated but will not be enforced. The access denial based on dry run policy will be logged. Only one access level is supported, not multiple. This list must have exactly one element. Example: "accessPolicies/9522/accessLevels/device_trusted"
         "A String",
       ],
-      "groupKey": "A String", # Required. Immutable. Google Group id whose members are subject to this binding's restrictions. See "id" in the [G Suite Directory API's Groups resource] (https://developers.google.com/admin-sdk/directory/v1/reference/groups#resource). If a group's email address/alias is changed, this resource will continue to point at the changed group. This field does not accept group email addresses or aliases. Example: "01d520gv4vjcrht"
+      "groupKey": "A String", # Optional. Immutable. Google Group id whose users are subject to this binding's restrictions. See "id" in the [Google Workspace Directory API's Group Resource] (https://developers.google.com/admin-sdk/directory/v1/reference/groups#resource). If a group's email address/alias is changed, this resource will continue to point at the changed group. This field does not accept group email addresses or aliases. Example: "01d520gv4vjcrht"
       "name": "A String", # Immutable. Assigned by the server during creation. The last segment has an arbitrary length and has only URI unreserved characters (as defined by [RFC 3986 Section 2.3](https://tools.ietf.org/html/rfc3986#section-2.3)). Should not be specified by the client during creation. Example: "organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N"
       "restrictedClientApplications": [ # Optional. A list of applications that are subject to this binding's restrictions. If the list is empty, the binding restrictions will universally apply to all applications.
         { # An application that accesses Google Cloud APIs.
@@ -421,7 +421,7 @@ 
Method Details

   "dryRunAccessLevels": [ # Optional. Dry run access level that will be evaluated but will not be enforced. The access denial based on dry run policy will be logged. Only one access level is supported, not multiple. This list must have exactly one element. Example: "accessPolicies/9522/accessLevels/device_trusted"
     "A String",
   ],
-  "groupKey": "A String", # Required. Immutable. Google Group id whose members are subject to this binding's restrictions. See "id" in the [G Suite Directory API's Groups resource] (https://developers.google.com/admin-sdk/directory/v1/reference/groups#resource). If a group's email address/alias is changed, this resource will continue to point at the changed group. This field does not accept group email addresses or aliases. Example: "01d520gv4vjcrht"
+  "groupKey": "A String", # Optional. Immutable. Google Group id whose users are subject to this binding's restrictions. See "id" in the [Google Workspace Directory API's Group Resource] (https://developers.google.com/admin-sdk/directory/v1/reference/groups#resource). If a group's email address/alias is changed, this resource will continue to point at the changed group. This field does not accept group email addresses or aliases. Example: "01d520gv4vjcrht"
   "name": "A String", # Immutable. Assigned by the server during creation. The last segment has an arbitrary length and has only URI unreserved characters (as defined by [RFC 3986 Section 2.3](https://tools.ietf.org/html/rfc3986#section-2.3)). Should not be specified by the client during creation. Example: "organizations/256/gcpUserAccessBindings/b3-BhcX_Ud5N"
   "restrictedClientApplications": [ # Optional. A list of applications that are subject to this binding's restrictions. If the list is empty, the binding restrictions will universally apply to all applications.
     { # An application that accesses Google Cloud APIs.
diff --git a/docs/dyn/apigee_v1.organizations.environments.apis.revisions.debugsessions.data.html b/docs/dyn/apigee_v1.organizations.environments.apis.revisions.debugsessions.data.html
index caa10d7b56e..d1e2ead425f 100644
--- a/docs/dyn/apigee_v1.organizations.environments.apis.revisions.debugsessions.data.html
+++ b/docs/dyn/apigee_v1.organizations.environments.apis.revisions.debugsessions.data.html
@@ -91,7 +91,7 @@ 
Method Details

   
Gets the debug data from a transaction.
 
 Args:
-  name: string, Required. The name of the debug session transaction. Must be of the form: `organizations/{organization}/environments/{environment}/apis/{api}/revisions/{revision}/debugsessions/{session}/data/{transaction}`. If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview). (required)
+  name: string, Required. The name of the debug session transaction. Must be of the form: `organizations/{organization}/environments/{environment}/apis/{api}/revisions/{revision}/debugsessions/{debug_session}/data/{transaction}`. If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview). (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
diff --git a/docs/dyn/apigee_v1.organizations.environments.apis.revisions.debugsessions.html b/docs/dyn/apigee_v1.organizations.environments.apis.revisions.debugsessions.html
index 9d824733426..1377380c6a8 100644
--- a/docs/dyn/apigee_v1.organizations.environments.apis.revisions.debugsessions.html
+++ b/docs/dyn/apigee_v1.organizations.environments.apis.revisions.debugsessions.html
@@ -165,7 +165,7 @@ 
Method Details

   
Retrieves a debug session.
 
 Args:
-  name: string, Required. The name of the debug session to retrieve. Must be of the form: `organizations/{organization}/environments/{environment}/apis/{api}/revisions/{revision}/debugsessions/{session}`. If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview). (required)
+  name: string, Required. The name of the debug session to retrieve. Must be of the form: `organizations/{organization}/environments/{environment}/apis/{api}/revisions/{revision}/debugsessions/{debug_session}`. If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview). (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -191,8 +191,8 @@ 
Method Details

 
 Args:
   parent: string, Required. The name of the API Proxy revision deployment for which to list debug sessions. Must be of the form: `organizations/{organization}/environments/{environment}/apis/{api}/revisions/{revision}`. If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview). (required)
-  pageSize: integer, Maximum number of debug sessions to return. The page size defaults to 25.
-  pageToken: string, Page token, returned from a previous ListDebugSessions call, that you can use to retrieve the next page.
+  pageSize: integer, Optional. Maximum number of debug sessions to return. The page size defaults to 25.
+  pageToken: string, Optional. Page token, returned from a previous ListDebugSessions call, that you can use to retrieve the next page.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
diff --git a/docs/dyn/apigee_v1.organizations.securityMonitoringConditions.html b/docs/dyn/apigee_v1.organizations.securityMonitoringConditions.html
index e8ac1641093..8382b6c9e64 100644
--- a/docs/dyn/apigee_v1.organizations.securityMonitoringConditions.html
+++ b/docs/dyn/apigee_v1.organizations.securityMonitoringConditions.html
@@ -299,7 +299,7 @@ 
Method Details

   "updateTime": "A String", # Output only. The time of the security monitoring condition update.
 }
 
-  updateMask: string, Optional. The list of fields to update. Valid fields to update are `profile`, `scope`, `include_all_resources`, `include`, and `exclude`.
+  updateMask: string, Optional. The list of fields to update. Valid fields to update are `include_all_resources` and `include`.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
diff --git a/docs/dyn/chromemanagement_v1.customers.telemetry.events.html b/docs/dyn/chromemanagement_v1.customers.telemetry.events.html
index a7264f57bd6..96d5f6d4d0a 100644
--- a/docs/dyn/chromemanagement_v1.customers.telemetry.events.html
+++ b/docs/dyn/chromemanagement_v1.customers.telemetry.events.html
@@ -98,7 +98,7 @@ 
Method Details

   filter: string, Optional. Only include resources that match the filter. Although this parameter is currently optional, this parameter will be required- please specify at least 1 event type. Supported filter fields: - device_id - user_id - device_org_unit_id - user_org_unit_id - timestamp - event_type The "timestamp" filter accepts either the Unix Epoch milliseconds format or the RFC3339 UTC "Zulu" format with nanosecond resolution and up to nine fractional digits. Both formats should be surrounded by simple double quotes. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", "1679283943823".
   pageSize: integer, Optional. Maximum number of results to return. Default value is 100. Maximum value is 1000.
   pageToken: string, Optional. Token to specify next page in the list.
-  readMask: string, Required. Read mask to specify which fields to return. Although currently required, this field will become optional, while the filter parameter with an event type will be come required. Supported read_mask paths are: - device - user - audio_severe_underrun_event - usb_peripherals_event - https_latency_change_event - network_state_change_event - wifi_signal_strength_event - vpn_connection_state_change_event - app_install_event - app_uninstall_event - app_launch_event - os_crash_event 
+  readMask: string, Required. Read mask to specify which fields to return. Although currently required, this field will become optional, while the filter parameter with an event type will be come required. Supported read_mask paths are: - device - user - audio_severe_underrun_event - usb_peripherals_event - https_latency_change_event - network_state_change_event - wifi_signal_strength_event - vpn_connection_state_change_event - app_install_event - app_uninstall_event - app_launch_event - os_crash_event - external_displays_event 
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
diff --git a/docs/dyn/content_v2_1.conversionsources.html b/docs/dyn/content_v2_1.conversionsources.html
index e0573e4645c..2b1c9085dac 100644
--- a/docs/dyn/content_v2_1.conversionsources.html
+++ b/docs/dyn/content_v2_1.conversionsources.html
@@ -374,7 +374,7 @@ 
Method Details

   "state": "A String", # Output only. Current state of this conversion source. Can't be edited through the API.
 }
 
-  updateMask: string, Optional. List of fields being updated.
+  updateMask: string, Optional. List of fields being updated. The following fields can be updated: `attribution_settings`, `display_name`, `currency_code`.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
diff --git a/docs/dyn/datacatalog_v1.projects.locations.entryGroups.entries.tags.html b/docs/dyn/datacatalog_v1.projects.locations.entryGroups.entries.tags.html
index 111de585b88..946396972ec 100644
--- a/docs/dyn/datacatalog_v1.projects.locations.entryGroups.entries.tags.html
+++ b/docs/dyn/datacatalog_v1.projects.locations.entryGroups.entries.tags.html
@@ -312,7 +312,7 @@ 
Method Details

     The object takes the form of:
 
 { # Request message for ReconcileTags.
-  "forceDeleteMissing": True or False, # If set to `true`, deletes entry tags related to a tag template not listed in the tags source from an entry. If set to `false`, unlisted tags are retained.
+  "forceDeleteMissing": True or False,
   "tagTemplate": "A String", # Required. The name of the tag template, which is used for reconciliation.
   "tags": [ # A list of tags to apply to an entry. A tag can specify a tag template, which must be the template specified in the `ReconcileTagsRequest`. The sole entry and each of its columns must be mentioned at most once.
     { # Tags contain custom metadata and are attached to Data Catalog resources. Tags conform with the specification of their tag template. See [Data Catalog IAM](https://cloud.google.com/data-catalog/docs/concepts/iam) for information on the permissions needed to create or view tags.
diff --git a/docs/dyn/dlp_v2.organizations.locations.discoveryConfigs.html b/docs/dyn/dlp_v2.organizations.locations.discoveryConfigs.html
index 829e0a2ec17..21a42d6c0ce 100644
--- a/docs/dyn/dlp_v2.organizations.locations.discoveryConfigs.html
+++ b/docs/dyn/dlp_v2.organizations.locations.discoveryConfigs.html
@@ -206,16 +206,16 @@ 
Method Details

       },
     },
     "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-      "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-        "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+      "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+        "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
         },
-        "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+        "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
         },
       },
-      "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-        "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+      "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+        "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
         },
-        "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+        "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
         },
       },
     },
@@ -555,16 +555,16 @@ 
Method Details

     },
   },
   "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-    "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-      "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+    "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+      "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
       },
-      "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+      "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
       },
     },
-    "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-      "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+    "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+      "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
       },
-      "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+      "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
       },
     },
   },
@@ -928,16 +928,16 @@ 
Method Details

     },
   },
   "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-    "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-      "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+    "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+      "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
       },
-      "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+      "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
       },
     },
-    "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-      "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+    "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+      "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
       },
-      "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+      "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
       },
     },
   },
@@ -1288,16 +1288,16 @@ 
Method Details

         },
       },
       "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-        "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-          "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+        "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+          "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
           },
-          "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+          "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
           },
         },
-        "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-          "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+        "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+          "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
           },
-          "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+          "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
           },
         },
       },
@@ -1656,16 +1656,16 @@ 
Method Details

       },
     },
     "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-      "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-        "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+      "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+        "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
         },
-        "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+        "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
         },
       },
-      "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-        "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+      "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+        "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
         },
-        "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+        "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
         },
       },
     },
@@ -2006,16 +2006,16 @@ 
Method Details

     },
   },
   "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-    "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-      "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+    "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+      "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
       },
-      "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+      "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
       },
     },
-    "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-      "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+    "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+      "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
       },
-      "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+      "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
       },
     },
   },
diff --git a/docs/dyn/dlp_v2.organizations.locations.dlpJobs.html b/docs/dyn/dlp_v2.organizations.locations.dlpJobs.html
index ae7cdc39b94..4d320ddc3ee 100644
--- a/docs/dyn/dlp_v2.organizations.locations.dlpJobs.html
+++ b/docs/dyn/dlp_v2.organizations.locations.dlpJobs.html
@@ -3227,7 +3227,7 @@ 
Method Details

             "updateTime": "A String", # Output only. The last update timestamp of an inspectTemplate.
           },
         },
-        "result": { # All result fields mentioned below are updated while the job is processing. # A summary of the outcome of this inspection job.
+        "result": { # All Result fields are updated while the job is processing. # A summary of the outcome of this inspection job.
           "hybridStats": { # Statistics related to processing hybrid inspect requests. # Statistics related to the processing of hybrid inspect.
             "abortedCount": "A String", # The number of hybrid inspection requests aborted because the job ran out of quota or was ended before they could be processed.
             "pendingCount": "A String", # The number of hybrid requests currently being processed. Only populated when called via method `getDlpJob`. A burst of traffic may cause hybrid inspect requests to be enqueued. Processing will take place as quickly as possible, but resource limitations may impact how long a request is enqueued for.
@@ -3574,7 +3574,7 @@ 
Method Details

                   { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
                     "quasiIds": [ # Required. Quasi-identifier columns.
                       { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                        "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                        "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                         "field": { # General identifier of a data field in a storage service. # Identifies the column.
                           "name": "A String", # Name describing the field.
                         },
@@ -3592,7 +3592,7 @@ 
Method Details

                 ],
                 "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
                   { # A column with a semantic tag attached.
-                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                     "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                       "name": "A String", # Name describing the field.
                     },
@@ -3644,7 +3644,7 @@ 
Method Details

                 ],
                 "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
                   { # A column with a semantic tag attached.
-                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                     "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                       "name": "A String", # Name describing the field.
                     },
@@ -3695,7 +3695,7 @@ 
Method Details

               { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
                 "quasiIds": [ # Required. Quasi-identifier columns.
                   { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                     "field": { # General identifier of a data field in a storage service. # Identifies the column.
                       "name": "A String", # Name describing the field.
                     },
@@ -3713,7 +3713,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -3765,7 +3765,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
diff --git a/docs/dyn/dlp_v2.organizations.locations.fileStoreDataProfiles.html b/docs/dyn/dlp_v2.organizations.locations.fileStoreDataProfiles.html
index 27575e61c4a..e82a95909ae 100644
--- a/docs/dyn/dlp_v2.organizations.locations.fileStoreDataProfiles.html
+++ b/docs/dyn/dlp_v2.organizations.locations.fileStoreDataProfiles.html
@@ -294,16 +294,16 @@ 
Method Details

         },
       },
       "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-        "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-          "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+        "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+          "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
           },
-          "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+          "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
           },
         },
-        "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-          "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+        "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+          "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
           },
-          "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+          "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
           },
         },
       },
@@ -1059,16 +1059,16 @@ 
Method Details

             },
           },
           "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-            "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-              "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+            "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+              "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
               },
-              "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+              "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
               },
             },
-            "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-              "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+            "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+              "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
               },
-              "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+              "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
               },
             },
           },
diff --git a/docs/dyn/dlp_v2.organizations.locations.tableDataProfiles.html b/docs/dyn/dlp_v2.organizations.locations.tableDataProfiles.html
index 7110f0567e9..c1d17f65fe0 100644
--- a/docs/dyn/dlp_v2.organizations.locations.tableDataProfiles.html
+++ b/docs/dyn/dlp_v2.organizations.locations.tableDataProfiles.html
@@ -294,16 +294,16 @@ 
Method Details

         },
       },
       "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-        "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-          "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+        "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+          "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
           },
-          "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+          "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
           },
         },
-        "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-          "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+        "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+          "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
           },
-          "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+          "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
           },
         },
       },
@@ -1003,16 +1003,16 @@ 
Method Details

             },
           },
           "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-            "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-              "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+            "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+              "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
               },
-              "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+              "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
               },
             },
-            "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-              "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+            "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+              "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
               },
-              "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+              "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
               },
             },
           },
diff --git a/docs/dyn/dlp_v2.projects.dlpJobs.html b/docs/dyn/dlp_v2.projects.dlpJobs.html
index 705eac990a9..56b139231cb 100644
--- a/docs/dyn/dlp_v2.projects.dlpJobs.html
+++ b/docs/dyn/dlp_v2.projects.dlpJobs.html
@@ -497,7 +497,7 @@ 
Method Details

           { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
             "quasiIds": [ # Required. Quasi-identifier columns.
               { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -515,7 +515,7 @@ 
Method Details

         ],
         "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
           { # A column with a semantic tag attached.
-            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
             "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
               "name": "A String", # Name describing the field.
             },
@@ -567,7 +567,7 @@ 
Method Details

         ],
         "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
           { # A column with a semantic tag attached.
-            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
             "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
               "name": "A String", # Name describing the field.
             },
@@ -3728,7 +3728,7 @@ 
Method Details

         "updateTime": "A String", # Output only. The last update timestamp of an inspectTemplate.
       },
     },
-    "result": { # All result fields mentioned below are updated while the job is processing. # A summary of the outcome of this inspection job.
+    "result": { # All Result fields are updated while the job is processing. # A summary of the outcome of this inspection job.
       "hybridStats": { # Statistics related to processing hybrid inspect requests. # Statistics related to the processing of hybrid inspect.
         "abortedCount": "A String", # The number of hybrid inspection requests aborted because the job ran out of quota or was ended before they could be processed.
         "pendingCount": "A String", # The number of hybrid requests currently being processed. Only populated when called via method `getDlpJob`. A burst of traffic may cause hybrid inspect requests to be enqueued. Processing will take place as quickly as possible, but resource limitations may impact how long a request is enqueued for.
@@ -4075,7 +4075,7 @@ 
Method Details

               { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
                 "quasiIds": [ # Required. Quasi-identifier columns.
                   { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                     "field": { # General identifier of a data field in a storage service. # Identifies the column.
                       "name": "A String", # Name describing the field.
                     },
@@ -4093,7 +4093,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -4145,7 +4145,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -4196,7 +4196,7 @@ 
Method Details

           { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
             "quasiIds": [ # Required. Quasi-identifier columns.
               { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -4214,7 +4214,7 @@ 
Method Details

         ],
         "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
           { # A column with a semantic tag attached.
-            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
             "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
               "name": "A String", # Name describing the field.
             },
@@ -4266,7 +4266,7 @@ 
Method Details

         ],
         "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
           { # A column with a semantic tag attached.
-            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
             "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
               "name": "A String", # Name describing the field.
             },
@@ -7455,7 +7455,7 @@ 
Method Details

         "updateTime": "A String", # Output only. The last update timestamp of an inspectTemplate.
       },
     },
-    "result": { # All result fields mentioned below are updated while the job is processing. # A summary of the outcome of this inspection job.
+    "result": { # All Result fields are updated while the job is processing. # A summary of the outcome of this inspection job.
       "hybridStats": { # Statistics related to processing hybrid inspect requests. # Statistics related to the processing of hybrid inspect.
         "abortedCount": "A String", # The number of hybrid inspection requests aborted because the job ran out of quota or was ended before they could be processed.
         "pendingCount": "A String", # The number of hybrid requests currently being processed. Only populated when called via method `getDlpJob`. A burst of traffic may cause hybrid inspect requests to be enqueued. Processing will take place as quickly as possible, but resource limitations may impact how long a request is enqueued for.
@@ -7802,7 +7802,7 @@ 
Method Details

               { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
                 "quasiIds": [ # Required. Quasi-identifier columns.
                   { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                     "field": { # General identifier of a data field in a storage service. # Identifies the column.
                       "name": "A String", # Name describing the field.
                     },
@@ -7820,7 +7820,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -7872,7 +7872,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -7923,7 +7923,7 @@ 
Method Details

           { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
             "quasiIds": [ # Required. Quasi-identifier columns.
               { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -7941,7 +7941,7 @@ 
Method Details

         ],
         "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
           { # A column with a semantic tag attached.
-            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
             "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
               "name": "A String", # Name describing the field.
             },
@@ -7993,7 +7993,7 @@ 
Method Details

         ],
         "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
           { # A column with a semantic tag attached.
-            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
             "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
               "name": "A String", # Name describing the field.
             },
@@ -11176,7 +11176,7 @@ 
Method Details

             "updateTime": "A String", # Output only. The last update timestamp of an inspectTemplate.
           },
         },
-        "result": { # All result fields mentioned below are updated while the job is processing. # A summary of the outcome of this inspection job.
+        "result": { # All Result fields are updated while the job is processing. # A summary of the outcome of this inspection job.
           "hybridStats": { # Statistics related to processing hybrid inspect requests. # Statistics related to the processing of hybrid inspect.
             "abortedCount": "A String", # The number of hybrid inspection requests aborted because the job ran out of quota or was ended before they could be processed.
             "pendingCount": "A String", # The number of hybrid requests currently being processed. Only populated when called via method `getDlpJob`. A burst of traffic may cause hybrid inspect requests to be enqueued. Processing will take place as quickly as possible, but resource limitations may impact how long a request is enqueued for.
@@ -11523,7 +11523,7 @@ 
Method Details

                   { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
                     "quasiIds": [ # Required. Quasi-identifier columns.
                       { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                        "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                        "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                         "field": { # General identifier of a data field in a storage service. # Identifies the column.
                           "name": "A String", # Name describing the field.
                         },
@@ -11541,7 +11541,7 @@ 
Method Details

                 ],
                 "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
                   { # A column with a semantic tag attached.
-                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                     "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                       "name": "A String", # Name describing the field.
                     },
@@ -11593,7 +11593,7 @@ 
Method Details

                 ],
                 "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
                   { # A column with a semantic tag attached.
-                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                     "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                       "name": "A String", # Name describing the field.
                     },
@@ -11644,7 +11644,7 @@ 
Method Details

               { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
                 "quasiIds": [ # Required. Quasi-identifier columns.
                   { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                     "field": { # General identifier of a data field in a storage service. # Identifies the column.
                       "name": "A String", # Name describing the field.
                     },
@@ -11662,7 +11662,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -11714,7 +11714,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
diff --git a/docs/dyn/dlp_v2.projects.jobTriggers.html b/docs/dyn/dlp_v2.projects.jobTriggers.html
index 49539a9cae7..6b4a82086e8 100644
--- a/docs/dyn/dlp_v2.projects.jobTriggers.html
+++ b/docs/dyn/dlp_v2.projects.jobTriggers.html
@@ -3231,7 +3231,7 @@ 
Method Details

         "updateTime": "A String", # Output only. The last update timestamp of an inspectTemplate.
       },
     },
-    "result": { # All result fields mentioned below are updated while the job is processing. # A summary of the outcome of this inspection job.
+    "result": { # All Result fields are updated while the job is processing. # A summary of the outcome of this inspection job.
       "hybridStats": { # Statistics related to processing hybrid inspect requests. # Statistics related to the processing of hybrid inspect.
         "abortedCount": "A String", # The number of hybrid inspection requests aborted because the job ran out of quota or was ended before they could be processed.
         "pendingCount": "A String", # The number of hybrid requests currently being processed. Only populated when called via method `getDlpJob`. A burst of traffic may cause hybrid inspect requests to be enqueued. Processing will take place as quickly as possible, but resource limitations may impact how long a request is enqueued for.
@@ -3578,7 +3578,7 @@ 
Method Details

               { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
                 "quasiIds": [ # Required. Quasi-identifier columns.
                   { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                     "field": { # General identifier of a data field in a storage service. # Identifies the column.
                       "name": "A String", # Name describing the field.
                     },
@@ -3596,7 +3596,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -3648,7 +3648,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -3699,7 +3699,7 @@ 
Method Details

           { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
             "quasiIds": [ # Required. Quasi-identifier columns.
               { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -3717,7 +3717,7 @@ 
Method Details

         ],
         "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
           { # A column with a semantic tag attached.
-            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
             "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
               "name": "A String", # Name describing the field.
             },
@@ -3769,7 +3769,7 @@ 
Method Details

         ],
         "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
           { # A column with a semantic tag attached.
-            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
             "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
               "name": "A String", # Name describing the field.
             },
diff --git a/docs/dyn/dlp_v2.projects.locations.discoveryConfigs.html b/docs/dyn/dlp_v2.projects.locations.discoveryConfigs.html
index fdbf1915cdb..b29006c5833 100644
--- a/docs/dyn/dlp_v2.projects.locations.discoveryConfigs.html
+++ b/docs/dyn/dlp_v2.projects.locations.discoveryConfigs.html
@@ -206,16 +206,16 @@ 
Method Details

       },
     },
     "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-      "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-        "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+      "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+        "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
         },
-        "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+        "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
         },
       },
-      "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-        "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+      "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+        "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
         },
-        "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+        "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
         },
       },
     },
@@ -555,16 +555,16 @@ 
Method Details

     },
   },
   "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-    "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-      "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+    "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+      "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
       },
-      "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+      "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
       },
     },
-    "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-      "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+    "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+      "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
       },
-      "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+      "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
       },
     },
   },
@@ -928,16 +928,16 @@ 
Method Details

     },
   },
   "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-    "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-      "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+    "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+      "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
       },
-      "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+      "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
       },
     },
-    "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-      "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+    "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+      "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
       },
-      "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+      "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
       },
     },
   },
@@ -1288,16 +1288,16 @@ 
Method Details

         },
       },
       "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-        "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-          "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+        "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+          "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
           },
-          "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+          "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
           },
         },
-        "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-          "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+        "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+          "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
           },
-          "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+          "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
           },
         },
       },
@@ -1656,16 +1656,16 @@ 
Method Details

       },
     },
     "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-      "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-        "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+      "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+        "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
         },
-        "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+        "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
         },
       },
-      "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-        "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+      "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+        "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
         },
-        "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+        "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
         },
       },
     },
@@ -2006,16 +2006,16 @@ 
Method Details

     },
   },
   "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-    "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-      "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+    "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+      "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
       },
-      "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+      "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
       },
     },
-    "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-      "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+    "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+      "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
       },
-      "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+      "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
       },
     },
   },
diff --git a/docs/dyn/dlp_v2.projects.locations.dlpJobs.html b/docs/dyn/dlp_v2.projects.locations.dlpJobs.html
index 05f17103585..7fc017e1f09 100644
--- a/docs/dyn/dlp_v2.projects.locations.dlpJobs.html
+++ b/docs/dyn/dlp_v2.projects.locations.dlpJobs.html
@@ -503,7 +503,7 @@ 
Method Details

           { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
             "quasiIds": [ # Required. Quasi-identifier columns.
               { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -521,7 +521,7 @@ 
Method Details

         ],
         "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
           { # A column with a semantic tag attached.
-            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
             "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
               "name": "A String", # Name describing the field.
             },
@@ -573,7 +573,7 @@ 
Method Details

         ],
         "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
           { # A column with a semantic tag attached.
-            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
             "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
               "name": "A String", # Name describing the field.
             },
@@ -3734,7 +3734,7 @@ 
Method Details

         "updateTime": "A String", # Output only. The last update timestamp of an inspectTemplate.
       },
     },
-    "result": { # All result fields mentioned below are updated while the job is processing. # A summary of the outcome of this inspection job.
+    "result": { # All Result fields are updated while the job is processing. # A summary of the outcome of this inspection job.
       "hybridStats": { # Statistics related to processing hybrid inspect requests. # Statistics related to the processing of hybrid inspect.
         "abortedCount": "A String", # The number of hybrid inspection requests aborted because the job ran out of quota or was ended before they could be processed.
         "pendingCount": "A String", # The number of hybrid requests currently being processed. Only populated when called via method `getDlpJob`. A burst of traffic may cause hybrid inspect requests to be enqueued. Processing will take place as quickly as possible, but resource limitations may impact how long a request is enqueued for.
@@ -4081,7 +4081,7 @@ 
Method Details

               { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
                 "quasiIds": [ # Required. Quasi-identifier columns.
                   { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                     "field": { # General identifier of a data field in a storage service. # Identifies the column.
                       "name": "A String", # Name describing the field.
                     },
@@ -4099,7 +4099,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -4151,7 +4151,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -4202,7 +4202,7 @@ 
Method Details

           { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
             "quasiIds": [ # Required. Quasi-identifier columns.
               { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -4220,7 +4220,7 @@ 
Method Details

         ],
         "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
           { # A column with a semantic tag attached.
-            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
             "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
               "name": "A String", # Name describing the field.
             },
@@ -4272,7 +4272,7 @@ 
Method Details

         ],
         "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
           { # A column with a semantic tag attached.
-            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
             "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
               "name": "A String", # Name describing the field.
             },
@@ -7485,7 +7485,7 @@ 
Method Details

         "updateTime": "A String", # Output only. The last update timestamp of an inspectTemplate.
       },
     },
-    "result": { # All result fields mentioned below are updated while the job is processing. # A summary of the outcome of this inspection job.
+    "result": { # All Result fields are updated while the job is processing. # A summary of the outcome of this inspection job.
       "hybridStats": { # Statistics related to processing hybrid inspect requests. # Statistics related to the processing of hybrid inspect.
         "abortedCount": "A String", # The number of hybrid inspection requests aborted because the job ran out of quota or was ended before they could be processed.
         "pendingCount": "A String", # The number of hybrid requests currently being processed. Only populated when called via method `getDlpJob`. A burst of traffic may cause hybrid inspect requests to be enqueued. Processing will take place as quickly as possible, but resource limitations may impact how long a request is enqueued for.
@@ -7832,7 +7832,7 @@ 
Method Details

               { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
                 "quasiIds": [ # Required. Quasi-identifier columns.
                   { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                     "field": { # General identifier of a data field in a storage service. # Identifies the column.
                       "name": "A String", # Name describing the field.
                     },
@@ -7850,7 +7850,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -7902,7 +7902,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -7953,7 +7953,7 @@ 
Method Details

           { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
             "quasiIds": [ # Required. Quasi-identifier columns.
               { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -7971,7 +7971,7 @@ 
Method Details

         ],
         "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
           { # A column with a semantic tag attached.
-            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
             "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
               "name": "A String", # Name describing the field.
             },
@@ -8023,7 +8023,7 @@ 
Method Details

         ],
         "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
           { # A column with a semantic tag attached.
-            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
             "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
               "name": "A String", # Name describing the field.
             },
@@ -11294,7 +11294,7 @@ 
Method Details

             "updateTime": "A String", # Output only. The last update timestamp of an inspectTemplate.
           },
         },
-        "result": { # All result fields mentioned below are updated while the job is processing. # A summary of the outcome of this inspection job.
+        "result": { # All Result fields are updated while the job is processing. # A summary of the outcome of this inspection job.
           "hybridStats": { # Statistics related to processing hybrid inspect requests. # Statistics related to the processing of hybrid inspect.
             "abortedCount": "A String", # The number of hybrid inspection requests aborted because the job ran out of quota or was ended before they could be processed.
             "pendingCount": "A String", # The number of hybrid requests currently being processed. Only populated when called via method `getDlpJob`. A burst of traffic may cause hybrid inspect requests to be enqueued. Processing will take place as quickly as possible, but resource limitations may impact how long a request is enqueued for.
@@ -11641,7 +11641,7 @@ 
Method Details

                   { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
                     "quasiIds": [ # Required. Quasi-identifier columns.
                       { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                        "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                        "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                         "field": { # General identifier of a data field in a storage service. # Identifies the column.
                           "name": "A String", # Name describing the field.
                         },
@@ -11659,7 +11659,7 @@ 
Method Details

                 ],
                 "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
                   { # A column with a semantic tag attached.
-                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                     "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                       "name": "A String", # Name describing the field.
                     },
@@ -11711,7 +11711,7 @@ 
Method Details

                 ],
                 "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
                   { # A column with a semantic tag attached.
-                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                     "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                       "name": "A String", # Name describing the field.
                     },
@@ -11762,7 +11762,7 @@ 
Method Details

               { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
                 "quasiIds": [ # Required. Quasi-identifier columns.
                   { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                     "field": { # General identifier of a data field in a storage service. # Identifies the column.
                       "name": "A String", # Name describing the field.
                     },
@@ -11780,7 +11780,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -11832,7 +11832,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
diff --git a/docs/dyn/dlp_v2.projects.locations.fileStoreDataProfiles.html b/docs/dyn/dlp_v2.projects.locations.fileStoreDataProfiles.html
index bd3dab28e1d..b6a8fb621fb 100644
--- a/docs/dyn/dlp_v2.projects.locations.fileStoreDataProfiles.html
+++ b/docs/dyn/dlp_v2.projects.locations.fileStoreDataProfiles.html
@@ -294,16 +294,16 @@ 
Method Details

         },
       },
       "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-        "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-          "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+        "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+          "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
           },
-          "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+          "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
           },
         },
-        "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-          "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+        "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+          "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
           },
-          "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+          "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
           },
         },
       },
@@ -1059,16 +1059,16 @@ 
Method Details

             },
           },
           "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-            "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-              "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+            "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+              "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
               },
-              "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+              "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
               },
             },
-            "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-              "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+            "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+              "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
               },
-              "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+              "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
               },
             },
           },
diff --git a/docs/dyn/dlp_v2.projects.locations.jobTriggers.html b/docs/dyn/dlp_v2.projects.locations.jobTriggers.html
index 5938f7024e2..fa8c9d050a8 100644
--- a/docs/dyn/dlp_v2.projects.locations.jobTriggers.html
+++ b/docs/dyn/dlp_v2.projects.locations.jobTriggers.html
@@ -3234,7 +3234,7 @@ 
Method Details

         "updateTime": "A String", # Output only. The last update timestamp of an inspectTemplate.
       },
     },
-    "result": { # All result fields mentioned below are updated while the job is processing. # A summary of the outcome of this inspection job.
+    "result": { # All Result fields are updated while the job is processing. # A summary of the outcome of this inspection job.
       "hybridStats": { # Statistics related to processing hybrid inspect requests. # Statistics related to the processing of hybrid inspect.
         "abortedCount": "A String", # The number of hybrid inspection requests aborted because the job ran out of quota or was ended before they could be processed.
         "pendingCount": "A String", # The number of hybrid requests currently being processed. Only populated when called via method `getDlpJob`. A burst of traffic may cause hybrid inspect requests to be enqueued. Processing will take place as quickly as possible, but resource limitations may impact how long a request is enqueued for.
@@ -3581,7 +3581,7 @@ 
Method Details

               { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
                 "quasiIds": [ # Required. Quasi-identifier columns.
                   { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                    "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                     "field": { # General identifier of a data field in a storage service. # Identifies the column.
                       "name": "A String", # Name describing the field.
                     },
@@ -3599,7 +3599,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -3651,7 +3651,7 @@ 
Method Details

             ],
             "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
               { # A column with a semantic tag attached.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -3702,7 +3702,7 @@ 
Method Details

           { # An auxiliary table containing statistical information on the relative frequency of different quasi-identifiers values. It has one or several quasi-identifiers columns, and one column that indicates the relative frequency of each quasi-identifier tuple. If a tuple is present in the data but not in the auxiliary table, the corresponding relative frequency is assumed to be zero (and thus, the tuple is highly reidentifiable).
             "quasiIds": [ # Required. Quasi-identifier columns.
               { # A quasi-identifier column has a custom_tag, used to know which column in the data corresponds to which column in the statistical model.
-                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+                "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
                 "field": { # General identifier of a data field in a storage service. # Identifies the column.
                   "name": "A String", # Name describing the field.
                 },
@@ -3720,7 +3720,7 @@ 
Method Details

         ],
         "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two fields can have the same tag.
           { # A column with a semantic tag attached.
-            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
             "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
               "name": "A String", # Name describing the field.
             },
@@ -3772,7 +3772,7 @@ 
Method Details

         ],
         "quasiIds": [ # Required. Fields considered to be quasi-identifiers. No two columns can have the same tag.
           { # A column with a semantic tag attached.
-            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).
+            "customTag": "A String", # A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.
             "field": { # General identifier of a data field in a storage service. # Required. Identifies the column.
               "name": "A String", # Name describing the field.
             },
diff --git a/docs/dyn/dlp_v2.projects.locations.tableDataProfiles.html b/docs/dyn/dlp_v2.projects.locations.tableDataProfiles.html
index ce8392b9a68..5af0955b467 100644
--- a/docs/dyn/dlp_v2.projects.locations.tableDataProfiles.html
+++ b/docs/dyn/dlp_v2.projects.locations.tableDataProfiles.html
@@ -294,16 +294,16 @@ 
Method Details

         },
       },
       "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-        "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-          "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+        "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+          "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
           },
-          "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+          "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
           },
         },
-        "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-          "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+        "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+          "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
           },
-          "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+          "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
           },
         },
       },
@@ -1003,16 +1003,16 @@ 
Method Details

             },
           },
           "processingLocation": { # Configure processing location for discovery and inspection. For example, image OCR is only provided in limited regions but configuring ProcessingLocation will redirect OCR to a location where OCR is provided. # Optional. Processing location configuration. Vertex AI dataset scanning will set processing_location.image_fallback_type to MultiRegionProcessing by default.
-            "documentFallbackLocation": { # Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location. # Document processing will fall back using this configuration.
-              "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+            "documentFallbackLocation": { # Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location. # Document processing falls back using this configuration.
+              "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
               },
-              "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+              "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
               },
             },
-            "imageFallbackLocation": { # Configure image processing to fall back to the configured processing option below if unavailable in the request location. # Image processing will fall back using this configuration.
-              "globalProcessing": { # Processing will happen in the global region. # Processing will happen in the global region.
+            "imageFallbackLocation": { # Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location. # Image processing falls back using this configuration.
+              "globalProcessing": { # Processing occurs in the global region. # Processing occurs in the global region.
               },
-              "multiRegionProcessing": { # Processing will happen in a multi-region that contains the current region if available. # Processing will happen in a multi-region that contains the current region if available.
+              "multiRegionProcessing": { # Processing occurs in a multi-region that contains the current region if available. # Processing occurs in a multi-region that contains the current region if available.
               },
             },
           },
diff --git a/docs/dyn/fcm_v1.projects.messages.html b/docs/dyn/fcm_v1.projects.messages.html
index e84f136adf7..d4dc8661e12 100644
--- a/docs/dyn/fcm_v1.projects.messages.html
+++ b/docs/dyn/fcm_v1.projects.messages.html
@@ -98,7 +98,7 @@ 
Method Details

 { # Request to send a message to specified target.
   "message": { # Message to send by Firebase Cloud Messaging Service. # Required. Message to send.
     "android": { # Android specific options for messages sent through [FCM connection server](https://goo.gl/4GLdUl). # Input only. Android specific options for messages sent through [FCM connection server](https://goo.gl/4GLdUl).
-      "bandwidthConstrainedOk": True or False, # Optional. If set to true, messages will be allowed to be delivered to the app while the device is in bandwidth constrained mode.
+      "bandwidthConstrainedOk": True or False, # Optional. If set to true, messages will be allowed to be delivered to the app while the device is in bandwidth constrained mode. This should only be enabled when the app has been tested to properly handle messages in bandwidth constrained mode.
       "collapseKey": "A String", # An identifier of a group of messages that can be collapsed, so that only the last message gets sent when delivery can be resumed. A maximum of 4 different collapse keys is allowed at any given time.
       "data": { # Arbitrary key/value payload. If present, it will override google.firebase.fcm.v1.Message.data.
         "a_key": "A String",
@@ -153,7 +153,7 @@ 
Method Details

       },
       "priority": "A String", # Message priority. Can take "normal" and "high" values. For more information, see [Setting the priority of a message](https://goo.gl/GjONJv).
       "restrictedPackageName": "A String", # Package name of the application where the registration token must match in order to receive the message.
-      "restrictedSatelliteOk": True or False, # Optional. If set to true, messages will be allowed to be delivered to the app while the device is connected over a restricted satellite network. This should only be enabled for messages that can be handled over a restricted satellite network and only for apps that are allowed to work over a restricted satellite network. Note that the ability of the app to connect to a restricted satellite network is dependent on the carrier's settings and the device model.
+      "restrictedSatelliteOk": True or False, # Optional. If set to true, messages will be allowed to be delivered to the app while the device is connected over a restricted satellite network. This should only be enabled for messages that can be handled over a restricted satellite network and only for apps that are enabled to work over a restricted satellite network. Note that the ability of the app to connect to a restricted satellite network is dependent on the carrier's settings and the device model.
       "ttl": "A String", # How long (in seconds) the message should be kept in FCM storage if the device is offline. The maximum time to live supported is 4 weeks, and the default value is 4 weeks if not set. Set it to 0 if want to send the message immediately. In JSON format, the Duration type is encoded as a string rather than an object, where the string ends in the suffix "s" (indicating seconds) and is preceded by the number of seconds, with nanoseconds expressed as fractional seconds. For example, 3 seconds with 0 nanoseconds should be encoded in JSON format as "3s", while 3 seconds and 1 nanosecond should be expressed in JSON format as "3.000000001s". The ttl will be rounded down to the nearest second.
     },
     "apns": { # [Apple Push Notification Service](https://goo.gl/MXRTPa) specific options. # Input only. [Apple Push Notification Service](https://goo.gl/MXRTPa) specific options.
@@ -213,7 +213,7 @@ 
Method Details

 
     { # Message to send by Firebase Cloud Messaging Service.
   "android": { # Android specific options for messages sent through [FCM connection server](https://goo.gl/4GLdUl). # Input only. Android specific options for messages sent through [FCM connection server](https://goo.gl/4GLdUl).
-    "bandwidthConstrainedOk": True or False, # Optional. If set to true, messages will be allowed to be delivered to the app while the device is in bandwidth constrained mode.
+    "bandwidthConstrainedOk": True or False, # Optional. If set to true, messages will be allowed to be delivered to the app while the device is in bandwidth constrained mode. This should only be enabled when the app has been tested to properly handle messages in bandwidth constrained mode.
     "collapseKey": "A String", # An identifier of a group of messages that can be collapsed, so that only the last message gets sent when delivery can be resumed. A maximum of 4 different collapse keys is allowed at any given time.
     "data": { # Arbitrary key/value payload. If present, it will override google.firebase.fcm.v1.Message.data.
       "a_key": "A String",
@@ -268,7 +268,7 @@ 
Method Details

     },
     "priority": "A String", # Message priority. Can take "normal" and "high" values. For more information, see [Setting the priority of a message](https://goo.gl/GjONJv).
     "restrictedPackageName": "A String", # Package name of the application where the registration token must match in order to receive the message.
-    "restrictedSatelliteOk": True or False, # Optional. If set to true, messages will be allowed to be delivered to the app while the device is connected over a restricted satellite network. This should only be enabled for messages that can be handled over a restricted satellite network and only for apps that are allowed to work over a restricted satellite network. Note that the ability of the app to connect to a restricted satellite network is dependent on the carrier's settings and the device model.
+    "restrictedSatelliteOk": True or False, # Optional. If set to true, messages will be allowed to be delivered to the app while the device is connected over a restricted satellite network. This should only be enabled for messages that can be handled over a restricted satellite network and only for apps that are enabled to work over a restricted satellite network. Note that the ability of the app to connect to a restricted satellite network is dependent on the carrier's settings and the device model.
     "ttl": "A String", # How long (in seconds) the message should be kept in FCM storage if the device is offline. The maximum time to live supported is 4 weeks, and the default value is 4 weeks if not set. Set it to 0 if want to send the message immediately. In JSON format, the Duration type is encoded as a string rather than an object, where the string ends in the suffix "s" (indicating seconds) and is preceded by the number of seconds, with nanoseconds expressed as fractional seconds. For example, 3 seconds with 0 nanoseconds should be encoded in JSON format as "3s", while 3 seconds and 1 nanosecond should be expressed in JSON format as "3.000000001s". The ttl will be rounded down to the nearest second.
   },
   "apns": { # [Apple Push Notification Service](https://goo.gl/MXRTPa) specific options. # Input only. [Apple Push Notification Service](https://goo.gl/MXRTPa) specific options.
diff --git a/docs/dyn/homegraph_v1.devices.html b/docs/dyn/homegraph_v1.devices.html
index 6512cedd1fb..68f16095e78 100644
--- a/docs/dyn/homegraph_v1.devices.html
+++ b/docs/dyn/homegraph_v1.devices.html
@@ -245,7 +245,7 @@ 
Method Details

           "defaultNames": [ # List of names provided by the manufacturer rather than the user, such as serial numbers, SKUs, etc.
             "A String",
           ],
-          "name": "A String", # Primary name of the device, generally provided by the user.
+          "name": "A String", # Primary name of the device, generally provided by the user. Names will be truncated if over the 60 Unicode code point (character) limit and no errors will be thrown. Developers are responsible for handling long names.
           "nicknames": [ # Additional names provided by the user for the device.
             "A String",
           ],
diff --git a/docs/dyn/run_v2.projects.locations.jobs.html b/docs/dyn/run_v2.projects.locations.jobs.html
index 4750f48114f..7eab555a709 100644
--- a/docs/dyn/run_v2.projects.locations.jobs.html
+++ b/docs/dyn/run_v2.projects.locations.jobs.html
@@ -153,7 +153,7 @@ 
Method Details

   "createTime": "A String", # Output only. The creation time.
   "creator": "A String", # Output only. Email address of the authenticated creator.
   "deleteTime": "A String", # Output only. The deletion time. It is only populated as a response to a Delete request.
-  "etag": "A String", # Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
+  "etag": "A String", # Optional. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
   "executionCount": 42, # Output only. Number of executions created for this job.
   "expireTime": "A String", # Output only. For a deleted resource, the time after which it will be permamently deleted.
   "generation": "A String", # Output only. A number that monotonically increases every time the user modifies the desired state.
@@ -466,7 +466,7 @@ 
Method Details

   "createTime": "A String", # Output only. The creation time.
   "creator": "A String", # Output only. Email address of the authenticated creator.
   "deleteTime": "A String", # Output only. The deletion time. It is only populated as a response to a Delete request.
-  "etag": "A String", # Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
+  "etag": "A String", # Optional. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
   "executionCount": 42, # Output only. Number of executions created for this job.
   "expireTime": "A String", # Output only. For a deleted resource, the time after which it will be permamently deleted.
   "generation": "A String", # Output only. A number that monotonically increases every time the user modifies the desired state.
@@ -765,7 +765,7 @@ 
Method Details

       "createTime": "A String", # Output only. The creation time.
       "creator": "A String", # Output only. Email address of the authenticated creator.
       "deleteTime": "A String", # Output only. The deletion time. It is only populated as a response to a Delete request.
-      "etag": "A String", # Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
+      "etag": "A String", # Optional. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
       "executionCount": 42, # Output only. Number of executions created for this job.
       "expireTime": "A String", # Output only. For a deleted resource, the time after which it will be permamently deleted.
       "generation": "A String", # Output only. A number that monotonically increases every time the user modifies the desired state.
@@ -1023,7 +1023,7 @@ 
Method Details

   "createTime": "A String", # Output only. The creation time.
   "creator": "A String", # Output only. Email address of the authenticated creator.
   "deleteTime": "A String", # Output only. The deletion time. It is only populated as a response to a Delete request.
-  "etag": "A String", # Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
+  "etag": "A String", # Optional. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
   "executionCount": 42, # Output only. Number of executions created for this job.
   "expireTime": "A String", # Output only. For a deleted resource, the time after which it will be permamently deleted.
   "generation": "A String", # Output only. A number that monotonically increases every time the user modifies the desired state.
diff --git a/docs/dyn/run_v2.projects.locations.services.html b/docs/dyn/run_v2.projects.locations.services.html
index 50c18027119..a8bc6c0eaf0 100644
--- a/docs/dyn/run_v2.projects.locations.services.html
+++ b/docs/dyn/run_v2.projects.locations.services.html
@@ -168,7 +168,7 @@ 
Method Details

   "defaultUriDisabled": True or False, # Optional. Disables public resolution of the default URI of this service.
   "deleteTime": "A String", # Output only. The deletion time. It is only populated as a response to a Delete request.
   "description": "A String", # User-provided description of the Service. This field currently has a 512-character limit.
-  "etag": "A String", # Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
+  "etag": "A String", # Optional. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
   "expireTime": "A String", # Output only. For a deleted resource, the time after which it will be permanently deleted.
   "generation": "A String", # Output only. A number that monotonically increases every time the user modifies the desired state. Please note that unlike v1, this is an int64 value. As with most Google APIs, its JSON representation will be a `string` instead of an `integer`.
   "iapEnabled": True or False, # Optional. IAP settings on the Service.
@@ -536,7 +536,7 @@ 
Method Details

   "defaultUriDisabled": True or False, # Optional. Disables public resolution of the default URI of this service.
   "deleteTime": "A String", # Output only. The deletion time. It is only populated as a response to a Delete request.
   "description": "A String", # User-provided description of the Service. This field currently has a 512-character limit.
-  "etag": "A String", # Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
+  "etag": "A String", # Optional. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
   "expireTime": "A String", # Output only. For a deleted resource, the time after which it will be permanently deleted.
   "generation": "A String", # Output only. A number that monotonically increases every time the user modifies the desired state. Please note that unlike v1, this is an int64 value. As with most Google APIs, its JSON representation will be a `string` instead of an `integer`.
   "iapEnabled": True or False, # Optional. IAP settings on the Service.
@@ -891,7 +891,7 @@ 
Method Details

       "defaultUriDisabled": True or False, # Optional. Disables public resolution of the default URI of this service.
       "deleteTime": "A String", # Output only. The deletion time. It is only populated as a response to a Delete request.
       "description": "A String", # User-provided description of the Service. This field currently has a 512-character limit.
-      "etag": "A String", # Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
+      "etag": "A String", # Optional. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
       "expireTime": "A String", # Output only. For a deleted resource, the time after which it will be permanently deleted.
       "generation": "A String", # Output only. A number that monotonically increases every time the user modifies the desired state. Please note that unlike v1, this is an int64 value. As with most Google APIs, its JSON representation will be a `string` instead of an `integer`.
       "iapEnabled": True or False, # Optional. IAP settings on the Service.
@@ -1203,7 +1203,7 @@ 
Method Details

   "defaultUriDisabled": True or False, # Optional. Disables public resolution of the default URI of this service.
   "deleteTime": "A String", # Output only. The deletion time. It is only populated as a response to a Delete request.
   "description": "A String", # User-provided description of the Service. This field currently has a 512-character limit.
-  "etag": "A String", # Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
+  "etag": "A String", # Optional. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
   "expireTime": "A String", # Output only. For a deleted resource, the time after which it will be permanently deleted.
   "generation": "A String", # Output only. A number that monotonically increases every time the user modifies the desired state. Please note that unlike v1, this is an int64 value. As with most Google APIs, its JSON representation will be a `string` instead of an `integer`.
   "iapEnabled": True or False, # Optional. IAP settings on the Service.
diff --git a/docs/dyn/run_v2.projects.locations.workerPools.html b/docs/dyn/run_v2.projects.locations.workerPools.html
index f6c38a59d19..fcece7bd414 100644
--- a/docs/dyn/run_v2.projects.locations.workerPools.html
+++ b/docs/dyn/run_v2.projects.locations.workerPools.html
@@ -154,7 +154,7 @@ 
Method Details

   ],
   "deleteTime": "A String", # Output only. The deletion time. It is only populated as a response to a Delete request.
   "description": "A String", # User-provided description of the WorkerPool. This field currently has a 512-character limit.
-  "etag": "A String", # Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
+  "etag": "A String", # Optional. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
   "expireTime": "A String", # Output only. For a deleted resource, the time after which it will be permamently deleted.
   "generation": "A String", # Output only. A number that monotonically increases every time the user modifies the desired state. Please note that unlike v1, this is an int64 value. As with most Google APIs, its JSON representation will be a `string` instead of an `integer`.
   "instanceSplitStatuses": [ # Output only. Detailed status information for corresponding instance splits. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.
@@ -479,7 +479,7 @@ 
Method Details

   ],
   "deleteTime": "A String", # Output only. The deletion time. It is only populated as a response to a Delete request.
   "description": "A String", # User-provided description of the WorkerPool. This field currently has a 512-character limit.
-  "etag": "A String", # Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
+  "etag": "A String", # Optional. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
   "expireTime": "A String", # Output only. For a deleted resource, the time after which it will be permamently deleted.
   "generation": "A String", # Output only. A number that monotonically increases every time the user modifies the desired state. Please note that unlike v1, this is an int64 value. As with most Google APIs, its JSON representation will be a `string` instead of an `integer`.
   "instanceSplitStatuses": [ # Output only. Detailed status information for corresponding instance splits. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.
@@ -791,7 +791,7 @@ 
Method Details

       ],
       "deleteTime": "A String", # Output only. The deletion time. It is only populated as a response to a Delete request.
       "description": "A String", # User-provided description of the WorkerPool. This field currently has a 512-character limit.
-      "etag": "A String", # Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
+      "etag": "A String", # Optional. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
       "expireTime": "A String", # Output only. For a deleted resource, the time after which it will be permamently deleted.
       "generation": "A String", # Output only. A number that monotonically increases every time the user modifies the desired state. Please note that unlike v1, this is an int64 value. As with most Google APIs, its JSON representation will be a `string` instead of an `integer`.
       "instanceSplitStatuses": [ # Output only. Detailed status information for corresponding instance splits. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.
@@ -1060,7 +1060,7 @@ 
Method Details

   ],
   "deleteTime": "A String", # Output only. The deletion time. It is only populated as a response to a Delete request.
   "description": "A String", # User-provided description of the WorkerPool. This field currently has a 512-character limit.
-  "etag": "A String", # Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
+  "etag": "A String", # Optional. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.
   "expireTime": "A String", # Output only. For a deleted resource, the time after which it will be permamently deleted.
   "generation": "A String", # Output only. A number that monotonically increases every time the user modifies the desired state. Please note that unlike v1, this is an int64 value. As with most Google APIs, its JSON representation will be a `string` instead of an `integer`.
   "instanceSplitStatuses": [ # Output only. Detailed status information for corresponding instance splits. See comments in `reconciling` for additional information on reconciliation process in Cloud Run.
diff --git a/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.html b/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.html
index 9ae6236c6d4..cf275ed0e0c 100644
--- a/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.html
+++ b/docs/dyn/vmmigration_v1.projects.locations.sources.migratingVms.html
@@ -314,7 +314,7 @@ 
Method Details

       "A String",
     ],
     "secureBoot": True or False, # Defines whether the instance has Secure Boot enabled. This can be set to true only if the VM boot option is EFI.
-    "serviceAccount": "A String", # The service account to associate the VM with.
+    "serviceAccount": "A String", # Optional. The service account to associate the VM with.
     "targetProject": "A String", # The full path of the resource of type TargetProject which represents the Compute Engine project in which to create this VM.
     "vmName": "A String", # The name of the VM to create.
     "zone": "A String", # The zone in which to create the VM.
@@ -1142,7 +1142,7 @@ 
Method Details

       "A String",
     ],
     "secureBoot": True or False, # Defines whether the instance has Secure Boot enabled. This can be set to true only if the VM boot option is EFI.
-    "serviceAccount": "A String", # The service account to associate the VM with.
+    "serviceAccount": "A String", # Optional. The service account to associate the VM with.
     "targetProject": "A String", # The full path of the resource of type TargetProject which represents the Compute Engine project in which to create this VM.
     "vmName": "A String", # The name of the VM to create.
     "zone": "A String", # The zone in which to create the VM.
@@ -1829,7 +1829,7 @@ 
Method Details

           "A String",
         ],
         "secureBoot": True or False, # Defines whether the instance has Secure Boot enabled. This can be set to true only if the VM boot option is EFI.
-        "serviceAccount": "A String", # The service account to associate the VM with.
+        "serviceAccount": "A String", # Optional. The service account to associate the VM with.
         "targetProject": "A String", # The full path of the resource of type TargetProject which represents the Compute Engine project in which to create this VM.
         "vmName": "A String", # The name of the VM to create.
         "zone": "A String", # The zone in which to create the VM.
@@ -2520,7 +2520,7 @@ 
Method Details

       "A String",
     ],
     "secureBoot": True or False, # Defines whether the instance has Secure Boot enabled. This can be set to true only if the VM boot option is EFI.
-    "serviceAccount": "A String", # The service account to associate the VM with.
+    "serviceAccount": "A String", # Optional. The service account to associate the VM with.
     "targetProject": "A String", # The full path of the resource of type TargetProject which represents the Compute Engine project in which to create this VM.
     "vmName": "A String", # The name of the VM to create.
     "zone": "A String", # The zone in which to create the VM.
diff --git a/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.html b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.html
index 8c45070fb77..c4da15e69bf 100644
--- a/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.html
+++ b/docs/dyn/vmmigration_v1alpha1.projects.locations.sources.migratingVms.html
@@ -316,7 +316,7 @@ 
Method Details

       "A String",
     ],
     "secureBoot": True or False, # Defines whether the instance has Secure Boot enabled. This can be set to true only if the VM boot option is EFI.
-    "serviceAccount": "A String", # The service account to associate the VM with.
+    "serviceAccount": "A String", # Optional. The service account to associate the VM with.
     "targetProject": "A String", # The full path of the resource of type TargetProject which represents the Compute Engine project in which to create this VM.
     "vmName": "A String", # The name of the VM to create.
     "zone": "A String", # The zone in which to create the VM.
@@ -1477,7 +1477,7 @@ 
Method Details

       "A String",
     ],
     "secureBoot": True or False, # Defines whether the instance has Secure Boot enabled. This can be set to true only if the VM boot option is EFI.
-    "serviceAccount": "A String", # The service account to associate the VM with.
+    "serviceAccount": "A String", # Optional. The service account to associate the VM with.
     "targetProject": "A String", # The full path of the resource of type TargetProject which represents the Compute Engine project in which to create this VM.
     "vmName": "A String", # The name of the VM to create.
     "zone": "A String", # The zone in which to create the VM.
@@ -2497,7 +2497,7 @@ 
Method Details

           "A String",
         ],
         "secureBoot": True or False, # Defines whether the instance has Secure Boot enabled. This can be set to true only if the VM boot option is EFI.
-        "serviceAccount": "A String", # The service account to associate the VM with.
+        "serviceAccount": "A String", # Optional. The service account to associate the VM with.
         "targetProject": "A String", # The full path of the resource of type TargetProject which represents the Compute Engine project in which to create this VM.
         "vmName": "A String", # The name of the VM to create.
         "zone": "A String", # The zone in which to create the VM.
@@ -3521,7 +3521,7 @@ 
Method Details

       "A String",
     ],
     "secureBoot": True or False, # Defines whether the instance has Secure Boot enabled. This can be set to true only if the VM boot option is EFI.
-    "serviceAccount": "A String", # The service account to associate the VM with.
+    "serviceAccount": "A String", # Optional. The service account to associate the VM with.
     "targetProject": "A String", # The full path of the resource of type TargetProject which represents the Compute Engine project in which to create this VM.
     "vmName": "A String", # The name of the VM to create.
     "zone": "A String", # The zone in which to create the VM.
diff --git a/googleapiclient/discovery_cache/documents/accesscontextmanager.v1.json b/googleapiclient/discovery_cache/documents/accesscontextmanager.v1.json
index 2f1a4a0ce86..69511401f57 100644
--- a/googleapiclient/discovery_cache/documents/accesscontextmanager.v1.json
+++ b/googleapiclient/discovery_cache/documents/accesscontextmanager.v1.json
@@ -1295,7 +1295,7 @@
 }
 }
 },
-"revision": "20250412",
+"revision": "20250723",
 "rootUrl": "https://accesscontextmanager.googleapis.com/",
 "schemas": {
 "AccessContextManagerOperationMetadata": {
@@ -1913,7 +1913,7 @@
 "type": "array"
 },
 "groupKey": {
-"description": "Required. Immutable. Google Group id whose members are subject to this binding's restrictions. See \"id\" in the [G Suite Directory API's Groups resource] (https://developers.google.com/admin-sdk/directory/v1/reference/groups#resource). If a group's email address/alias is changed, this resource will continue to point at the changed group. This field does not accept group email addresses or aliases. Example: \"01d520gv4vjcrht\"",
+"description": "Optional. Immutable. Google Group id whose users are subject to this binding's restrictions. See \"id\" in the [Google Workspace Directory API's Group Resource] (https://developers.google.com/admin-sdk/directory/v1/reference/groups#resource). If a group's email address/alias is changed, this resource will continue to point at the changed group. This field does not accept group email addresses or aliases. Example: \"01d520gv4vjcrht\"",
 "type": "string"
 },
 "name": {
diff --git a/googleapiclient/discovery_cache/documents/apigee.v1.json b/googleapiclient/discovery_cache/documents/apigee.v1.json
index 95b193b914a..be9e83212c1 100644
--- a/googleapiclient/discovery_cache/documents/apigee.v1.json
+++ b/googleapiclient/discovery_cache/documents/apigee.v1.json
@@ -5321,7 +5321,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The name of the debug session to retrieve. Must be of the form: `organizations/{organization}/environments/{environment}/apis/{api}/revisions/{revision}/debugsessions/{session}`. If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).",
+"description": "Required. The name of the debug session to retrieve. Must be of the form: `organizations/{organization}/environments/{environment}/apis/{api}/revisions/{revision}/debugsessions/{debug_session}`. If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).",
 "location": "path",
 "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+/debugsessions/[^/]+$",
 "required": true,
@@ -5346,13 +5346,13 @@
 ],
 "parameters": {
 "pageSize": {
-"description": "Maximum number of debug sessions to return. The page size defaults to 25.",
+"description": "Optional. Maximum number of debug sessions to return. The page size defaults to 25.",
 "format": "int32",
 "location": "query",
 "type": "integer"
 },
 "pageToken": {
-"description": "Page token, returned from a previous ListDebugSessions call, that you can use to retrieve the next page.",
+"description": "Optional. Page token, returned from a previous ListDebugSessions call, that you can use to retrieve the next page.",
 "location": "query",
 "type": "string"
 },
@@ -5386,7 +5386,7 @@
 ],
 "parameters": {
 "name": {
-"description": "Required. The name of the debug session transaction. Must be of the form: `organizations/{organization}/environments/{environment}/apis/{api}/revisions/{revision}/debugsessions/{session}/data/{transaction}`. If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).",
+"description": "Required. The name of the debug session transaction. Must be of the form: `organizations/{organization}/environments/{environment}/apis/{api}/revisions/{revision}/debugsessions/{debug_session}/data/{transaction}`. If the API proxy resource has the `space` attribute set, IAM permissions are checked differently . To learn more, read the [Apigee Spaces Overview](https://cloud.google.com/apigee/docs/api-platform/system-administration/spaces/apigee-spaces-overview).",
 "location": "path",
 "pattern": "^organizations/[^/]+/environments/[^/]+/apis/[^/]+/revisions/[^/]+/debugsessions/[^/]+/data/[^/]+$",
 "required": true,
@@ -9735,7 +9735,7 @@
 "type": "string"
 },
 "updateMask": {
-"description": "Optional. The list of fields to update. Valid fields to update are `profile`, `scope`, `include_all_resources`, `include`, and `exclude`.",
+"description": "Optional. The list of fields to update. Valid fields to update are `include_all_resources` and `include`.",
 "format": "google-fieldmask",
 "location": "query",
 "type": "string"
@@ -11127,7 +11127,7 @@
 }
 }
 },
-"revision": "20250701",
+"revision": "20250722",
 "rootUrl": "https://apigee.googleapis.com/",
 "schemas": {
 "EdgeConfigstoreBundleBadBundle": {
diff --git a/googleapiclient/discovery_cache/documents/batch.v1.json b/googleapiclient/discovery_cache/documents/batch.v1.json
index b11d2528ba5..78402cd0203 100644
--- a/googleapiclient/discovery_cache/documents/batch.v1.json
+++ b/googleapiclient/discovery_cache/documents/batch.v1.json
@@ -595,7 +595,7 @@
 }
 }
 },
-"revision": "20250519",
+"revision": "20250721",
 "rootUrl": "https://batch.googleapis.com/",
 "schemas": {
 "Accelerator": {
@@ -1298,19 +1298,22 @@
 "PROVISIONING_MODEL_UNSPECIFIED",
 "STANDARD",
 "SPOT",
-"PREEMPTIBLE"
+"PREEMPTIBLE",
+"RESERVATION_BOUND"
 ],
 "enumDeprecated": [
 false,
 false,
 false,
-true
+true,
+false
 ],
 "enumDescriptions": [
 "Unspecified.",
 "Standard VM.",
 "SPOT VM.",
-"Preemptible VM (PVM). Above SPOT VM is the preferable model for preemptible VM instances: the old preemptible VM model (indicated by this field) is the older model, and has been migrated to use the SPOT model as the underlying technology. This old model will still be supported."
+"Preemptible VM (PVM). Above SPOT VM is the preferable model for preemptible VM instances: the old preemptible VM model (indicated by this field) is the older model, and has been migrated to use the SPOT model as the underlying technology. This old model will still be supported.",
+"Bound to the lifecycle of the reservation in which it is provisioned."
 ],
 "type": "string"
 },
@@ -1366,19 +1369,22 @@ true
 "PROVISIONING_MODEL_UNSPECIFIED",
 "STANDARD",
 "SPOT",
-"PREEMPTIBLE"
+"PREEMPTIBLE",
+"RESERVATION_BOUND"
 ],
 "enumDeprecated": [
 false,
 false,
 false,
-true
+true,
+false
 ],
 "enumDescriptions": [
 "Unspecified.",
 "Standard VM.",
 "SPOT VM.",
-"Preemptible VM (PVM). Above SPOT VM is the preferable model for preemptible VM instances: the old preemptible VM model (indicated by this field) is the older model, and has been migrated to use the SPOT model as the underlying technology. This old model will still be supported."
+"Preemptible VM (PVM). Above SPOT VM is the preferable model for preemptible VM instances: the old preemptible VM model (indicated by this field) is the older model, and has been migrated to use the SPOT model as the underlying technology. This old model will still be supported.",
+"Bound to the lifecycle of the reservation in which it is provisioned."
 ],
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/chromemanagement.v1.json b/googleapiclient/discovery_cache/documents/chromemanagement.v1.json
index f46f2930125..ab6860e57d6 100644
--- a/googleapiclient/discovery_cache/documents/chromemanagement.v1.json
+++ b/googleapiclient/discovery_cache/documents/chromemanagement.v1.json
@@ -1181,7 +1181,7 @@
 "type": "string"
 },
 "readMask": {
-"description": "Required. Read mask to specify which fields to return. Although currently required, this field will become optional, while the filter parameter with an event type will be come required. Supported read_mask paths are: - device - user - audio_severe_underrun_event - usb_peripherals_event - https_latency_change_event - network_state_change_event - wifi_signal_strength_event - vpn_connection_state_change_event - app_install_event - app_uninstall_event - app_launch_event - os_crash_event ",
+"description": "Required. Read mask to specify which fields to return. Although currently required, this field will become optional, while the filter parameter with an event type will be come required. Supported read_mask paths are: - device - user - audio_severe_underrun_event - usb_peripherals_event - https_latency_change_event - network_state_change_event - wifi_signal_strength_event - vpn_connection_state_change_event - app_install_event - app_uninstall_event - app_launch_event - os_crash_event - external_displays_event ",
 "format": "google-fieldmask",
 "location": "query",
 "type": "string"
@@ -1377,7 +1377,7 @@
 }
 }
 },
-"revision": "20250710",
+"revision": "20250721",
 "rootUrl": "https://chromemanagement.googleapis.com/",
 "schemas": {
 "GoogleChromeManagementV1AndroidAppInfo": {
@@ -4521,7 +4521,9 @@ false
 "APP_INSTALLED",
 "APP_UNINSTALLED",
 "APP_LAUNCHED",
-"OS_CRASH"
+"OS_CRASH",
+"EXTERNAL_DISPLAY_CONNECTED",
+"EXTERNAL_DISPLAY_DISCONNECTED"
 ],
 "enumDescriptions": [
 "Event type unknown.",
@@ -4536,7 +4538,9 @@ false
 "Triggered when an app is installed.",
 "Triggered when an app is uninstalled.",
 "Triggered when an app is launched.",
-"Triggered when a crash occurs."
+"Triggered when a crash occurs.",
+"Triggered when an external display is connected.",
+"Triggered when an external display is disconnected."
 ],
 "type": "string"
 },
@@ -4608,7 +4612,9 @@ false
 "APP_INSTALLED",
 "APP_UNINSTALLED",
 "APP_LAUNCHED",
-"OS_CRASH"
+"OS_CRASH",
+"EXTERNAL_DISPLAY_CONNECTED",
+"EXTERNAL_DISPLAY_DISCONNECTED"
 ],
 "enumDescriptions": [
 "Event type unknown.",
@@ -4623,7 +4629,9 @@ false
 "Triggered when an app is installed.",
 "Triggered when an app is uninstalled.",
 "Triggered when an app is launched.",
-"Triggered when a crash occurs."
+"Triggered when a crash occurs.",
+"Triggered when an external display is connected.",
+"Triggered when an external display is disconnected."
 ],
 "type": "string"
 },
diff --git a/googleapiclient/discovery_cache/documents/content.v2.1.json b/googleapiclient/discovery_cache/documents/content.v2.1.json
index f2c2c0807e4..fc365da109c 100644
--- a/googleapiclient/discovery_cache/documents/content.v2.1.json
+++ b/googleapiclient/discovery_cache/documents/content.v2.1.json
@@ -1457,7 +1457,7 @@
 "type": "string"
 },
 "updateMask": {
-"description": "Optional. List of fields being updated.",
+"description": "Optional. List of fields being updated. The following fields can be updated: `attribution_settings`, `display_name`, `currency_code`.",
 "format": "google-fieldmask",
 "location": "query",
 "type": "string"
@@ -4570,7 +4570,7 @@
 }
 }
 },
-"revision": "20250621",
+"revision": "20250723",
 "rootUrl": "https://shoppingcontent.googleapis.com/",
 "schemas": {
 "Account": {
diff --git a/googleapiclient/discovery_cache/documents/datacatalog.v1.json b/googleapiclient/discovery_cache/documents/datacatalog.v1.json
index 54402c4bb05..1c2e81bf404 100644
--- a/googleapiclient/discovery_cache/documents/datacatalog.v1.json
+++ b/googleapiclient/discovery_cache/documents/datacatalog.v1.json
@@ -2339,7 +2339,7 @@
 }
 }
 },
-"revision": "20250609",
+"revision": "20250720",
 "rootUrl": "https://datacatalog.googleapis.com/",
 "schemas": {
 "Binding": {
@@ -3861,7 +3861,6 @@
 "id": "GoogleCloudDatacatalogV1ReconcileTagsRequest",
 "properties": {
 "forceDeleteMissing": {
-"description": "If set to `true`, deletes entry tags related to a tag template not listed in the tags source from an entry. If set to `false`, unlisted tags are retained.",
 "type": "boolean"
 },
 "tagTemplate": {
diff --git a/googleapiclient/discovery_cache/documents/dlp.v2.json b/googleapiclient/discovery_cache/documents/dlp.v2.json
index a00838e4e4d..167570aeddc 100644
--- a/googleapiclient/discovery_cache/documents/dlp.v2.json
+++ b/googleapiclient/discovery_cache/documents/dlp.v2.json
@@ -5118,7 +5118,7 @@
 }
 }
 },
-"revision": "20250713",
+"revision": "20250720",
 "rootUrl": "https://dlp.googleapis.com/",
 "schemas": {
 "GooglePrivacyDlpV2Action": {
@@ -8272,16 +8272,16 @@
 "type": "object"
 },
 "GooglePrivacyDlpV2DocumentFallbackLocation": {
-"description": "Configure document processing to fall back to the configured processing option below if document processing is unavailable in the original request location.",
+"description": "Configure document processing to fall back to any of the following processing options if document processing is unavailable in the original request location.",
 "id": "GooglePrivacyDlpV2DocumentFallbackLocation",
 "properties": {
 "globalProcessing": {
 "$ref": "GooglePrivacyDlpV2GlobalProcessing",
-"description": "Processing will happen in the global region."
+"description": "Processing occurs in the global region."
 },
 "multiRegionProcessing": {
 "$ref": "GooglePrivacyDlpV2MultiRegionProcessing",
-"description": "Processing will happen in a multi-region that contains the current region if available."
+"description": "Processing occurs in a multi-region that contains the current region if available."
 }
 },
 "type": "object"
@@ -8987,7 +8987,7 @@
 "type": "object"
 },
 "GooglePrivacyDlpV2GlobalProcessing": {
-"description": "Processing will happen in the global region.",
+"description": "Processing occurs in the global region.",
 "id": "GooglePrivacyDlpV2GlobalProcessing",
 "properties": {},
 "type": "object"
@@ -9138,16 +9138,16 @@
 "type": "object"
 },
 "GooglePrivacyDlpV2ImageFallbackLocation": {
-"description": "Configure image processing to fall back to the configured processing option below if unavailable in the request location.",
+"description": "Configure image processing to fall back to any of the following processing options if image processing is unavailable in the original request location.",
 "id": "GooglePrivacyDlpV2ImageFallbackLocation",
 "properties": {
 "globalProcessing": {
 "$ref": "GooglePrivacyDlpV2GlobalProcessing",
-"description": "Processing will happen in the global region."
+"description": "Processing occurs in the global region."
 },
 "multiRegionProcessing": {
 "$ref": "GooglePrivacyDlpV2MultiRegionProcessing",
-"description": "Processing will happen in a multi-region that contains the current region if available."
+"description": "Processing occurs in a multi-region that contains the current region if available."
 }
 },
 "type": "object"
@@ -9269,6 +9269,7 @@
 "ARGENTINA",
 "ARMENIA",
 "AUSTRALIA",
+"AUSTRIA",
 "AZERBAIJAN",
 "BELARUS",
 "BELGIUM",
@@ -9323,6 +9324,7 @@
 "The infoType is typically used in Argentina.",
 "The infoType is typically used in Armenia.",
 "The infoType is typically used in Australia.",
+"The infoType is typically used in Austria.",
 "The infoType is typically used in Azerbaijan.",
 "The infoType is typically used in Belarus.",
 "The infoType is typically used in Belgium.",
@@ -10562,7 +10564,7 @@
 "type": "object"
 },
 "GooglePrivacyDlpV2MultiRegionProcessing": {
-"description": "Processing will happen in a multi-region that contains the current region if available.",
+"description": "Processing occurs in a multi-region that contains the current region if available.",
 "id": "GooglePrivacyDlpV2MultiRegionProcessing",
 "properties": {},
 "type": "object"
@@ -10895,11 +10897,11 @@
 "properties": {
 "documentFallbackLocation": {
 "$ref": "GooglePrivacyDlpV2DocumentFallbackLocation",
-"description": "Document processing will fall back using this configuration."
+"description": "Document processing falls back using this configuration."
 },
 "imageFallbackLocation": {
 "$ref": "GooglePrivacyDlpV2ImageFallbackLocation",
-"description": "Image processing will fall back using this configuration."
+"description": "Image processing falls back using this configuration."
 }
 },
 "type": "object"
@@ -11148,7 +11150,7 @@
 "id": "GooglePrivacyDlpV2QuasiId",
 "properties": {
 "customTag": {
-"description": "A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).",
+"description": "A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.",
 "type": "string"
 },
 "field": {
@@ -11186,7 +11188,7 @@
 "id": "GooglePrivacyDlpV2QuasiIdentifierField",
 "properties": {
 "customTag": {
-"description": "A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).",
+"description": "A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.",
 "type": "string"
 },
 "field": {
@@ -11534,7 +11536,7 @@
 "type": "object"
 },
 "GooglePrivacyDlpV2Result": {
-"description": "All result fields mentioned below are updated while the job is processing.",
+"description": "All Result fields are updated while the job is processing.",
 "id": "GooglePrivacyDlpV2Result",
 "properties": {
 "hybridStats": {
@@ -12310,7 +12312,7 @@
 "id": "GooglePrivacyDlpV2TaggedField",
 "properties": {
 "customTag": {
-"description": "A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column (below).",
+"description": "A column can be tagged with a custom tag. In this case, the user must indicate an auxiliary table that contains statistical information on the possible values of this column.",
 "type": "string"
 },
 "field": {
diff --git a/googleapiclient/discovery_cache/documents/fcm.v1.json b/googleapiclient/discovery_cache/documents/fcm.v1.json
index a7f21499017..ce0145f698c 100644
--- a/googleapiclient/discovery_cache/documents/fcm.v1.json
+++ b/googleapiclient/discovery_cache/documents/fcm.v1.json
@@ -146,7 +146,7 @@
 }
 }
 },
-"revision": "20250610",
+"revision": "20250722",
 "rootUrl": "https://fcm.googleapis.com/",
 "schemas": {
 "AndroidConfig": {
@@ -154,7 +154,7 @@
 "id": "AndroidConfig",
 "properties": {
 "bandwidthConstrainedOk": {
-"description": "Optional. If set to true, messages will be allowed to be delivered to the app while the device is in bandwidth constrained mode.",
+"description": "Optional. If set to true, messages will be allowed to be delivered to the app while the device is in bandwidth constrained mode. This should only be enabled when the app has been tested to properly handle messages in bandwidth constrained mode.",
 "type": "boolean"
 },
 "collapseKey": {
@@ -197,7 +197,7 @@
 "type": "string"
 },
 "restrictedSatelliteOk": {
-"description": "Optional. If set to true, messages will be allowed to be delivered to the app while the device is connected over a restricted satellite network. This should only be enabled for messages that can be handled over a restricted satellite network and only for apps that are allowed to work over a restricted satellite network. Note that the ability of the app to connect to a restricted satellite network is dependent on the carrier's settings and the device model.",
+"description": "Optional. If set to true, messages will be allowed to be delivered to the app while the device is connected over a restricted satellite network. This should only be enabled for messages that can be handled over a restricted satellite network and only for apps that are enabled to work over a restricted satellite network. Note that the ability of the app to connect to a restricted satellite network is dependent on the carrier's settings and the device model.",
 "type": "boolean"
 },
 "ttl": {
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v1.json b/googleapiclient/discovery_cache/documents/gkehub.v1.json
index b68d9442256..7700dc64a8b 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v1.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v1.json
@@ -2117,7 +2117,7 @@
 }
 }
 },
-"revision": "20250715",
+"revision": "20250720",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceFeatureSpec": {
@@ -6420,7 +6420,8 @@
 "ACTIVE",
 "STALLED",
 "NEEDS_ATTENTION",
-"DEGRADED"
+"DEGRADED",
+"DEPROVISIONING"
 ],
 "enumDescriptions": [
 "Unspecified",
@@ -6430,7 +6431,8 @@
 "ACTIVE means that the component is ready for use.",
 "STALLED means that provisioning could not be done.",
 "NEEDS_ATTENTION means that the component is ready, but some user intervention is required. (For example that the user should migrate workloads to a new control plane revision.)",
-"DEGRADED means that the component is ready, but operating in a degraded state."
+"DEGRADED means that the component is ready, but operating in a degraded state.",
+"DEPROVISIONING means that deprovisioning is in progress."
 ],
 "type": "string"
 }
@@ -6458,7 +6460,8 @@
 "ACTIVE",
 "STALLED",
 "NEEDS_ATTENTION",
-"DEGRADED"
+"DEGRADED",
+"DEPROVISIONING"
 ],
 "enumDescriptions": [
 "Unspecified",
@@ -6468,7 +6471,8 @@
 "ACTIVE means that the component is ready for use.",
 "STALLED means that provisioning could not be done.",
 "NEEDS_ATTENTION means that the component is ready, but some user intervention is required. (For example that the user should migrate workloads to a new control plane revision.)",
-"DEGRADED means that the component is ready, but operating in a degraded state."
+"DEGRADED means that the component is ready, but operating in a degraded state.",
+"DEPROVISIONING means that deprovisioning is in progress."
 ],
 "type": "string"
 }
@@ -6513,12 +6517,14 @@
 "enum": [
 "MANAGEMENT_UNSPECIFIED",
 "MANAGEMENT_AUTOMATIC",
-"MANAGEMENT_MANUAL"
+"MANAGEMENT_MANUAL",
+"MANAGEMENT_NOT_INSTALLED"
 ],
 "enumDescriptions": [
 "Unspecified",
 "Google should manage my Service Mesh for the cluster.",
-"User will manually configure their service mesh components."
+"User will manually configure their service mesh components.",
+"Google should remove any managed Service Mesh components from this cluster and deprovision any resources."
 ],
 "type": "string"
 }
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json b/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json
index 3632373e937..23bf3e8e8db 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v1alpha.json
@@ -2261,7 +2261,7 @@
 }
 }
 },
-"revision": "20250715",
+"revision": "20250720",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceFeatureSpec": {
@@ -7004,7 +7004,8 @@
 "ACTIVE",
 "STALLED",
 "NEEDS_ATTENTION",
-"DEGRADED"
+"DEGRADED",
+"DEPROVISIONING"
 ],
 "enumDescriptions": [
 "Unspecified",
@@ -7014,7 +7015,8 @@
 "ACTIVE means that the component is ready for use.",
 "STALLED means that provisioning could not be done.",
 "NEEDS_ATTENTION means that the component is ready, but some user intervention is required. (For example that the user should migrate workloads to a new control plane revision.)",
-"DEGRADED means that the component is ready, but operating in a degraded state."
+"DEGRADED means that the component is ready, but operating in a degraded state.",
+"DEPROVISIONING means that deprovisioning is in progress."
 ],
 "type": "string"
 }
@@ -7042,7 +7044,8 @@
 "ACTIVE",
 "STALLED",
 "NEEDS_ATTENTION",
-"DEGRADED"
+"DEGRADED",
+"DEPROVISIONING"
 ],
 "enumDescriptions": [
 "Unspecified",
@@ -7052,7 +7055,8 @@
 "ACTIVE means that the component is ready for use.",
 "STALLED means that provisioning could not be done.",
 "NEEDS_ATTENTION means that the component is ready, but some user intervention is required. (For example that the user should migrate workloads to a new control plane revision.)",
-"DEGRADED means that the component is ready, but operating in a degraded state."
+"DEGRADED means that the component is ready, but operating in a degraded state.",
+"DEPROVISIONING means that deprovisioning is in progress."
 ],
 "type": "string"
 }
@@ -7260,12 +7264,14 @@
 "enum": [
 "MANAGEMENT_UNSPECIFIED",
 "MANAGEMENT_AUTOMATIC",
-"MANAGEMENT_MANUAL"
+"MANAGEMENT_MANUAL",
+"MANAGEMENT_NOT_INSTALLED"
 ],
 "enumDescriptions": [
 "Unspecified",
 "Google should manage my Service Mesh for the cluster.",
-"User will manually configure their service mesh components."
+"User will manually configure their service mesh components.",
+"Google should remove any managed Service Mesh components from this cluster and deprovision any resources."
 ],
 "type": "string"
 }
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v1beta.json b/googleapiclient/discovery_cache/documents/gkehub.v1beta.json
index db921ec79a3..091731a7fb4 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v1beta.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v1beta.json
@@ -2117,7 +2117,7 @@
 }
 }
 },
-"revision": "20250715",
+"revision": "20250720",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceFeatureSpec": {
@@ -6546,7 +6546,8 @@
 "ACTIVE",
 "STALLED",
 "NEEDS_ATTENTION",
-"DEGRADED"
+"DEGRADED",
+"DEPROVISIONING"
 ],
 "enumDescriptions": [
 "Unspecified",
@@ -6556,7 +6557,8 @@
 "ACTIVE means that the component is ready for use.",
 "STALLED means that provisioning could not be done.",
 "NEEDS_ATTENTION means that the component is ready, but some user intervention is required. (For example that the user should migrate workloads to a new control plane revision.)",
-"DEGRADED means that the component is ready, but operating in a degraded state."
+"DEGRADED means that the component is ready, but operating in a degraded state.",
+"DEPROVISIONING means that deprovisioning is in progress."
 ],
 "type": "string"
 }
@@ -6584,7 +6586,8 @@
 "ACTIVE",
 "STALLED",
 "NEEDS_ATTENTION",
-"DEGRADED"
+"DEGRADED",
+"DEPROVISIONING"
 ],
 "enumDescriptions": [
 "Unspecified",
@@ -6594,7 +6597,8 @@
 "ACTIVE means that the component is ready for use.",
 "STALLED means that provisioning could not be done.",
 "NEEDS_ATTENTION means that the component is ready, but some user intervention is required. (For example that the user should migrate workloads to a new control plane revision.)",
-"DEGRADED means that the component is ready, but operating in a degraded state."
+"DEGRADED means that the component is ready, but operating in a degraded state.",
+"DEPROVISIONING means that deprovisioning is in progress."
 ],
 "type": "string"
 }
@@ -6639,12 +6643,14 @@
 "enum": [
 "MANAGEMENT_UNSPECIFIED",
 "MANAGEMENT_AUTOMATIC",
-"MANAGEMENT_MANUAL"
+"MANAGEMENT_MANUAL",
+"MANAGEMENT_NOT_INSTALLED"
 ],
 "enumDescriptions": [
 "Unspecified",
 "Google should manage my Service Mesh for the cluster.",
-"User will manually configure their service mesh components."
+"User will manually configure their service mesh components.",
+"Google should remove any managed Service Mesh components from this cluster and deprovision any resources."
 ],
 "type": "string"
 }
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v2.json b/googleapiclient/discovery_cache/documents/gkehub.v2.json
index 58103f20d39..4300d9996f9 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v2.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v2.json
@@ -477,7 +477,7 @@
 }
 }
 },
-"revision": "20250715",
+"revision": "20250720",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceState": {
@@ -3178,7 +3178,8 @@
 "ACTIVE",
 "STALLED",
 "NEEDS_ATTENTION",
-"DEGRADED"
+"DEGRADED",
+"DEPROVISIONING"
 ],
 "enumDescriptions": [
 "Unspecified",
@@ -3188,7 +3189,8 @@
 "ACTIVE means that the component is ready for use.",
 "STALLED means that provisioning could not be done.",
 "NEEDS_ATTENTION means that the component is ready, but some user intervention is required. (For example that the user should migrate workloads to a new control plane revision.)",
-"DEGRADED means that the component is ready, but operating in a degraded state."
+"DEGRADED means that the component is ready, but operating in a degraded state.",
+"DEPROVISIONING means that deprovisioning is in progress."
 ],
 "type": "string"
 }
@@ -3216,7 +3218,8 @@
 "ACTIVE",
 "STALLED",
 "NEEDS_ATTENTION",
-"DEGRADED"
+"DEGRADED",
+"DEPROVISIONING"
 ],
 "enumDescriptions": [
 "Unspecified",
@@ -3226,7 +3229,8 @@
 "ACTIVE means that the component is ready for use.",
 "STALLED means that provisioning could not be done.",
 "NEEDS_ATTENTION means that the component is ready, but some user intervention is required. (For example that the user should migrate workloads to a new control plane revision.)",
-"DEGRADED means that the component is ready, but operating in a degraded state."
+"DEGRADED means that the component is ready, but operating in a degraded state.",
+"DEPROVISIONING means that deprovisioning is in progress."
 ],
 "type": "string"
 }
@@ -3288,12 +3292,14 @@
 "enum": [
 "MANAGEMENT_UNSPECIFIED",
 "MANAGEMENT_AUTOMATIC",
-"MANAGEMENT_MANUAL"
+"MANAGEMENT_MANUAL",
+"MANAGEMENT_NOT_INSTALLED"
 ],
 "enumDescriptions": [
 "Unspecified",
 "Google should manage my Service Mesh for the cluster.",
-"User will manually configure their service mesh components."
+"User will manually configure their service mesh components.",
+"Google should remove any managed Service Mesh components from this cluster and deprovision any resources."
 ],
 "type": "string"
 }
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v2alpha.json b/googleapiclient/discovery_cache/documents/gkehub.v2alpha.json
index be0567b52e4..9b525e6213e 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v2alpha.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v2alpha.json
@@ -477,7 +477,7 @@
 }
 }
 },
-"revision": "20250715",
+"revision": "20250720",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceState": {
@@ -3178,7 +3178,8 @@
 "ACTIVE",
 "STALLED",
 "NEEDS_ATTENTION",
-"DEGRADED"
+"DEGRADED",
+"DEPROVISIONING"
 ],
 "enumDescriptions": [
 "Unspecified",
@@ -3188,7 +3189,8 @@
 "ACTIVE means that the component is ready for use.",
 "STALLED means that provisioning could not be done.",
 "NEEDS_ATTENTION means that the component is ready, but some user intervention is required. (For example that the user should migrate workloads to a new control plane revision.)",
-"DEGRADED means that the component is ready, but operating in a degraded state."
+"DEGRADED means that the component is ready, but operating in a degraded state.",
+"DEPROVISIONING means that deprovisioning is in progress."
 ],
 "type": "string"
 }
@@ -3216,7 +3218,8 @@
 "ACTIVE",
 "STALLED",
 "NEEDS_ATTENTION",
-"DEGRADED"
+"DEGRADED",
+"DEPROVISIONING"
 ],
 "enumDescriptions": [
 "Unspecified",
@@ -3226,7 +3229,8 @@
 "ACTIVE means that the component is ready for use.",
 "STALLED means that provisioning could not be done.",
 "NEEDS_ATTENTION means that the component is ready, but some user intervention is required. (For example that the user should migrate workloads to a new control plane revision.)",
-"DEGRADED means that the component is ready, but operating in a degraded state."
+"DEGRADED means that the component is ready, but operating in a degraded state.",
+"DEPROVISIONING means that deprovisioning is in progress."
 ],
 "type": "string"
 }
@@ -3288,12 +3292,14 @@
 "enum": [
 "MANAGEMENT_UNSPECIFIED",
 "MANAGEMENT_AUTOMATIC",
-"MANAGEMENT_MANUAL"
+"MANAGEMENT_MANUAL",
+"MANAGEMENT_NOT_INSTALLED"
 ],
 "enumDescriptions": [
 "Unspecified",
 "Google should manage my Service Mesh for the cluster.",
-"User will manually configure their service mesh components."
+"User will manually configure their service mesh components.",
+"Google should remove any managed Service Mesh components from this cluster and deprovision any resources."
 ],
 "type": "string"
 }
diff --git a/googleapiclient/discovery_cache/documents/gkehub.v2beta.json b/googleapiclient/discovery_cache/documents/gkehub.v2beta.json
index 2331ca09677..c872d178183 100644
--- a/googleapiclient/discovery_cache/documents/gkehub.v2beta.json
+++ b/googleapiclient/discovery_cache/documents/gkehub.v2beta.json
@@ -477,7 +477,7 @@
 }
 }
 },
-"revision": "20250715",
+"revision": "20250720",
 "rootUrl": "https://gkehub.googleapis.com/",
 "schemas": {
 "AppDevExperienceState": {
@@ -3178,7 +3178,8 @@
 "ACTIVE",
 "STALLED",
 "NEEDS_ATTENTION",
-"DEGRADED"
+"DEGRADED",
+"DEPROVISIONING"
 ],
 "enumDescriptions": [
 "Unspecified",
@@ -3188,7 +3189,8 @@
 "ACTIVE means that the component is ready for use.",
 "STALLED means that provisioning could not be done.",
 "NEEDS_ATTENTION means that the component is ready, but some user intervention is required. (For example that the user should migrate workloads to a new control plane revision.)",
-"DEGRADED means that the component is ready, but operating in a degraded state."
+"DEGRADED means that the component is ready, but operating in a degraded state.",
+"DEPROVISIONING means that deprovisioning is in progress."
 ],
 "type": "string"
 }
@@ -3216,7 +3218,8 @@
 "ACTIVE",
 "STALLED",
 "NEEDS_ATTENTION",
-"DEGRADED"
+"DEGRADED",
+"DEPROVISIONING"
 ],
 "enumDescriptions": [
 "Unspecified",
@@ -3226,7 +3229,8 @@
 "ACTIVE means that the component is ready for use.",
 "STALLED means that provisioning could not be done.",
 "NEEDS_ATTENTION means that the component is ready, but some user intervention is required. (For example that the user should migrate workloads to a new control plane revision.)",
-"DEGRADED means that the component is ready, but operating in a degraded state."
+"DEGRADED means that the component is ready, but operating in a degraded state.",
+"DEPROVISIONING means that deprovisioning is in progress."
 ],
 "type": "string"
 }
@@ -3288,12 +3292,14 @@
 "enum": [
 "MANAGEMENT_UNSPECIFIED",
 "MANAGEMENT_AUTOMATIC",
-"MANAGEMENT_MANUAL"
+"MANAGEMENT_MANUAL",
+"MANAGEMENT_NOT_INSTALLED"
 ],
 "enumDescriptions": [
 "Unspecified",
 "Google should manage my Service Mesh for the cluster.",
-"User will manually configure their service mesh components."
+"User will manually configure their service mesh components.",
+"Google should remove any managed Service Mesh components from this cluster and deprovision any resources."
 ],
 "type": "string"
 }
diff --git a/googleapiclient/discovery_cache/documents/homegraph.v1.json b/googleapiclient/discovery_cache/documents/homegraph.v1.json
index db63388d244..cb9cc213bb6 100644
--- a/googleapiclient/discovery_cache/documents/homegraph.v1.json
+++ b/googleapiclient/discovery_cache/documents/homegraph.v1.json
@@ -216,7 +216,7 @@
 }
 }
 },
-"revision": "20250410",
+"revision": "20250716",
 "rootUrl": "https://homegraph.googleapis.com/",
 "schemas": {
 "AgentDeviceId": {
@@ -349,7 +349,7 @@
 "type": "array"
 },
 "name": {
-"description": "Primary name of the device, generally provided by the user.",
+"description": "Primary name of the device, generally provided by the user. Names will be truncated if over the 60 Unicode code point (character) limit and no errors will be thrown. Developers are responsible for handling long names.",
 "type": "string"
 },
 "nicknames": {
diff --git a/googleapiclient/discovery_cache/documents/run.v2.json b/googleapiclient/discovery_cache/documents/run.v2.json
index 54a334488d6..fec383d6097 100644
--- a/googleapiclient/discovery_cache/documents/run.v2.json
+++ b/googleapiclient/discovery_cache/documents/run.v2.json
@@ -1922,7 +1922,7 @@
 }
 }
 },
-"revision": "20250712",
+"revision": "20250718",
 "rootUrl": "https://run.googleapis.com/",
 "schemas": {
 "GoogleCloudRunV2BinaryAuthorization": {
@@ -2958,8 +2958,7 @@
 "type": "string"
 },
 "etag": {
-"description": "Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.",
-"readOnly": true,
+"description": "Optional. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.",
 "type": "string"
 },
 "executionCount": {
@@ -3844,8 +3843,7 @@
 "type": "string"
 },
 "etag": {
-"description": "Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.",
-"readOnly": true,
+"description": "Optional. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.",
 "type": "string"
 },
 "expireTime": {
@@ -4675,8 +4673,7 @@
 "type": "string"
 },
 "etag": {
-"description": "Output only. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.",
-"readOnly": true,
+"description": "Optional. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.",
 "type": "string"
 },
 "expireTime": {
diff --git a/googleapiclient/discovery_cache/documents/texttospeech.v1.json b/googleapiclient/discovery_cache/documents/texttospeech.v1.json
index 7be8d094f2e..64283fa1556 100644
--- a/googleapiclient/discovery_cache/documents/texttospeech.v1.json
+++ b/googleapiclient/discovery_cache/documents/texttospeech.v1.json
@@ -318,7 +318,7 @@
 }
 }
 },
-"revision": "20250612",
+"revision": "20250716",
 "rootUrl": "https://texttospeech.googleapis.com/",
 "schemas": {
 "AdvancedVoiceOptions": {
@@ -349,7 +349,7 @@
 "M4A"
 ],
 "enumDescriptions": [
-"Not specified. Will return result google.rpc.Code.INVALID_ARGUMENT.",
+"Not specified. Only used by GenerateVoiceCloningKey. Otherwise, will return result google.rpc.Code.INVALID_ARGUMENT.",
 "Uncompressed 16-bit signed little-endian samples (Linear PCM). Audio content returned as LINEAR16 also contains a WAV header.",
 "MP3 audio at 32kbps.",
 "Opus encoded audio wrapped in an ogg container. The result is a file which can be played natively on Android, and in browsers (at least Chrome and Firefox). The quality of the encoding is considerably higher than MP3 while using approximately the same bitrate.",
diff --git a/googleapiclient/discovery_cache/documents/texttospeech.v1beta1.json b/googleapiclient/discovery_cache/documents/texttospeech.v1beta1.json
index 85f55df600e..1b2d35ca102 100644
--- a/googleapiclient/discovery_cache/documents/texttospeech.v1beta1.json
+++ b/googleapiclient/discovery_cache/documents/texttospeech.v1beta1.json
@@ -261,7 +261,7 @@
 }
 }
 },
-"revision": "20250612",
+"revision": "20250716",
 "rootUrl": "https://texttospeech.googleapis.com/",
 "schemas": {
 "AdvancedVoiceOptions": {
@@ -293,7 +293,7 @@
 "M4A"
 ],
 "enumDescriptions": [
-"Not specified. Will return result google.rpc.Code.INVALID_ARGUMENT.",
+"Not specified. Only used by GenerateVoiceCloningKey. Otherwise, will return result google.rpc.Code.INVALID_ARGUMENT.",
 "Uncompressed 16-bit signed little-endian samples (Linear PCM). Audio content returned as LINEAR16 also contains a WAV header.",
 "MP3 audio at 32kbps.",
 "MP3 at 64kbps.",
diff --git a/googleapiclient/discovery_cache/documents/vmmigration.v1.json b/googleapiclient/discovery_cache/documents/vmmigration.v1.json
index ec39756a820..16a7f5aa8b8 100644
--- a/googleapiclient/discovery_cache/documents/vmmigration.v1.json
+++ b/googleapiclient/discovery_cache/documents/vmmigration.v1.json
@@ -2254,7 +2254,7 @@
 }
 }
 },
-"revision": "20250701",
+"revision": "20250717",
 "rootUrl": "https://vmmigration.googleapis.com/",
 "schemas": {
 "AccessKeyCredentials": {
@@ -3321,7 +3321,7 @@
 "type": "boolean"
 },
 "serviceAccount": {
-"description": "The service account to associate the VM with.",
+"description": "Optional. The service account to associate the VM with.",
 "type": "string"
 },
 "targetProject": {
diff --git a/googleapiclient/discovery_cache/documents/vmmigration.v1alpha1.json b/googleapiclient/discovery_cache/documents/vmmigration.v1alpha1.json
index 69a9da9acd9..42850fed03f 100644
--- a/googleapiclient/discovery_cache/documents/vmmigration.v1alpha1.json
+++ b/googleapiclient/discovery_cache/documents/vmmigration.v1alpha1.json
@@ -2254,7 +2254,7 @@
 }
 }
 },
-"revision": "20250701",
+"revision": "20250717",
 "rootUrl": "https://vmmigration.googleapis.com/",
 "schemas": {
 "AccessKeyCredentials": {
@@ -3333,7 +3333,7 @@
 "type": "boolean"
 },
 "serviceAccount": {
-"description": "The service account to associate the VM with.",
+"description": "Optional. The service account to associate the VM with.",
 "type": "string"
 },
 "targetProject": {